WINGs: Better presentation for example code in the tutorial
[whome.git] / chap4.php
blob7939a0f84c4dace05e7ea78d630619d5feb0ee8e
1 <html xmlns="http://www.w3.org/1999/xhtml">
2 <head>
3 <meta name="generator" content="HTML Tidy for Linux (vers 25 March 2009), see www.w3.org" />
5 <title>User Guide: Configuration</title>
6 <meta http-equiv="Content-Type" content="text/html; charset=us-ascii" />
7 <link href="title.css" rel="stylesheet" type="text/css" />
8 </head>
10 <body>
11 <?php include("dock.php"); ?>
12 <?php include("header.php"); ?>
14 <table class="inner" border="0" cellpadding="1" cellspacing="1">
15 <tr>
16 <td content="content" colspan="2" valign="top">
17 <br />
18 <br />
19 <br />
21 <h2>Chapter 4</h2>
23 <h1>Configuring Window Maker</h1><br />
24 <br />
25 <a name="4.1"></a>
27 <h2><a name="4.1">4.1 The Defaults System</a></h2><a name="4.1"></a><br />
28 WindowMaker uses a defaults database for storing various information, like configurations and other data that must be
29 kept between sessions (like the list of applications of a saved session). The defaults database is stored as
30 <i>property lists</i> in the $(HOME)/GNUstep/Defaults directory. Each file in the $(HOME)/GNUstep/Defaults directory
31 contains data that belongs to a specific <i>domain</i>.<br />
32 <br />
33 Any application can use the defaults database to store its information. Generally an application will have one or more
34 <i>domains</i> that belong to it.<br />
35 <br />
36 <br />
37 <a name="4.1.1"></a>
39 <h3><a name="4.1.1">4.1.1 Property list File Format</a></h3><a name="4.1.1"></a><br />
40 <br />
41 The syntax of the property list is simple, but, if you need to change it manually you must take care not to leave any
42 syntax errors.<br />
43 <br />
44 The EBNF for the property list is the following:<br />
45 <br />
47 <h3><b>Description of the syntax of a property list in the Bacchus Naur Form (BNF)</b></h3>
49 <center>
50 <table border="1" width="80%" cellspacing="0" cellpadding="5">
51 <tbody>
52 <tr>
53 <td align="center" valign="middle">
54 <table border="0" width="100%" cellspacing="0" cellpadding="5">
55 <tbody>
56 <tr>
57 <td align="left" valign="top"><font face=
58 "Times New Roman, Times, Times Roman">&lt;object&gt;</font></td>
60 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">::=</font></td>
62 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">&lt;string&gt; |
63 &lt;data&gt; | &lt;array&gt; | &lt;dictionary&gt;</font></td>
64 </tr>
66 <tr>
67 <td align="left" valign="top"><font face=
68 "Times New Roman, Times, Times Roman">&lt;string&gt;</font></td>
70 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">::=</font></td>
72 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">text with
73 <i>non-alphanumeric characters</i> | alphanumeric text</font></td>
74 </tr>
76 <tr>
77 <td align="left" valign="top"><font face=
78 "Times New Roman, Times, Times Roman">&lt;array&gt;</font></td>
80 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">::=</font></td>
82 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">`(' [ &lt;object&gt; {
83 `,' &lt;object&gt; }* ] `)'</font></td>
84 </tr>
86 <tr>
87 <td align="left" valign="top"><font face=
88 "Times New Roman, Times, Times Roman">&lt;dictionary&gt;</font></td>
90 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">::=</font></td>
92 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">`{' [
93 &lt;keyval_pair&gt; { `,' &lt;keyval_pair&gt; }* ] `}'</font></td>
94 </tr>
96 <tr>
97 <td align="left" valign="top"><font face=
98 "Times New Roman, Times, Times Roman">&lt;keyval_pair&gt;</font></td>
100 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">::=</font></td>
102 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">&lt;string&gt; `='
103 &lt;object&gt; `;'</font></td>
104 </tr>
105 </tbody>
106 </table>
107 </td>
108 </tr>
109 </tbody>
110 </table>
111 </center><br />
112 <br />
114 <h3><b>Example property list file</b></h3>
115 <pre>
116 <font face="Courier New, Courier"> {
117 "*" = {
118 Icon = "defaultAppIcon.xpm";
120 "xterm.XTerm" = {
121 Icon = "xterm.xpm";
123 xconsole = {
124 Omnipresent = YES;
125 NoTitlebar = YES;
126 KeepOnTop = NO;
129 </font>
130 </pre>The property list above is a dictionary with 3 dictionaries inside. The first is keyed by ``*'', the second by
131 ``XTerm.xterm'' and the last by ``xconsole''.<br />
132 <br />
133 Note that all strings that have non-alphabetic or numeric characters (like a dot ``.'' or the asterisk ``*'' are
134 enclosed by double quotes. Strings with only alphanumeric characters may or may not be enclosed in double quotes, as
135 they will not make any difference.<br />
136 <br />
137 Here is another example:<br />
138 <br />
139 <pre>
140 <font face="Courier New, Courier">{
141 FTitleBack = ( hgradient, gray, "#112233" );
143 </font>
144 </pre><br />
145 <br />
146 The property list in the example above contains an array with 3 elements with a key named ``FTitleBack''.<br />
147 <br />
148 Except for cases like file names and paths, all value strings are case insensitive, i.e.: YES = Yes = yes = yEs<br />
149 <br />
150 <a name="Value Types"></a>
152 <h3><a name="Value Types">4.1.2 Value Types</a></h3><a name="Value Types"></a><br />
153 Here is a description of some of the types of values that an option might have:<br />
154 <br />
156 <center>
157 <table border="0" width="80%" cellspacing="0" cellpadding="0">
158 <tbody>
159 <tr>
160 <th align="left"><font face="Times New Roman, Times, Times Roman">Type</font></th>
162 <th align="left"><font face="Times New Roman, Times, Times Roman">Value</font></th>
163 </tr>
165 <tr>
166 <td colspan="2">
167 <hr />
168 </td>
169 </tr>
171 <tr>
172 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">boolean</font></td>
174 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">YES or NO</font></td>
175 </tr>
177 <tr>
178 <td colspan="2">
179 <hr />
180 </td>
181 </tr>
183 <tr>
184 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">integer</font></td>
186 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">any integer number, usually
187 limited by a range that will be indicated</font></td>
188 </tr>
190 <tr>
191 <td colspan="2">
192 <hr />
193 </td>
194 </tr>
196 <tr>
197 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">positive integer</font></td>
199 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">any integer number greater than
200 or equal to zero (0)</font></td>
201 </tr>
203 <tr>
204 <td colspan="2">
205 <hr />
206 </td>
207 </tr>
209 <tr>
210 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">speed</font></td>
212 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">UltraFast, Fast, Medium, Slow,
213 or VerySlow</font></td>
214 </tr>
216 <tr>
217 <td colspan="2">
218 <hr />
219 </td>
220 </tr>
222 <tr>
223 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">mouse button</font></td>
225 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Left, Middle, Right, Button1,
226 Button2, Button3, Button4, or Button5</font></td>
227 </tr>
229 <tr>
230 <td colspan="2">
231 <hr />
232 </td>
233 </tr>
234 </tbody>
235 </table>
236 </center><br />
237 <br />
238 <br />
239 <a name="4.1.3"></a>
241 <h3><a name="4.1.3">4.1.3 Preferences</a></h3><a name="4.1.3"></a> General preference options are stored in the
242 <i>WindowMaker</i> domain; i.e. the $(HOME)/GNUstep/Defaults/WindowMaker file.<br />
243 <br />
244 Changes in preference options will automatically affect the current WindowMaker session, without a restart. Some
245 options, however, require a restart of WindowMaker before they take effect. Such options are marked with a * .<br />
246 <br />
247 Note that values marked as <i>Default</i> are values that are assumed if the option is not specified, instead of
248 <i>factory default</i> values that are set in the preference file.<br />
249 <br />
251 <center>
252 <table border="0" width="95%" cellspacing="0" cellpadding="5">
253 <tbody>
254 <tr>
255 <th align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Option</font></th>
257 <th align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Value</font></th>
259 <th align="leftt" valign="top"><font face="Times New Roman, Times, Times Roman">Description</font></th>
260 </tr>
262 <tr>
263 <td align="left" valign="top"><font face="Courier New, Courier">PixmapPath</font></td>
265 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">list of directories separated by
266 ":" (default: depends on the system)</font></td>
268 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">A list of directories where
269 pixmaps can be found. The pixmaps for things like icons, are searched in these paths in order of
270 appearance.</font></td>
271 </tr>
273 <tr>
274 <td align="left" valign="top"><font face="Courier New, Courier">*NoDithering</font></td>
276 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">boolean (default:
277 NO)</font></td>
279 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Disable internal dithering of
280 images. Not recommended for displays with less than 8 bits per pixel.</font></td>
281 </tr>
283 <tr>
284 <td align="left" valign="top"><font face="Courier New, Courier">*ColormapSize</font></td>
286 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">integer number &gt; 1 (default:
287 4)</font></td>
289 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Number of colors for each of the
290 red, green and blue components to be used for the dithering colormap. This value must be greater than 1 and
291 smaller than 6 for 8bpp displays. It only makes sense on PseudoColor displays. This option has not effect on
292 TrueColor displays. Larger values result in better appearance, but leaves less colors for other
293 applications.</font></td>
294 </tr>
296 <tr>
297 <td align="left" valign="top"><font face="Courier New, Courier">*ModifierKey</font></td>
299 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">modifier key name (default:
300 Mod1)</font></td>
302 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">The key to use as the modifier
303 being referred as Meta in this manual, like Meta dragging a window to move it. Valid values are Alt, Meta,
304 Super, Hyper, Mod1, Mod2, Mod3, Mod4, Mod5.</font></td>
305 </tr>
307 <tr>
308 <td align="left" valign="top"><font face="Courier New, Courier">UseSaveUnders</font></td>
310 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">boolean (default:
311 NO)</font></td>
313 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Use <i>saveunders</i> in
314 WindowMaker windows. This can improve performance but increases memory usage. It also can cause problems with
315 refreshing in some applications.</font></td>
316 </tr>
318 <tr>
319 <td align="left" valign="top"><font face="Courier New, Courier">DisableClip</font></td>
321 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">boolean (default:
322 NO)</font></td>
324 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Will remove the application Clip
325 from the workspace.</font></td>
326 </tr>
328 <tr>
329 <td align="left" valign="top"><font face="Courier New, Courier">DisableDock</font></td>
331 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">boolean (default:
332 NO)</font></td>
334 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Will remove the application Dock
335 from the workspace</font></td>
336 </tr>
338 <tr>
339 <td align="left" valign="top"><font face="Courier New, Courier">Superfluous</font></td>
341 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">boolean (default:
342 NO)</font></td>
344 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Enable extra animations and
345 other cosmetic things that might increase peak memory and CPU usage.</font></td>
346 </tr>
348 <tr>
349 <td align="left" valign="top"><font face="Courier New, Courier">SaveSessionOnExit</font></td>
351 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">boolean (default:
352 NO)</font></td>
354 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Automatically save the state of
355 the session when exiting WindowMaker.</font></td>
356 </tr>
358 <tr>
359 <td align="left" valign="top"><font face="Courier New, Courier">*IconSize</font></td>
361 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">integer &gt; 4 (default:
362 64)</font></td>
364 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">The size of application icons
365 and miniwindows.</font></td>
366 </tr>
368 <tr>
369 <td align="left" valign="top"><font face="Courier New, Courier">OpaqueMove</font></td>
371 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">boolean (default:
372 NO)</font></td>
374 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Whether the whole window should
375 be moved while dragging it, or, if only it's frame should be dragged.</font></td>
376 </tr>
378 <tr>
379 <td align="left" valign="top"><font face="Courier New, Courier">FocusMode</font></td>
381 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Manual or CickToFocus, Auto or
382 FocusFollowsMouse, SemiAuto or Sloppy (default: ClickToFocus)</font></td>
384 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">The mode of input focus setting.
385 Refer to section <a href="chap2.php#2.2.1">2.2.1, Focusing a
386 Window</a></font></td>
387 </tr>
389 <tr>
390 <td align="left" valign="top"><font face="Courier New, Courier">IgnoreFocusClick</font></td>
392 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">boolean (default:
393 NO)</font></td>
395 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Whether the mouse click use to
396 focus a window should be ignore or treated normally.</font></td>
397 </tr>
399 <tr>
400 <td align="left" valign="top"><font face="Courier New, Courier">AutoFocus</font></td>
402 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">boolean (default:
403 NO)</font></td>
405 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Whether newly created windows
406 should receive input focus. Do not confuse with FocusMode=Auto.</font></td>
407 </tr>
409 <tr>
410 <td align="left" valign="top"><font face="Courier New, Courier">RaiseDelay</font></td>
412 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">integer number (default:
413 0)</font></td>
415 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">How many tenths of a second to
416 wait before raising a window in Auto or Semi-Auto focus mode. 0 disables this feature.</font></td>
417 </tr>
419 <tr>
420 <td align="left" valign="top"><font face="Courier New, Courier">DoubleClickTime</font></td>
422 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">integer number (default:
423 250)</font></td>
425 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">If two mouse clicks occur in
426 this interval of time, it will be considered a double click.</font></td>
427 </tr>
429 <tr>
430 <td align="left" valign="top"><font face="Courier New, Courier">ColorMapMode</font></td>
432 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Manual or ClickToFocus, Auto or
433 FocusFollowsMouse (default: auto)</font></td>
435 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">The mode of colormap setting. In
436 <i>Manual</i> or <i>ClickToFocus</i> mode, the colormap is set to the one belonging to the current focused
437 window. In <i>Auto</i> or <i>FocusFollowsMouse</i> mode, the colormap is set to the one belonging to the window
438 under the pointer.</font></td>
439 </tr>
441 <tr>
442 <td align="left" valign="top"><font face="Courier New, Courier">CirculateRaise</font></td>
444 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">boolean (default:
445 NO)</font></td>
447 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Whether the window should be
448 raised when circulating. (focus the next or previous window through the keyboard)</font></td>
449 </tr>
451 <tr>
452 <td align="left" valign="top"><font face="Courier New, Courier">OnTopTransients</font></td>
454 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">boolean (default:
455 NO)</font></td>
457 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Whether transient windows should
458 always be placed over their owners</font></td>
459 </tr>
461 <tr>
462 <td align="left" valign="top"><font face="Courier New, Courier">WindowPlacement</font></td>
464 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">auto, cascade, manual, or random
465 (default: cascade)</font></td>
467 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Sets placement mode for new
468 windows. <i>Auto</i> places the window automatically in the first open space found in the workspace.
469 <i>Cascade</i> places the window in incrementing positions starting from the the top-left corner of the
470 workspace. <i>Manual</i> allows you to place the window interactively with the mouse. <i>Random</i> paces the
471 window randomly in the workspace.</font></td>
472 </tr>
474 <tr>
475 <td align="left" valign="top"><font face="Courier New, Courier">WindowPlaceOrigin</font></td>
477 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">(X,Y) where X and Y are integer
478 numbers (default: (0,0))</font></td>
480 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Sets the offset, from the
481 top-left corner of the screen, to place windows. In non-manual WindowPlacement modes windows will not be placed
482 above or to the left of this point.</font></td>
483 </tr>
485 <tr>
486 <td align="left" valign="top"><font face="Courier New, Courier">AutoArrangeIcons</font></td>
488 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">boolean (default:
489 NO)</font></td>
491 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Whether icons should be
492 automatically arranged</font></td>
493 </tr>
495 <tr>
496 <td align="left" valign="top"><font face="Courier New, Courier">ResizeDisplay</font></td>
498 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">center, corner, floating, or
499 line (default: corner)</font></td>
501 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Selects the type or position of
502 the box that shows the window size when a window is being resized. <i>center</i> places the box in the center
503 of the workspace, <i>corner</i> places it in the top-left corner of the workspace, <i>floating</i> places it in
504 the center of the window being resized and <i>line</i> draws the current window size over the workspace, like
505 in a technical drawing.</font></td>
506 </tr>
508 <tr>
509 <td align="left" valign="top"><font face="Courier New, Courier">MoveDisplay</font></td>
511 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">center, corner or floating
512 (default: corner)</font></td>
514 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Selects the type or position of
515 the box that shows the window position when a window is being moved. The value meanings are the same as for the
516 ResizeDisplay option.</font></td>
517 </tr>
519 <tr>
520 <td align="left" valign="top"><font face="Courier New, Courier">AlignSubmenus</font></td>
522 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">boolean (default:
523 NO)</font></td>
525 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Whether submenus should be
526 aligned vertically with their parent menus.</font></td>
527 </tr>
529 <tr>
530 <td align="left" valign="top"><font face="Courier New, Courier">WrapMenus</font></td>
532 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">boolean (default:
533 NO)</font></td>
535 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Whether submenus should be
536 placed to the right of their parent menus when they don't fit the screen. Note that menus placed off the screen
537 can be scrolled.</font></td>
538 </tr>
540 <tr>
541 <td align="left" valign="top"><font face="Courier New, Courier">ScrollableMenus</font></td>
543 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">boolean (default:
544 NO)</font></td>
546 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Whether menus that are not fully
547 inside the screen should automatically scroll when the pointer is over them and near the border of the
548 screen.</font></td>
549 </tr>
551 <tr>
552 <td align="left" valign="top"><font face="Courier New, Courier">MenuScrollSpeed</font></td>
554 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">speed (default:
555 medium)</font></td>
557 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">The scrolling speed of
558 menus.</font></td>
559 </tr>
561 <tr>
562 <td align="left" valign="top"><font face="Courier New, Courier">DontLinkWorkspaces</font></td>
564 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">boolean (default:
565 NO)</font></td>
567 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Do not automatically switch to
568 the next or previous workspace when a window is dragged to the edge of the screen.</font></td>
569 </tr>
571 <tr>
572 <td align="left" valign="top"><font face="Courier New, Courier">NoWindowUnderDock</font></td>
574 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">boolean (default:
575 NO)</font></td>
577 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">When maximizing windows, limit
578 their sizes so that they will not be covered by the dock.</font></td>
579 </tr>
581 <tr>
582 <td align="left" valign="top"><font face="Courier New, Courier">NoWindowOverIcons</font></td>
584 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">boolean (default:
585 NO)</font></td>
587 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">When maximizing windows, limit
588 their sizes so that they will cover miniwindows and application icons.</font></td>
589 </tr>
591 <tr>
592 <td align="left" valign="top"><font face="Courier New, Courier">StickyIcons</font></td>
594 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">boolean (default:
595 NO)</font></td>
597 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Whether miniwindows should be
598 present in all workspaces.</font></td>
599 </tr>
601 <tr>
602 <td align="left" valign="top"><font face="Courier New, Courier">CycleWorkspaces</font></td>
604 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">boolean (default:
605 NO)</font></td>
607 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Set to YES if you want windows
608 that are dragged past the last workspace to be moved to the first workspace, and vice-versa.</font></td>
609 </tr>
611 <tr>
612 <td align="left" valign="top"><font face="Courier New, Courier">AdvanceToNewWorkspace</font></td>
614 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">boolean (default:
615 NO)</font></td>
617 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Whether windows dragged past the
618 last workspace should create a new workspace.</font></td>
619 </tr>
621 <tr>
622 <td align="left" valign="top"><font face="Courier New, Courier">DisableAnimations</font></td>
624 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">boolean (default:
625 NO)</font></td>
627 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Whether animations, like the one
628 done during minimization, should be disabled.</font></td>
629 </tr>
631 <tr>
632 <td align="left" valign="top"><font face="Courier New, Courier">IconSlideSpeed</font></td>
634 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">speed (default:
635 medium)</font></td>
637 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">The speed of icons when they are
638 being slid across the workspace.</font></td>
639 </tr>
641 <tr>
642 <td align="left" valign="top"><font face="Courier New, Courier">ShadeSpeed</font></td>
644 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">speed (default:
645 medium)</font></td>
647 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">The speed of the shading
648 animation.</font></td>
649 </tr>
651 <tr>
652 <td align="left" valign="top"><font face="Courier New, Courier">DisableSound</font></td>
654 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">boolean (default:
655 NO)</font></td>
657 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Whether sound support in
658 WindowMaker should be disabled</font></td>
659 </tr>
661 <tr>
662 <td align="left" valign="top"><font face="Courier New, Courier">*DisableWSMouseActions</font></td>
664 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">boolean (default:
665 NO)</font></td>
667 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Whether actions in the workspace
668 triggered by mouse-clicks should be disabled. This allows the use of file and desktop managers that place icons
669 on the root window (such as KDE).</font></td>
670 </tr>
672 <tr>
673 <td align="left" valign="top"><font face="Courier New, Courier">SelectWindowMouseButton</font></td>
675 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">mouse button (default:
676 left)</font></td>
678 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">The mouse button that activates
679 selection of multiple windows in the workspace.</font></td>
680 </tr>
682 <tr>
683 <td align="left" valign="top"><font face="Courier New, Courier">WindowListMouseButton</font></td>
685 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">mouse button (default:
686 middle)</font></td>
688 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">The mouse button that opens the
689 window list menu in the workspace.</font></td>
690 </tr>
692 <tr>
693 <td align="left" valign="top"><font face="Courier New, Courier">ApplicationMenuMouseButton</font></td>
695 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">mouse button (default:
696 right)</font></td>
698 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">The mouse button that opens the
699 applications menu in the workspace.</font></td>
700 </tr>
701 </tbody>
702 </table>
703 </center><br />
704 <br />
706 <h3><b>Appearance Options</b></h3><br />
707 Fonts are specified in the X Logical Font Description format. You can cut and paste these names from programs like
708 <font face="Courier New, Courier">xfontsel</font>.<br />
709 <br />
710 Colors are specified as color names in the standard X format. This can be any color name shown by the <font face=
711 "Courier New, Courier">showrgb</font> program (like black, white or gray) or a color value in the #rrggbb format, where
712 rr, gg and bb is the intensity of the color component (like #ff0000 for pure red or #000080 for medium blue). Note that
713 color names in the #rrggbb format must be enclosed with double quotes.<br />
714 <br />
715 Textures are specified as an array, where the first element specifies the texture type followed by a variable number of
716 arguments.<br />
717 <br />
718 Valid texture types are:<br />
719 <br />
721 <center>
722 <table border="0" width="90%" cellspacing="0" cellpadding="5">
723 <tbody>
724 <tr>
725 <th align="right" valign="top"><font face="Times New Roman, Times, Times Roman">(solid, color)</font></th>
727 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">the texture is a simple solid
728 color.</font></td>
729 </tr>
731 <tr>
732 <th align="right" valign="top"><font face="Times New Roman, Times, Times Roman">(dgradient, color1,
733 color2)</font></th>
735 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">the texture is a diagonal
736 gradient rendered from the top-left corner to the bottom-right corner. The first argument (color1) is the color
737 for the top-left corner and the second (color2) is for the bottom-right corner.</font></td>
738 </tr>
740 <tr>
741 <th align="right" valign="top"><font face="Times New Roman, Times, Times Roman">(hgradient, color1,
742 color2)</font></th>
744 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">the texture is a horizontal
745 gradient rendered from the left edge to the right edge. The first argument (color1) is the color for the left
746 edge and the second (color2) is for the right edge.</font></td>
747 </tr>
749 <tr>
750 <th align="right" valign="top"><font face="Times New Roman, Times, Times Roman">(vgradient, color1,
751 color2)</font></th>
753 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">the texture is a vertical
754 gradient rendered from the top edge to the bottom edge. The first argument (color1) is the color for the top
755 edge and the second (color2) is for the bottom edge.</font></td>
756 </tr>
758 <tr>
759 <th align="right" valign="top"><font face="Times New Roman, Times, Times Roman">(mdgradient, color1,
760 color2,...,color<i>n</i>)</font></th>
762 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">this is equivalent to drgadient,
763 but you can specify more than two colors</font></td>
764 </tr>
766 <tr>
767 <th align="right" valign="top"><font face="Times New Roman, Times, Times Roman">(mhgradient, color1,
768 color2,...,color<i>n</i>)</font></th>
770 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">this is equivalent to hrgadient,
771 but you can specify more than two colors</font></td>
772 </tr>
774 <tr>
775 <th align="right" valign="top"><font face="Times New Roman, Times, Times Roman">(mvgradient, color1,
776 color2,...,color<i>n</i>)</font></th>
778 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">this is equivalent to vrgadient,
779 but you can specify more than two colors</font></td>
780 </tr>
781 </tbody>
782 </table>
783 </center><br />
784 <br />
785 <b>Examples:</b>
787 <center>
788 <table border="0" width="80%" cellspacing="0" cellpadding="5">
789 <tbody>
790 <tr>
791 <td align="center" valign="middle"><img src="guide/images/texsolid.gif" border="0" width="151" height="21" alt=
792 "[Solid Color]" /></td>
794 <th align="left" valign="top"><font face="Times New Roman, Times, Times Roman">(solid, gray)</font></th>
795 </tr>
797 <tr>
798 <td align="center" valign="middle"><img src="guide/images/texdgrad.gif" border="0" width="151" height="21" alt=
799 "[Diagoonal Gradient]" /></td>
801 <th align="left" valign="top"><font face="Times New Roman, Times, Times Roman">(dgradient, gray80,
802 gray20)</font></th>
803 </tr>
805 <tr>
806 <td align="center" valign="middle"><img src="guide/images/texhgrad.gif" border="0" width="151" height="21" alt=
807 "[Horizontal Gradient]" /></td>
809 <th align="left" valign="top"><font face="Times New Roman, Times, Times Roman">(hgradient, gray80,
810 gray20)</font></th>
811 </tr>
813 <tr>
814 <td align="center" valign="middle"><img src="guide/images/texvgrad.gif" border="0" width="151" height="21" alt=
815 "[Vertical Gradient]" /></td>
817 <th align="left" valign="top"><font face="Times New Roman, Times, Times Roman">(vgradient, gray80,
818 gray20)</font></th>
819 </tr>
820 </tbody>
821 </table>
822 </center><br />
823 <br />
824 <br />
825 <br />
827 <center>
828 <table border="0" width="95%" cellspacing="0" cellpadding="5">
829 <tbody>
830 <tr>
831 <th align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Option</font></th>
833 <th align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Value</font></th>
835 <th align="leftt" valign="top"><font face="Times New Roman, Times, Times Roman">Description</font></th>
836 </tr>
838 <tr>
839 <td align="left" valign="top"><font face="Courier New, Courier">*NewStyle</font></td>
841 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">boolean (default:
842 NO)</font></td>
844 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Selects between N*XTSTEP style
845 buttons in the titlebar and a newer style of buttons.</font></td>
846 </tr>
848 <tr>
849 <td align="left" valign="top"><font face="Courier New, Courier">WidgetColor</font></td>
851 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">(solid, color) where color is a
852 color name (default: (solid, grey))</font></td>
854 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Chooses the color to be used in
855 titlebar buttons if NewStyle=No;</font></td>
856 </tr>
858 <tr>
859 <td align="left" valign="top"><font face="Courier New, Courier">WorkspaceBack</font></td>
861 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">a texture or none (default:
862 none)</font></td>
864 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Default texture for the
865 workspace background. Note the <i>dgradient</i> and <i>mdgradient</i> textures can take a lot of time to be
866 rendered.</font></td>
867 </tr>
869 <tr>
870 <td align="left" valign="top"><font face="Courier New, Courier">IconBack</font></td>
872 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">texture (default: (solid,
873 grey))</font></td>
875 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Texture for the background of
876 icons and miniwindows.</font></td>
877 </tr>
879 <tr>
880 <td align="left" valign="top"><font face="Courier New, Courier">FTitleBack</font></td>
882 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">texture (default: (solid,
883 black))</font></td>
885 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Texture for the focused window
886 titlebar.</font></td>
887 </tr>
889 <tr>
890 <td align="left" valign="top"><font face="Courier New, Courier">PTitleBack</font></td>
892 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">texture (default: (solid,
893 "#616161"))</font></td>
895 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Texture for the titlebar of the
896 parent window of the currently focused transient window</font></td>
897 </tr>
899 <tr>
900 <td align="left" valign="top"><font face="Courier New, Courier">UTitleBack</font></td>
902 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">texture (default: (solid,
903 gray))</font></td>
905 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Texture for unfocused window
906 titlebars.</font></td>
907 </tr>
909 <tr>
910 <td align="left" valign="top"><font face="Courier New, Courier">MenuTitleBack</font></td>
912 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">texture (default: (solid,
913 black))</font></td>
915 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Texture for menu
916 titlebars.</font></td>
917 </tr>
919 <tr>
920 <td align="left" valign="top"><font face="Courier New, Courier">MenuTextBack</font></td>
922 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">texture (default: (solid,
923 gray))</font></td>
925 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Texture for menu
926 items</font></td>
927 </tr>
929 <tr>
930 <td align="left" valign="top"><font face="Courier New, Courier">FTitleColor</font></td>
932 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">color (default:
933 white)</font></td>
935 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">The color of the text in the
936 focused window titlebar.</font></td>
937 </tr>
939 <tr>
940 <td align="left" valign="top"><font face="Courier New, Courier">PTitleColor</font></td>
942 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">color (default:
943 white)</font></td>
945 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Color for the text in the
946 titlebar of the parent window of the currently focused transient.</font></td>
947 </tr>
949 <tr>
950 <td align="left" valign="top"><font face="Courier New, Courier">UTitleColor</font></td>
952 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">color (default:
953 black)</font></td>
955 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">The color for the text in the
956 titlebar of unfocused windows.</font></td>
957 </tr>
959 <tr>
960 <td align="left" valign="top"><font face="Courier New, Courier">MenuTitleColor</font></td>
962 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">color (default:
963 white)</font></td>
965 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Color for the text in menu
966 titlebars</font></td>
967 </tr>
969 <tr>
970 <td align="left" valign="top"><font face="Courier New, Courier">MenuTextColor</font></td>
972 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">color (default:
973 black)</font></td>
975 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Color for the text in menu
976 items</font></td>
977 </tr>
979 <tr>
980 <td align="left" valign="top"><font face="Courier New, Courier">HighlightColor</font></td>
982 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">color (default:
983 white)</font></td>
985 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Color for the highlighted item
986 in menus.</font></td>
987 </tr>
989 <tr>
990 <td align="left" valign="top"><font face="Courier New, Courier">HighlightTextColor</font></td>
992 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">color (default:
993 black)</font></td>
995 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Color for the highlighted item
996 text in menus.</font></td>
997 </tr>
999 <tr>
1000 <td align="left" valign="top"><font face="Courier New, Courier">MenuDisabledColor</font></td>
1002 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">color (default:
1003 "#616161")</font></td>
1005 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Color for the text of disabled
1006 menu items.</font></td>
1007 </tr>
1009 <tr>
1010 <td align="left" valign="top"><font face="Courier New, Courier">ClipTitleColor</font></td>
1012 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">color (default:
1013 black)</font></td>
1015 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Color for the text in the
1016 clip.</font></td>
1017 </tr>
1019 <tr>
1020 <td align="left" valign="top"><font face="Courier New, Courier">CClipTitleColor</font></td>
1022 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">color (default:
1023 "#454045")</font></td>
1025 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Color for the text in the
1026 collapsed clip.</font></td>
1027 </tr>
1029 <tr>
1030 <td align="left" valign="top"><font face="Courier New, Courier">WindowTitleFont</font></td>
1032 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">font (default: Helvetica bold
1033 12)</font></td>
1035 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Font for the text in window
1036 titlebars.</font></td>
1037 </tr>
1039 <tr>
1040 <td align="left" valign="top"><font face="Courier New, Courier">MenuTitleFont</font></td>
1042 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">font (default: Helvetica bold
1043 12)</font></td>
1045 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Font for the text in menu
1046 titlebars)</font></td>
1047 </tr>
1049 <tr>
1050 <td align="left" valign="top"><font face="Courier New, Courier">MenuTextFont</font></td>
1052 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">font (default: Helvetica medium
1053 12)</font></td>
1055 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Font for the text in menu
1056 items</font></td>
1057 </tr>
1059 <tr>
1060 <td align="left" valign="top"><font face="Courier New, Courier">IconTitleFont</font></td>
1062 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">font (default: Helvetica medium
1063 8)</font></td>
1065 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Font for the text in miniwindow
1066 titlebars.</font></td>
1067 </tr>
1069 <tr>
1070 <td align="left" valign="top"><font face="Courier New, Courier">ClipTitleFont</font></td>
1072 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">font (default: Helvetica bold
1073 10)</font></td>
1075 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Font for the text in the
1076 clip.</font></td>
1077 </tr>
1079 <tr>
1080 <td align="left" valign="top"><font face="Courier New, Courier">Displayfont</font></td>
1082 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">font (default: Helvetica medium
1083 12)</font></td>
1085 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Font for the text information in
1086 windows, like the size of windows during resize.</font></td>
1087 </tr>
1089 <tr>
1090 <td align="left" valign="top"><font face="Courier New, Courier">TitleJustify</font></td>
1092 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">center, left, or right (default:
1093 center)</font></td>
1095 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Justification of the text in
1096 window titlebars.</font></td>
1097 </tr>
1098 </tbody>
1099 </table>
1100 </center><br />
1101 <br />
1103 <h3><b>Keyboard Bindings</b></h3><br />
1104 <br />
1105 Keyboard shortcut specifications are in the form:<br />
1106 <br />
1107 <pre>
1108 <font face="Courier New, Courier">
1109 [&lt;modifier key names&gt; + ] &lt;key name&gt;
1110 </font>
1111 </pre><br />
1112 <br />
1113 Where <i>modifier key names</i> specify an optional modifier key, like Meta or Shift. Any number of modifier keys might
1114 be specified. The <i>key name</i> is the actual key that will trigger the action bound to the option.<br />
1115 <br />
1116 Examples:<br />
1117 <br />
1119 <table border="0" width="80%" cellspacing="0" cellpadding="5">
1120 <tbody>
1121 <tr>
1122 <th align="right">[F10]</th>
1124 <td align="left">Means the F10 key.</td>
1125 </tr>
1127 <tr>
1128 <th align="right"><font face="Times New Roman, Times, Times Roman">Meta+TAB</font></th>
1130 <td align="left"><font face="Times New Roman, Times, Times Roman">Means the TAB key with the Meta modifier key
1131 pressed at the same time.</font></td>
1132 </tr>
1134 <tr>
1135 <th align="right"><font face="Times New Roman, Times, Times Roman">Meta+Shift+TAB</font></th>
1137 <td align="left"><font face="Times New Roman, Times, Times Roman">Means the TAB key with the Meta and Shift
1138 modifier keys pressed at the same time.</font></td>
1139 </tr>
1140 </tbody>
1141 </table><br />
1142 <br />
1143 Key names can be found at /usr/X11R6/include/X11/keysymdef.h The <b>XK_</b> prefixes must be ignored (if key name is
1144 <b>XK_</b>Return use Return).<br />
1145 <br />
1147 <center>
1148 <table border="0" width="95%" cellspacing="0" cellpadding="5">
1149 <tbody>
1150 <tr>
1151 <th align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Option</font></th>
1153 <th align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Default Value</font></th>
1155 <th align="leftt" valign="top"><font face="Times New Roman, Times, Times Roman">Description</font></th>
1156 </tr>
1158 <tr>
1159 <td align="left" valign="top"><font face="Courier New, Courier">RootMenuKey</font></td>
1161 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">None</font></td>
1163 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Opens the <a href=
1164 "chap3.php#3.1.1">root window menu</a> at the current
1165 position of the mouse pointer.</font></td>
1166 </tr>
1168 <tr>
1169 <td align="left" valign="top"><font face="Courier New, Courier">WindowListKey</font></td>
1171 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">None</font></td>
1173 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Opens the <a href=
1174 "chap3.php#3.1.2">window list menu</a> menu at the current
1175 position of the mouse pointer.</font></td>
1176 </tr>
1178 <tr>
1179 <td align="left" valign="top"><font face="Courier New, Courier">WindowMenuKey</font></td>
1181 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">None</font></td>
1183 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Opens the <a href=
1184 "chap2.php#2.2.9">window commands menu</a> for the currently
1185 focused window.</font></td>
1186 </tr>
1188 <tr>
1189 <td align="left" valign="top"><font face="Courier New, Courier">MiniaturizeKey</font></td>
1191 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">None</font></td>
1193 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Miniaturizes the currently
1194 focused window.</font></td>
1195 </tr>
1197 <tr>
1198 <td align="left" valign="top"><font face="Courier New, Courier">HideKey</font></td>
1200 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">None</font></td>
1202 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Hides the currently active
1203 application.</font></td>
1204 </tr>
1206 <tr>
1207 <td align="left" valign="top"><font face="Courier New, Courier">CloseKey</font></td>
1209 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">None</font></td>
1211 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Closes the current focused
1212 window</font></td>
1213 </tr>
1215 <tr>
1216 <td align="left" valign="top"><font face="Courier New, Courier">MaximizeKey</font></td>
1218 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">None</font></td>
1220 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Maxmizes the currently focused
1221 window.</font></td>
1222 </tr>
1224 <tr>
1225 <td align="left" valign="top"><font face="Courier New, Courier">VMaximizeKey</font></td>
1227 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">None</font></td>
1229 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Vertically Maximizes the
1230 currently focused window.</font></td>
1231 </tr>
1233 <tr>
1234 <td align="left" valign="top"><font face="Courier New, Courier">RaiseKey</font></td>
1236 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Meta+Up</font></td>
1238 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Raises the currently focused
1239 window.</font></td>
1240 </tr>
1242 <tr>
1243 <td align="left" valign="top"><font face="Courier New, Courier">LowerKey</font></td>
1245 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Meta+Down</font></td>
1247 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Lowers the currently focused
1248 window.</font></td>
1249 </tr>
1251 <tr>
1252 <td align="left" valign="top"><font face="Courier New, Courier">RaiseLowerKey</font></td>
1254 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">None</font></td>
1256 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Raises the window under the
1257 pointer, or lowers it if it is already raised.</font></td>
1258 </tr>
1260 <tr>
1261 <td align="left" valign="top"><font face="Courier New, Courier">ShadeKey</font></td>
1263 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">None</font></td>
1265 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Shades the currently focused
1266 window.</font></td>
1267 </tr>
1269 <tr>
1270 <td align="left" valign="top"><font face="Courier New, Courier">SelectKey</font></td>
1272 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">None</font></td>
1274 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Selects current focused
1275 window.</font></td>
1276 </tr>
1278 <tr>
1279 <td align="left" valign="top"><font face="Courier New, Courier">FocusNextKey</font></td>
1281 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">None</font></td>
1283 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Switch focus to next
1284 window.</font></td>
1285 </tr>
1287 <tr>
1288 <td align="left" valign="top"><font face="Courier New, Courier">FocusPrevKey</font></td>
1290 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">None</font></td>
1292 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Switch focus to previous
1293 window.</font></td>
1294 </tr>
1296 <tr>
1297 <td align="left" valign="top"><font face="Courier New, Courier">NextWorkspaceKey</font></td>
1299 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">None</font></td>
1301 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Switches to next
1302 workspace.</font></td>
1303 </tr>
1305 <tr>
1306 <td align="left" valign="top"><font face="Courier New, Courier">PrevWorkspaceKey</font></td>
1308 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">None</font></td>
1310 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Switches to previous
1311 workspace.</font></td>
1312 </tr>
1314 <tr>
1315 <td align="left" valign="top"><font face="Courier New, Courier">NextWorkspaceLayerKey</font></td>
1317 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">None</font></td>
1319 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Switches to the next group of 10
1320 workspaces.</font></td>
1321 </tr>
1323 <tr>
1324 <td align="left" valign="top"><font face="Courier New, Courier">PrevWorkspaceLayerKey</font></td>
1326 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">None</font></td>
1328 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Switches to the previous group
1329 of 10 workspaces.</font></td>
1330 </tr>
1332 <tr>
1333 <td align="left" valign="top"><font face="Courier New, Courier">Workspace1Key</font></td>
1335 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">None</font></td>
1337 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Switches to workspace
1338 1.</font></td>
1339 </tr>
1341 <tr>
1342 <td align="left" valign="top"><font face="Courier New, Courier">Workspace2Key</font></td>
1344 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">None</font></td>
1346 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Switches to workspace 2,
1347 creating it if it does not exist.</font></td>
1348 </tr>
1350 <tr>
1351 <td align="left" valign="top"><font face="Courier New, Courier">Workspace3Key</font></td>
1353 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">None</font></td>
1355 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Switches to workspace 3,
1356 creating it if it does not exist.</font></td>
1357 </tr>
1359 <tr>
1360 <td align="left" valign="top"><font face="Courier New, Courier">Workspace4Key</font></td>
1362 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">None</font></td>
1364 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Switches to workspace 4,
1365 creating it if it does not exist.</font></td>
1366 </tr>
1368 <tr>
1369 <td align="left" valign="top"><font face="Courier New, Courier">Workspace5Key</font></td>
1371 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">None</font></td>
1373 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Switches to workspace 5,
1374 creating it if it does not exist.</font></td>
1375 </tr>
1377 <tr>
1378 <td align="left" valign="top"><font face="Courier New, Courier">Workspace6Key</font></td>
1380 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">None</font></td>
1382 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Switches to workspace 6,
1383 creating it if it does not exist.</font></td>
1384 </tr>
1386 <tr>
1387 <td align="left" valign="top"><font face="Courier New, Courier">Workspace7Key</font></td>
1389 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">None</font></td>
1391 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Switches to workspace 7,
1392 creating it if it does not exist.</font></td>
1393 </tr>
1395 <tr>
1396 <td align="left" valign="top"><font face="Courier New, Courier">Workspace8Key</font></td>
1398 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">None</font></td>
1400 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Switches to workspace 8,
1401 creating it if it does not exist.</font></td>
1402 </tr>
1404 <tr>
1405 <td align="left" valign="top"><font face="Courier New, Courier">Workspace9Key</font></td>
1407 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">None</font></td>
1409 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Switches to workspace 9,
1410 creating it if it does not exist.</font></td>
1411 </tr>
1413 <tr>
1414 <td align="left" valign="top"><font face="Courier New, Courier">Workspace10Key</font></td>
1416 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">None</font></td>
1418 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Switches to workspace 10,
1419 creating it if it does not exist.</font></td>
1420 </tr>
1422 <tr>
1423 <td align="left" valign="top"><font face="Courier New, Courier">ClipLowerKey</font></td>
1425 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">None</font></td>
1427 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Lowers the clip.</font></td>
1428 </tr>
1430 <tr>
1431 <td align="left" valign="top"><font face="Courier New, Courier">ClipLowerKey</font></td>
1433 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">None</font></td>
1435 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Lowers the clip.</font></td>
1436 </tr>
1438 <tr>
1439 <td align="left" valign="top"><font face="Courier New, Courier">ClipRaiseLowerKEy</font></td>
1441 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">None</font></td>
1443 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Raises the clip, or lowers it if
1444 it is already raised.</font></td>
1445 </tr>
1446 </tbody>
1447 </table>
1448 </center><br />
1449 <br />
1450 <br />
1451 <br />
1452 <a name="4.1.4"></a>
1454 <h3><a name="4.1.4">4.1.4 Window Attributes</a></h3><a name="4.1.4"></a><br />
1455 <br />
1456 Window attributes are stored in the $(HOME)/GNUstep/Defaults/WMWindowAttributes file.<br />
1457 <br />
1458 The contents of this file is a dictionary of attribute dictionaries keyed by window names. Like this:<br />
1459 <br />
1460 <pre>
1461 <font face="Courier New, Courier">
1463 "*" = {
1464 Icon = "defaultAppIcon.xpm";
1466 "xterm.XTerm" = {
1467 Icon = "xterm.xpm";
1469 xconsole = {
1470 Omnipresent = YES;
1471 NoTitlebar = YES;
1472 KeepOnTop = NO;
1475 </font>
1476 </pre>Window names are in the form<sup>1</sup>:<br />
1477 <br />
1478 &lt;window instance name&gt;.&lt;window class name&gt;<br />
1479 <br />
1480 OR<br />
1481 <br />
1482 &lt;window instance name&gt;<br />
1483 <br />
1484 OR<br />
1485 <br />
1486 &lt;window class name&gt;<br />
1487 <br />
1488 <br />
1489 Placing an asterisk as the window name means that the values set for that key are to be used as default values for all
1490 windows. So, since xconsole does not specify an Icon attribute, it will use the default value, which in the above
1491 example is defaultAppIcon.xpm.<br />
1492 <br />
1493 <hr />
1494 <font size="-1"><sup>1</sup> You can get the values for these information by running the <font face=
1495 "Courier New, Courier">xprop</font> utility on the desired window. When you do that, it will show the following line,
1496 among other things:<br />
1497 <br />
1498 <font face="Courier New, Courier">WM_CLASS(STRING) = "xterm", "XTerm"</font><br />
1499 <br />
1500 The first string (xterm) is the window instance name and the second (XTerm) the window class name.}</font>
1501 <hr />
1503 <h3><b>Options:</b></h3><br />
1504 <br />
1505 The default is NO for all options<br />
1506 <br />
1507 <br />
1509 <center>
1510 <table border="0" width="95%" cellspacing="0" cellpadding="5">
1511 <tbody>
1512 <tr>
1513 <th align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Option</font></th>
1515 <th align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Value</font></th>
1517 <th align="leftt" valign="top"><font face="Times New Roman, Times, Times Roman">Description</font></th>
1518 </tr>
1520 <tr>
1521 <td align="left" valign="top"><font face="Courier New, Courier">Icon</font></td>
1523 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">pixmap file name</font></td>
1525 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Assigns a pixmap image to be
1526 used as the icon for that window.</font></td>
1527 </tr>
1529 <tr>
1530 <td align="left" valign="top"><font face="Courier New, Courier">NoTitleBar</font></td>
1532 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">boolean</font></td>
1534 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Disables the titlebar in the
1535 window.</font></td>
1536 </tr>
1538 <tr>
1539 <td align="left" valign="top"><font face="Courier New, Courier">NoResizeBar</font></td>
1541 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">boolean</font></td>
1543 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Disables the resizebar in the
1544 window.</font></td>
1545 </tr>
1547 <tr>
1548 <td align="left" valign="top"><font face="Courier New, Courier">NoMiniaturizeButton</font></td>
1550 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">boolean</font></td>
1552 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Remove the miniaturize
1553 button.</font></td>
1554 </tr>
1556 <tr>
1557 <td align="left" valign="top"><font face="Courier New, Courier">NoCloseButton</font></td>
1559 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">boolean</font></td>
1561 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Remove the close
1562 button.</font></td>
1563 </tr>
1565 <tr>
1566 <td align="left" valign="top"><font face="Courier New, Courier">NoHideOthers</font></td>
1568 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">boolean</font></td>
1570 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Do not hide the window, or the
1571 application to which the window belongs when a <i>Hide Others</i> command is issued.</font></td>
1572 </tr>
1574 <tr>
1575 <td align="left" valign="top"><font face="Courier New, Courier">NoMouseBindings</font></td>
1577 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">boolean</font></td>
1579 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Do not grab mouse buttons in
1580 that window. This means that actions like a Meta-click on the window will be caught by the application instead
1581 of WindowMaker.</font></td>
1582 </tr>
1584 <tr>
1585 <td align="left" valign="top"><font face="Courier New, Courier">NoKeyBindings</font></td>
1587 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">boolean</font></td>
1589 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Do not grab keys in that window.
1590 This means that keystrokes that would normally be intercepted by WindowMaker (because they are bound to some
1591 action), like Meta+Up, will be passed to the application.</font></td>
1592 </tr>
1594 <tr>
1595 <td align="left" valign="top"><font face="Courier New, Courier">NoAppIcon</font></td>
1597 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">boolean</font></td>
1599 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Do not create application icon
1600 for the window. This is useful for some applications that incorrectly get more than one application
1601 icon.</font></td>
1602 </tr>
1604 <tr>
1605 <td align="left" valign="top"><font face="Courier New, Courier">KeepOnTop</font></td>
1607 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">boolean</font></td>
1609 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Always keep the window over
1610 other normal windows.</font></td>
1611 </tr>
1613 <tr>
1614 <td align="left" valign="top"><font face="Courier New, Courier">Omnipresent</font></td>
1616 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">boolean</font></td>
1618 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Make the window be present in
1619 all workspaces, AKA sticky window.</font></td>
1620 </tr>
1622 <tr>
1623 <td align="left" valign="top"><font face="Courier New, Courier">SkipWindowList</font></td>
1625 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">boolean</font></td>
1627 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Do not list the window in the
1628 <a href="chap3.php#3.12">window list menu</a>.</font></td>
1629 </tr>
1631 <tr>
1632 <td align="left" valign="top"><font face="Courier New, Courier">KeepInsideScreen</font></td>
1634 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">boolean</font></td>
1636 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Always keep the window inside
1637 the visible are of the screen.</font></td>
1638 </tr>
1640 <tr>
1641 <td align="left" valign="top"><font face="Courier New, Courier">Unfocusable</font></td>
1643 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">boolean</font></td>
1645 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Do not let the window be
1646 focused.</font></td>
1647 </tr>
1649 <tr>
1650 <td align="left" valign="top"><font face="Courier New, Courier">StartWorkspace</font></td>
1652 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Workspace number or
1653 name</font></td>
1655 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Make the window always be
1656 initially shown in the indicated workspace.</font></td>
1657 </tr>
1658 </tbody>
1659 </table>
1660 </center><br />
1661 <br />
1662 <a name="4.1.5"></a>
1664 <h3><a name="4.1.5">4.1.5 Applications Menu</a></h3><a name="4.1.5"></a> The applications menu (AKA: Root Menu) can be
1665 defined in one of two distinct ways:<br />
1666 <br />
1668 <ul type="disk">
1669 <li>In the form of an array in property list format, in $(HOME)/GNUstep/Defaults/WMRootMenu</li>
1671 <li>In the form of a text file, whose location is present in $(HOME)/GNUstep/Defaults/WMRootMenu</li>
1672 </ul><br />
1673 <br />
1674 <br />
1675 </td>
1676 </tr>
1677 </table>
1679 <?php include("footer.php"); ?>
1681 </body>
1682 </html>