Home | Sitemap | Last changes RSS Feed | Wiki help | Wiki tools | SandBox
Preferences | Edit this page | View source | Page history | Referrers
Document last modified: Tue, 12 Apr 2005, 07:14 UTC
Parents: BlackboxDocumentation/ BlackboxMenus/

Blackbox Documentation/Blackbox Menus/Main Menu Example

This is the default main menu definition shipped with Blackbox. It is rather skimpy, but it does include an introduction to the syntax. It is provided mainly as reference. See BlackboxMenus for more detailed help.

# This is the default menu file for Blackbox 0.33.0 and up
# 
# Lines beginning with the '#' character are ignored.
#
# The new syntax is simpler than the old X resource format...
# Each menu item consists of 2 or 3 fields:
#
#	[command]  (label)  {data}
#
# where [command] is one of:
#
#   [begin] [end] [exec] [exit] [reconfig] [restart]
#   [submenu] [style] [include] [workspaces] [config]
#
# [begin] is used for the top level menu
# [submenu] is used for submenus
# [end] must be used with BOTH [begin] and [submenu] to tell the parser to stop
#   reading from the file.
#
# [exec] (label) {string}
# This will insert an item that runs a program.
#
# [exit] (label)
# This will insert an item that exits the window manager.
#
# [reconfig] (label) {string}
# This will insert an item that tells blackbox to re-read it's configuration
#  files.  {string} is optional, and if supplied, will execute the string with
#  /bin/sh -c before the reconfiguration is performed.  (this is helpful for
#  writing multiple config files and switching between them)
#
# [restart] (label) {string}
# This will insert an item to restart the window manager.  {string} is
# optional, and if omitted, blackbox will restart itself.  If {string} is
# specified, then a different window manager will be started.
#
# [style] (filename)
# This will insert an item to reconfigure blackbox with the new style. This
# change is saved when blackbox exits or restarts.
#
# [include] (filename)
# This will read more menu items from the file "filename".  The file cannot
# contain a [begin] or [end], except for the [end] needed for submenus.
#
# [workspaces] (label)
# This tells Blackbox to insert a "link" to the workspaces menu directly
# into your menu.
#
# [config] (label)
# This tells Blackbox to insert the ConfigMenu into your menu.  The ConfigMenu
# allows you to change several options found in your ~/.blackboxrc file on the
# fly.
#
# example:

[begin] (Blackbox)
  [exec] (xterm)    {xterm -ls}
  [exec] (rxvt)     {rxvt}

  [exec] (StarOffice) {soffice}
  [exec] (XEmacs)     {xemacs}
  [exec] (Acroread)   {acroread}

  [submenu] (Graphics)
    [exec] (The GIMP)     {gimp}
    [exec] (Image Magick) {display}
  [end]

  [submenu] (Mozilla)
    [exec] (Mozilla Navigator)  {mozilla}
    [submenu] (More...)
      [exec] (Mozilla Mail)     {mozilla -mail}
      [exec] (Mozilla News)     {mozilla -news}
      [exec] (Mozilla Composer) {mozilla -edit}
    [end]
  [end]

  [submenu] (X Utilities)
    [exec] (Xfontsel) {xfontsel}
    [exec] (Xman)     {xman}
    [exec] (Xcalc)    {xcalc}
    [exec] (Xload)    {xload}
  [end]
 
  [submenu] (Styles) {Choose a style...}
    [stylesdir] (@pkgdatadir@/styles)
  [end]

  [workspaces] (Workspace List)
  [config] (Configuration)

  [reconfig] (Reconfigure)
  [restart] (Restart)
  [submenu] (Others)              {Other Window Managers}
    [restart] (Start FVWM)        {fvwm}
    [restart] (Start WindowMaker) {wmaker}
    [restart] (Start Afterstep)   {afterstep}
    [restart] (Start Enlightenment) {enlightenment}
    [restart] (Start TWM)         {twm}
    [restart] (Start KWM)         {kwm}
  [end]

  [exit] (Exit)
[end]

# End of example menu.

eXTReMe Tracker Hosted by SourceForge.net
Document last modified: Tue, 12 Apr 2005, 07:14 UTC
Home | Sitemap | Last changes RSS Feed | Wiki help | Wiki tools | SandBox
Preferences | Edit this page | View source | Page history | Referrers
Hosted by SourceForge. Powered by Wikki Tikki Tavi. About the website. Terms of use.