guidedtour/menu.html

   1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
   2 <html><head>
   3
   4   <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
   5
   6
   7   <meta name="keywords" content="WindowMaker,windowmaker,window manager,Window Maker">
   8   <title>WindowMaker Guided tour - Index</title>
   9
  10
  11
  12   <link href="title.css" rel="stylesheet" type="text/css">
  13
  14 </head>
  15 <h1>
  16 <center>Menus</center>
  17 </h1>
  18
  19 <center><a href="index.html">Back
  20 to Index</a></center>
  21
  22 <ul>
  23
  24   <li><a href="#menu">Menu list</a></li>
  25   <li><a href="#root">Root window menu</a></li>
  26   <li><a href="#list">Window list menu</a></li>
  27   <li><a href="#wspace">Workspaces menu</a></li>
  28   <li><a href="#apps">Application icon menu</a></li>
  29 </ul>
  30
  31 <h2><a id="menu">Menu list</a></h2>
  32
  33 <p>Different menus are available within Window Maker:</p>
  34
  35 <ul>
  36
  37   <li>The root window menu or applications menu</li>
  38   <li>The window list menu</li>
  39   <li>The workspace menu</li>
  40   <li>The application icon menu<br>
  41   </li>
  42 </ul>
  43
  44 <p>Menus provide a list of applications or commands for execution. They
  45 can be used to launch applications, to get information, to configure
  46 the workspace...<br>
  47 </p>
  48
  49 <p>Menus are opened by right-clicking either in the "blank" area of the
  50 workspace or in a window's titlebar or in docked icons. The <em>window
  51 list menu</em> is the only one opened with the middle mouse button.
  52 With a two-button mouse, pressing both buttons at once usually does the
  53 trick. A number of keyboard shortcuts are provided. These shortcuts are
  54 indicated by the modifier key + letter shown to the right of a menu
  55 item.</p>
  56
  57 <p>The keyboard can be used to open and move through some of the menus.
  58 For instance, the root menu can be opened using F12 (default setting).
  59 The Up and Down arrow keys can then be used to navigate through the
  60 menu or the Left and Right arrow keys to jump between parent menus and
  61 submenus. Hitting the <em>Enter</em> key executes the selected item.
  62 the <em>Escape</em> key closes the menu or stops menu traversal.</p>
  63
  64 <p>Menus can be forced to remain open on the workspace by left-clicking
  65 the titlebar. This creates a <em>close</em> button on the titlebar.</p>
  66
  67 <h2><a id="root">Root window menu</a></h2>
  68
  69 <center><img style="width: 107px; height: 261px;" alt="Root window menu (applications menu)" src="images/apm.png"></center>
  70
  71 <br>
  72
  73 The root window menu or applications menu is opened by right-clicking
  74 on an empty area of the workspace or by hitting the pre-defined
  75 keyboard shortcut (default is F12). This menu launches applications,
  76 allows for the customization of the workspace (backgrounds, themes...),
  77 and the management of other workspace characteristics using standard X
  78 utilities (xprop, xfontsel, xcmap...).
  79 <p>The menu content is totally configurable, either using WPrefs.app or
  80 by editing the plain text menu file. Instructions on how to configure
  81 one or the other can be found in the WindowMaker directory of the
  82 distribution. To use WPrefs.app, menus must be in property list format
  83 (plmenu). A script is available to convert plain text menus to property
  84 list menus and it's called wm-oldmenu2new. </p>
  85
  86 <h2><a id="list">Window list menu</a></h2>
  87
  88 <center><img style="width: 265px; height: 141px;" alt="Window list menu" src="images/wlm.png"></center>
  89
  90 <br>
  91
  92 Middle-clicking an empty area of the workspace opens the window list
  93 menu. With a two-button mouse, clicking both buttons at once usually
  94 gives the same result. F11 is the default keyboard shorcut to open the
  95 window list menu.
  96 <p>This menu lists all windows - whether active or inactive - in every
  97 workspace. The workspace containing each window is indicated at the
  98 right of the window name. The current focused window is marked by a
  99 diamond sign to the left of the window's name. Clicking any window in
 100 the list focuses and raises the corresponding window and moves you to
 101 the workspace where it's located.</p>
 102
 103 <h2><a id="wspace">Workspaces menu</a></h2>
 104
 105 <center><img style="width: 101px; height: 121px;" alt="Workspaces menu" src="images/wksm.png"></center>
 106
 107 <br>
 108
 109 <br>
 110
 111 The workspaces menu is part of the root menu (applications menu).
 112 This item has two options: <em>new</em> and <em>destroy last</em>.
 113 <p>The first option creates a new workspace and automatically switches
 114 you to it. </p>
 115
 116 <p>The second option destroys the last workspace as soon as there are
 117 no windows opened in it.</p>
 118
 119 <p>Each workspace has a corresponding item in this menu. The active
 120 workspace is indicated by a diamond to the left of the workspace name
 121 or number.</p>
 122
 123 <p>Clicking a workspace entry switches from the current workspace to
 124 the selected workspace.</p>
 125
 126 <p>To change the name of a workspace, first "stick" the menu by
 127 left-clicking the menu titlebar. Then <em>Ctrl + click</em> the menu
 128 item to make it editable and type in the new name. Hitting <em>Return</em>
 129 saves the new name, hitting <em>Escape</em> cancels the operation.</p>
 130
 131 <p>Key bindings allow movement from one workspace to another. Usually <em>Meta
 132 + (number)</em>. The <span style="font-style: italic;">Meta</span> key
 133 is normally the "<span style="font-style: italic;">Alt</span>" key,
 134 while <em>(number)</em> represents a number
 135 key that corresponds to the workspace number. For instance 1 can be
 136 the default workspace (workspace 1), 2 the second workspace and so on.
 137 Thus,
 138 <span style="font-style: italic;">Meta + 2</span> switches to workspace
 139 2.</p>
 140
 141 <p>These key bindings can be set (or changed) from the keyboard
 142 shortcut dialog in
 143 WPrefs.app. </p>
 144
 145 <h2><a id="apps">Application icon menu</a></h2>
 146
 147 <center><img style="width: 98px; height: 119px;" alt="Icon application menu" src="images/dockm.png"></center>
 148
 149 <br>
 150
 151 <br>
 152
 153 Clicking an icon in the dock with the right mouse button brings a
 154 menu for modifying that icon's application. There are six options
 155 available in the application icon menu for docked applications. (Some
 156 applications will not have all six&nbsp; options available.&nbsp; If an
 157 option is not available, it will appear "greyed out" in the menu.) <br>
 158
 159 <ol>
 160
 161   <li>
 162     <p>Clicking "Keep on top" places a check-mark beside that option,
 163 which means that the icon will always be on "top" of
 164 opened windows. If "Keep on top" is unchecked, windows will be allowed
 165 to cover the icons in the dock. Selecting "Keep on top" for one icon
 166 automatically affects all of the items in the dock. You cannot keep
 167 just one docked icon on top of windows - it's all or nothing, one way
 168 or the other.<br>
 169     </p>
 170   </li>
 171   <li>
 172     <p>"Launch" opens the application without double-clicking the icon.</p>
 173   </li>
 174   <li>
 175     <p>"Bring here" unhides the application in the current workspace.</p>
 176   </li>
 177   <li>
 178     <p>"Hide" hides the application or unhides it if already hidden.
 179 Unhiding opens the application in the workspace where it is located.
 180 (This option may not work if the application has it's own hiding menu
 181 option.)</p>
 182   </li>
 183   <li>
 184     <p>"Settings" allows the modification of application path and
 185 arguments, the command line, and the icon used.</p>
 186   </li>
 187   <li>
 188     <p>"Kill" closes the application immediately and should only be
 189 used if absolutely necessary.</p>
 190   </li>
 191 </ol>
 192
 193 <center><a href="index.html">Back
 194 to Index</a></center>
 195
 196 </body></html>