Click on titlebar goes to index.php
[whome.git] / chap4.php
blob8acceb9951b3a0df0595a5c1ac8bbcb20f03b7f2
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
12 include("header.php");
13 include("dock.php");
16 <div id="inhalt">
17 <table width="880" border="0" cellpadding="1" cellspacing="1">
18 <tr>
19 <td content="content" colspan="2" valign="top">
20 <br />
21 <br />
22 <br />
24 <h2>Chapter 4</h2>
26 <h1>Configuring Window Maker</h1><br />
27 <br />
28 <a name="4.1"></a>
30 <h2><a name="4.1">4.1 The Defaults System</a></h2><a name="4.1"></a><br />
31 WindowMaker uses a defaults database for storing various information, like configurations and other data that must be
32 kept between sessions (like the list of applications of a saved session). The defaults database is stored as
33 <i>property lists</i> in the $(HOME)/GNUstep/Defaults directory. Each file in the $(HOME)/GNUstep/Defaults directory
34 contains data that belongs to a specific <i>domain</i>.<br />
35 <br />
36 Any application can use the defaults database to store its information. Generally an application will have one or more
37 <i>domains</i> that belong to it.<br />
38 <br />
39 <br />
40 <a name="4.1.1"></a>
42 <h3><a name="4.1.1">4.1.1 Property list File Format</a></h3><a name="4.1.1"></a><br />
43 <br />
44 The syntax of the property list is simple, but, if you need to change it manually you must take care not to leave any
45 syntax errors.<br />
46 <br />
47 The EBNF for the property list is the following:<br />
48 <br />
50 <h3><b>Description of the syntax of a property list in the Bacchus Naur Form (BNF)</b></h3>
52 <center>
53 <table border="1" width="80%" cellspacing="0" cellpadding="5">
54 <tbody>
55 <tr>
56 <td align="center" valign="middle">
57 <table border="0" width="100%" cellspacing="0" cellpadding="5">
58 <tbody>
59 <tr>
60 <td align="left" valign="top"><font face=
61 "Times New Roman, Times, Times Roman">&lt;object&gt;</font></td>
63 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">::=</font></td>
65 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">&lt;string&gt; |
66 &lt;data&gt; | &lt;array&gt; | &lt;dictionary&gt;</font></td>
67 </tr>
69 <tr>
70 <td align="left" valign="top"><font face=
71 "Times New Roman, Times, Times Roman">&lt;string&gt;</font></td>
73 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">::=</font></td>
75 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">text with
76 <i>non-alphanumeric characters</i> | alphanumeric text</font></td>
77 </tr>
79 <tr>
80 <td align="left" valign="top"><font face=
81 "Times New Roman, Times, Times Roman">&lt;array&gt;</font></td>
83 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">::=</font></td>
85 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">`(' [ &lt;object&gt; {
86 `,' &lt;object&gt; }* ] `)'</font></td>
87 </tr>
89 <tr>
90 <td align="left" valign="top"><font face=
91 "Times New Roman, Times, Times Roman">&lt;dictionary&gt;</font></td>
93 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">::=</font></td>
95 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">`{' [
96 &lt;keyval_pair&gt; { `,' &lt;keyval_pair&gt; }* ] `}'</font></td>
97 </tr>
99 <tr>
100 <td align="left" valign="top"><font face=
101 "Times New Roman, Times, Times Roman">&lt;keyval_pair&gt;</font></td>
103 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">::=</font></td>
105 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">&lt;string&gt; `='
106 &lt;object&gt; `;'</font></td>
107 </tr>
108 </tbody>
109 </table>
110 </td>
111 </tr>
112 </tbody>
113 </table>
114 </center><br />
115 <br />
117 <h3><b>Example property list file</b></h3>
118 <pre>
119 <font face="Courier New, Courier"> {
120 "*" = {
121 Icon = "defaultAppIcon.xpm";
123 "xterm.XTerm" = {
124 Icon = "xterm.xpm";
126 xconsole = {
127 Omnipresent = YES;
128 NoTitlebar = YES;
129 KeepOnTop = NO;
132 </font>
133 </pre>The property list above is a dictionary with 3 dictionaries inside. The first is keyed by ``*'', the second by
134 ``XTerm.xterm'' and the last by ``xconsole''.<br />
135 <br />
136 Note that all strings that have non-alphabetic or numeric characters (like a dot ``.'' or the asterisk ``*'' are
137 enclosed by double quotes. Strings with only alphanumeric characters may or may not be enclosed in double quotes, as
138 they will not make any difference.<br />
139 <br />
140 Here is another example:<br />
141 <br />
142 <pre>
143 <font face="Courier New, Courier">{
144 FTitleBack = ( hgradient, gray, "#112233" );
146 </font>
147 </pre><br />
148 <br />
149 The property list in the example above contains an array with 3 elements with a key named ``FTitleBack''.<br />
150 <br />
151 Except for cases like file names and paths, all value strings are case insensitive, i.e.: YES = Yes = yes = yEs<br />
152 <br />
153 <a name="Value Types"></a>
155 <h3><a name="Value Types">4.1.2 Value Types</a></h3><a name="Value Types"></a><br />
156 Here is a description of some of the types of values that an option might have:<br />
157 <br />
159 <center>
160 <table border="0" width="80%" cellspacing="0" cellpadding="0">
161 <tbody>
162 <tr>
163 <th align="left"><font face="Times New Roman, Times, Times Roman">Type</font></th>
165 <th align="left"><font face="Times New Roman, Times, Times Roman">Value</font></th>
166 </tr>
168 <tr>
169 <td colspan="2">
170 <hr />
171 </td>
172 </tr>
174 <tr>
175 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">boolean</font></td>
177 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">YES or NO</font></td>
178 </tr>
180 <tr>
181 <td colspan="2">
182 <hr />
183 </td>
184 </tr>
186 <tr>
187 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">integer</font></td>
189 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">any integer number, usually
190 limited by a range that will be indicated</font></td>
191 </tr>
193 <tr>
194 <td colspan="2">
195 <hr />
196 </td>
197 </tr>
199 <tr>
200 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">positive integer</font></td>
202 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">any integer number greater than
203 or equal to zero (0)</font></td>
204 </tr>
206 <tr>
207 <td colspan="2">
208 <hr />
209 </td>
210 </tr>
212 <tr>
213 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">speed</font></td>
215 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">UltraFast, Fast, Medium, Slow,
216 or VerySlow</font></td>
217 </tr>
219 <tr>
220 <td colspan="2">
221 <hr />
222 </td>
223 </tr>
225 <tr>
226 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">mouse button</font></td>
228 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Left, Middle, Right, Button1,
229 Button2, Button3, Button4, or Button5</font></td>
230 </tr>
232 <tr>
233 <td colspan="2">
234 <hr />
235 </td>
236 </tr>
237 </tbody>
238 </table>
239 </center><br />
240 <br />
241 <br />
242 <a name="4.1.3"></a>
244 <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
245 <i>WindowMaker</i> domain; i.e. the $(HOME)/GNUstep/Defaults/WindowMaker file.<br />
246 <br />
247 Changes in preference options will automatically affect the current WindowMaker session, without a restart. Some
248 options, however, require a restart of WindowMaker before they take effect. Such options are marked with a * .<br />
249 <br />
250 Note that values marked as <i>Default</i> are values that are assumed if the option is not specified, instead of
251 <i>factory default</i> values that are set in the preference file.<br />
252 <br />
254 <center>
255 <table border="0" width="95%" cellspacing="0" cellpadding="5">
256 <tbody>
257 <tr>
258 <th align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Option</font></th>
260 <th align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Value</font></th>
262 <th align="leftt" valign="top"><font face="Times New Roman, Times, Times Roman">Description</font></th>
263 </tr>
265 <tr>
266 <td align="left" valign="top"><font face="Courier New, Courier">PixmapPath</font></td>
268 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">list of directories separated by
269 ":" (default: depends on the system)</font></td>
271 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">A list of directories where
272 pixmaps can be found. The pixmaps for things like icons, are searched in these paths in order of
273 appearance.</font></td>
274 </tr>
276 <tr>
277 <td align="left" valign="top"><font face="Courier New, Courier">*NoDithering</font></td>
279 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">boolean (default:
280 NO)</font></td>
282 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Disable internal dithering of
283 images. Not recommended for displays with less than 8 bits per pixel.</font></td>
284 </tr>
286 <tr>
287 <td align="left" valign="top"><font face="Courier New, Courier">*ColormapSize</font></td>
289 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">integer number &gt; 1 (default:
290 4)</font></td>
292 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Number of colors for each of the
293 red, green and blue components to be used for the dithering colormap. This value must be greater than 1 and
294 smaller than 6 for 8bpp displays. It only makes sense on PseudoColor displays. This option has not effect on
295 TrueColor displays. Larger values result in better appearance, but leaves less colors for other
296 applications.</font></td>
297 </tr>
299 <tr>
300 <td align="left" valign="top"><font face="Courier New, Courier">*ModifierKey</font></td>
302 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">modifier key name (default:
303 Mod1)</font></td>
305 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">The key to use as the modifier
306 being referred as Meta in this manual, like Meta dragging a window to move it. Valid values are Alt, Meta,
307 Super, Hyper, Mod1, Mod2, Mod3, Mod4, Mod5.</font></td>
308 </tr>
310 <tr>
311 <td align="left" valign="top"><font face="Courier New, Courier">UseSaveUnders</font></td>
313 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">boolean (default:
314 NO)</font></td>
316 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Use <i>saveunders</i> in
317 WindowMaker windows. This can improve performance but increases memory usage. It also can cause problems with
318 refreshing in some applications.</font></td>
319 </tr>
321 <tr>
322 <td align="left" valign="top"><font face="Courier New, Courier">DisableClip</font></td>
324 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">boolean (default:
325 NO)</font></td>
327 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Will remove the application Clip
328 from the workspace.</font></td>
329 </tr>
331 <tr>
332 <td align="left" valign="top"><font face="Courier New, Courier">DisableDock</font></td>
334 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">boolean (default:
335 NO)</font></td>
337 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Will remove the application Dock
338 from the workspace</font></td>
339 </tr>
341 <tr>
342 <td align="left" valign="top"><font face="Courier New, Courier">Superfluous</font></td>
344 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">boolean (default:
345 NO)</font></td>
347 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Enable extra animations and
348 other cosmetic things that might increase peak memory and CPU usage.</font></td>
349 </tr>
351 <tr>
352 <td align="left" valign="top"><font face="Courier New, Courier">SaveSessionOnExit</font></td>
354 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">boolean (default:
355 NO)</font></td>
357 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Automatically save the state of
358 the session when exiting WindowMaker.</font></td>
359 </tr>
361 <tr>
362 <td align="left" valign="top"><font face="Courier New, Courier">*IconSize</font></td>
364 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">integer &gt; 4 (default:
365 64)</font></td>
367 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">The size of application icons
368 and miniwindows.</font></td>
369 </tr>
371 <tr>
372 <td align="left" valign="top"><font face="Courier New, Courier">OpaqueMove</font></td>
374 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">boolean (default:
375 NO)</font></td>
377 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Whether the whole window should
378 be moved while dragging it, or, if only it's frame should be dragged.</font></td>
379 </tr>
381 <tr>
382 <td align="left" valign="top"><font face="Courier New, Courier">FocusMode</font></td>
384 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Manual or CickToFocus, Auto or
385 FocusFollowsMouse, SemiAuto or Sloppy (default: ClickToFocus)</font></td>
387 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">The mode of input focus setting.
388 Refer to section <a href="chap2.php#2.2.1">2.2.1, Focusing a
389 Window</a></font></td>
390 </tr>
392 <tr>
393 <td align="left" valign="top"><font face="Courier New, Courier">IgnoreFocusClick</font></td>
395 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">boolean (default:
396 NO)</font></td>
398 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Whether the mouse click use to
399 focus a window should be ignore or treated normally.</font></td>
400 </tr>
402 <tr>
403 <td align="left" valign="top"><font face="Courier New, Courier">AutoFocus</font></td>
405 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">boolean (default:
406 NO)</font></td>
408 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Whether newly created windows
409 should receive input focus. Do not confuse with FocusMode=Auto.</font></td>
410 </tr>
412 <tr>
413 <td align="left" valign="top"><font face="Courier New, Courier">RaiseDelay</font></td>
415 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">integer number (default:
416 0)</font></td>
418 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">How many tenths of a second to
419 wait before raising a window in Auto or Semi-Auto focus mode. 0 disables this feature.</font></td>
420 </tr>
422 <tr>
423 <td align="left" valign="top"><font face="Courier New, Courier">DoubleClickTime</font></td>
425 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">integer number (default:
426 250)</font></td>
428 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">If two mouse clicks occur in
429 this interval of time, it will be considered a double click.</font></td>
430 </tr>
432 <tr>
433 <td align="left" valign="top"><font face="Courier New, Courier">ColorMapMode</font></td>
435 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Manual or ClickToFocus, Auto or
436 FocusFollowsMouse (default: auto)</font></td>
438 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">The mode of colormap setting. In
439 <i>Manual</i> or <i>ClickToFocus</i> mode, the colormap is set to the one belonging to the current focused
440 window. In <i>Auto</i> or <i>FocusFollowsMouse</i> mode, the colormap is set to the one belonging to the window
441 under the pointer.</font></td>
442 </tr>
444 <tr>
445 <td align="left" valign="top"><font face="Courier New, Courier">CirculateRaise</font></td>
447 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">boolean (default:
448 NO)</font></td>
450 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Whether the window should be
451 raised when circulating. (focus the next or previous window through the keyboard)</font></td>
452 </tr>
454 <tr>
455 <td align="left" valign="top"><font face="Courier New, Courier">OnTopTransients</font></td>
457 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">boolean (default:
458 NO)</font></td>
460 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Whether transient windows should
461 always be placed over their owners</font></td>
462 </tr>
464 <tr>
465 <td align="left" valign="top"><font face="Courier New, Courier">WindowPlacement</font></td>
467 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">auto, cascade, manual, or random
468 (default: cascade)</font></td>
470 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Sets placement mode for new
471 windows. <i>Auto</i> places the window automatically in the first open space found in the workspace.
472 <i>Cascade</i> places the window in incrementing positions starting from the the top-left corner of the
473 workspace. <i>Manual</i> allows you to place the window interactively with the mouse. <i>Random</i> paces the
474 window randomly in the workspace.</font></td>
475 </tr>
477 <tr>
478 <td align="left" valign="top"><font face="Courier New, Courier">WindowPlaceOrigin</font></td>
480 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">(X,Y) where X and Y are integer
481 numbers (default: (0,0))</font></td>
483 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Sets the offset, from the
484 top-left corner of the screen, to place windows. In non-manual WindowPlacement modes windows will not be placed
485 above or to the left of this point.</font></td>
486 </tr>
488 <tr>
489 <td align="left" valign="top"><font face="Courier New, Courier">AutoArrangeIcons</font></td>
491 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">boolean (default:
492 NO)</font></td>
494 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Whether icons should be
495 automatically arranged</font></td>
496 </tr>
498 <tr>
499 <td align="left" valign="top"><font face="Courier New, Courier">ResizeDisplay</font></td>
501 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">center, corner, floating, or
502 line (default: corner)</font></td>
504 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Selects the type or position of
505 the box that shows the window size when a window is being resized. <i>center</i> places the box in the center
506 of the workspace, <i>corner</i> places it in the top-left corner of the workspace, <i>floating</i> places it in
507 the center of the window being resized and <i>line</i> draws the current window size over the workspace, like
508 in a technical drawing.</font></td>
509 </tr>
511 <tr>
512 <td align="left" valign="top"><font face="Courier New, Courier">MoveDisplay</font></td>
514 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">center, corner or floating
515 (default: corner)</font></td>
517 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Selects the type or position of
518 the box that shows the window position when a window is being moved. The value meanings are the same as for the
519 ResizeDisplay option.</font></td>
520 </tr>
522 <tr>
523 <td align="left" valign="top"><font face="Courier New, Courier">AlignSubmenus</font></td>
525 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">boolean (default:
526 NO)</font></td>
528 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Whether submenus should be
529 aligned vertically with their parent menus.</font></td>
530 </tr>
532 <tr>
533 <td align="left" valign="top"><font face="Courier New, Courier">WrapMenus</font></td>
535 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">boolean (default:
536 NO)</font></td>
538 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Whether submenus should be
539 placed to the right of their parent menus when they don't fit the screen. Note that menus placed off the screen
540 can be scrolled.</font></td>
541 </tr>
543 <tr>
544 <td align="left" valign="top"><font face="Courier New, Courier">ScrollableMenus</font></td>
546 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">boolean (default:
547 NO)</font></td>
549 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Whether menus that are not fully
550 inside the screen should automatically scroll when the pointer is over them and near the border of the
551 screen.</font></td>
552 </tr>
554 <tr>
555 <td align="left" valign="top"><font face="Courier New, Courier">MenuScrollSpeed</font></td>
557 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">speed (default:
558 medium)</font></td>
560 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">The scrolling speed of
561 menus.</font></td>
562 </tr>
564 <tr>
565 <td align="left" valign="top"><font face="Courier New, Courier">DontLinkWorkspaces</font></td>
567 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">boolean (default:
568 NO)</font></td>
570 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Do not automatically switch to
571 the next or previous workspace when a window is dragged to the edge of the screen.</font></td>
572 </tr>
574 <tr>
575 <td align="left" valign="top"><font face="Courier New, Courier">NoWindowUnderDock</font></td>
577 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">boolean (default:
578 NO)</font></td>
580 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">When maximizing windows, limit
581 their sizes so that they will not be covered by the dock.</font></td>
582 </tr>
584 <tr>
585 <td align="left" valign="top"><font face="Courier New, Courier">NoWindowOverIcons</font></td>
587 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">boolean (default:
588 NO)</font></td>
590 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">When maximizing windows, limit
591 their sizes so that they will cover miniwindows and application icons.</font></td>
592 </tr>
594 <tr>
595 <td align="left" valign="top"><font face="Courier New, Courier">StickyIcons</font></td>
597 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">boolean (default:
598 NO)</font></td>
600 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Whether miniwindows should be
601 present in all workspaces.</font></td>
602 </tr>
604 <tr>
605 <td align="left" valign="top"><font face="Courier New, Courier">CycleWorkspaces</font></td>
607 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">boolean (default:
608 NO)</font></td>
610 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Set to YES if you want windows
611 that are dragged past the last workspace to be moved to the first workspace, and vice-versa.</font></td>
612 </tr>
614 <tr>
615 <td align="left" valign="top"><font face="Courier New, Courier">AdvanceToNewWorkspace</font></td>
617 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">boolean (default:
618 NO)</font></td>
620 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Whether windows dragged past the
621 last workspace should create a new workspace.</font></td>
622 </tr>
624 <tr>
625 <td align="left" valign="top"><font face="Courier New, Courier">DisableAnimations</font></td>
627 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">boolean (default:
628 NO)</font></td>
630 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Whether animations, like the one
631 done during minimization, should be disabled.</font></td>
632 </tr>
634 <tr>
635 <td align="left" valign="top"><font face="Courier New, Courier">IconSlideSpeed</font></td>
637 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">speed (default:
638 medium)</font></td>
640 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">The speed of icons when they are
641 being slid across the workspace.</font></td>
642 </tr>
644 <tr>
645 <td align="left" valign="top"><font face="Courier New, Courier">ShadeSpeed</font></td>
647 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">speed (default:
648 medium)</font></td>
650 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">The speed of the shading
651 animation.</font></td>
652 </tr>
654 <tr>
655 <td align="left" valign="top"><font face="Courier New, Courier">DisableSound</font></td>
657 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">boolean (default:
658 NO)</font></td>
660 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Whether sound support in
661 WindowMaker should be disabled</font></td>
662 </tr>
664 <tr>
665 <td align="left" valign="top"><font face="Courier New, Courier">*DisableWSMouseActions</font></td>
667 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">boolean (default:
668 NO)</font></td>
670 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Whether actions in the workspace
671 triggered by mouse-clicks should be disabled. This allows the use of file and desktop managers that place icons
672 on the root window (such as KDE).</font></td>
673 </tr>
675 <tr>
676 <td align="left" valign="top"><font face="Courier New, Courier">SelectWindowMouseButton</font></td>
678 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">mouse button (default:
679 left)</font></td>
681 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">The mouse button that activates
682 selection of multiple windows in the workspace.</font></td>
683 </tr>
685 <tr>
686 <td align="left" valign="top"><font face="Courier New, Courier">WindowListMouseButton</font></td>
688 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">mouse button (default:
689 middle)</font></td>
691 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">The mouse button that opens the
692 window list menu in the workspace.</font></td>
693 </tr>
695 <tr>
696 <td align="left" valign="top"><font face="Courier New, Courier">ApplicationMenuMouseButton</font></td>
698 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">mouse button (default:
699 right)</font></td>
701 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">The mouse button that opens the
702 applications menu in the workspace.</font></td>
703 </tr>
704 </tbody>
705 </table>
706 </center><br />
707 <br />
709 <h3><b>Appearance Options</b></h3><br />
710 Fonts are specified in the X Logical Font Description format. You can cut and paste these names from programs like
711 <font face="Courier New, Courier">xfontsel</font>.<br />
712 <br />
713 Colors are specified as color names in the standard X format. This can be any color name shown by the <font face=
714 "Courier New, Courier">showrgb</font> program (like black, white or gray) or a color value in the #rrggbb format, where
715 rr, gg and bb is the intensity of the color component (like #ff0000 for pure red or #000080 for medium blue). Note that
716 color names in the #rrggbb format must be enclosed with double quotes.<br />
717 <br />
718 Textures are specified as an array, where the first element specifies the texture type followed by a variable number of
719 arguments.<br />
720 <br />
721 Valid texture types are:<br />
722 <br />
724 <center>
725 <table border="0" width="90%" cellspacing="0" cellpadding="5">
726 <tbody>
727 <tr>
728 <th align="right" valign="top"><font face="Times New Roman, Times, Times Roman">(solid, color)</font></th>
730 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">the texture is a simple solid
731 color.</font></td>
732 </tr>
734 <tr>
735 <th align="right" valign="top"><font face="Times New Roman, Times, Times Roman">(dgradient, color1,
736 color2)</font></th>
738 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">the texture is a diagonal
739 gradient rendered from the top-left corner to the bottom-right corner. The first argument (color1) is the color
740 for the top-left corner and the second (color2) is for the bottom-right corner.</font></td>
741 </tr>
743 <tr>
744 <th align="right" valign="top"><font face="Times New Roman, Times, Times Roman">(hgradient, color1,
745 color2)</font></th>
747 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">the texture is a horizontal
748 gradient rendered from the left edge to the right edge. The first argument (color1) is the color for the left
749 edge and the second (color2) is for the right edge.</font></td>
750 </tr>
752 <tr>
753 <th align="right" valign="top"><font face="Times New Roman, Times, Times Roman">(vgradient, color1,
754 color2)</font></th>
756 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">the texture is a vertical
757 gradient rendered from the top edge to the bottom edge. The first argument (color1) is the color for the top
758 edge and the second (color2) is for the bottom edge.</font></td>
759 </tr>
761 <tr>
762 <th align="right" valign="top"><font face="Times New Roman, Times, Times Roman">(mdgradient, color1,
763 color2,...,color<i>n</i>)</font></th>
765 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">this is equivalent to drgadient,
766 but you can specify more than two colors</font></td>
767 </tr>
769 <tr>
770 <th align="right" valign="top"><font face="Times New Roman, Times, Times Roman">(mhgradient, color1,
771 color2,...,color<i>n</i>)</font></th>
773 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">this is equivalent to hrgadient,
774 but you can specify more than two colors</font></td>
775 </tr>
777 <tr>
778 <th align="right" valign="top"><font face="Times New Roman, Times, Times Roman">(mvgradient, color1,
779 color2,...,color<i>n</i>)</font></th>
781 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">this is equivalent to vrgadient,
782 but you can specify more than two colors</font></td>
783 </tr>
784 </tbody>
785 </table>
786 </center><br />
787 <br />
788 <b>Examples:</b>
790 <center>
791 <table border="0" width="80%" cellspacing="0" cellpadding="5">
792 <tbody>
793 <tr>
794 <td align="center" valign="middle"><img src="guide/images/texsolid.gif" border="0" width="151" height="21" alt=
795 "[Solid Color]" /></td>
797 <th align="left" valign="top"><font face="Times New Roman, Times, Times Roman">(solid, gray)</font></th>
798 </tr>
800 <tr>
801 <td align="center" valign="middle"><img src="guide/images/texdgrad.gif" border="0" width="151" height="21" alt=
802 "[Diagoonal Gradient]" /></td>
804 <th align="left" valign="top"><font face="Times New Roman, Times, Times Roman">(dgradient, gray80,
805 gray20)</font></th>
806 </tr>
808 <tr>
809 <td align="center" valign="middle"><img src="guide/images/texhgrad.gif" border="0" width="151" height="21" alt=
810 "[Horizontal Gradient]" /></td>
812 <th align="left" valign="top"><font face="Times New Roman, Times, Times Roman">(hgradient, gray80,
813 gray20)</font></th>
814 </tr>
816 <tr>
817 <td align="center" valign="middle"><img src="guide/images/texvgrad.gif" border="0" width="151" height="21" alt=
818 "[Vertical Gradient]" /></td>
820 <th align="left" valign="top"><font face="Times New Roman, Times, Times Roman">(vgradient, gray80,
821 gray20)</font></th>
822 </tr>
823 </tbody>
824 </table>
825 </center><br />
826 <br />
827 <br />
828 <br />
830 <center>
831 <table border="0" width="95%" cellspacing="0" cellpadding="5">
832 <tbody>
833 <tr>
834 <th align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Option</font></th>
836 <th align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Value</font></th>
838 <th align="leftt" valign="top"><font face="Times New Roman, Times, Times Roman">Description</font></th>
839 </tr>
841 <tr>
842 <td align="left" valign="top"><font face="Courier New, Courier">*NewStyle</font></td>
844 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">boolean (default:
845 NO)</font></td>
847 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Selects between N*XTSTEP style
848 buttons in the titlebar and a newer style of buttons.</font></td>
849 </tr>
851 <tr>
852 <td align="left" valign="top"><font face="Courier New, Courier">WidgetColor</font></td>
854 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">(solid, color) where color is a
855 color name (default: (solid, grey))</font></td>
857 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Chooses the color to be used in
858 titlebar buttons if NewStyle=No;</font></td>
859 </tr>
861 <tr>
862 <td align="left" valign="top"><font face="Courier New, Courier">WorkspaceBack</font></td>
864 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">a texture or none (default:
865 none)</font></td>
867 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Default texture for the
868 workspace background. Note the <i>dgradient</i> and <i>mdgradient</i> textures can take a lot of time to be
869 rendered.</font></td>
870 </tr>
872 <tr>
873 <td align="left" valign="top"><font face="Courier New, Courier">IconBack</font></td>
875 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">texture (default: (solid,
876 grey))</font></td>
878 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Texture for the background of
879 icons and miniwindows.</font></td>
880 </tr>
882 <tr>
883 <td align="left" valign="top"><font face="Courier New, Courier">FTitleBack</font></td>
885 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">texture (default: (solid,
886 black))</font></td>
888 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Texture for the focused window
889 titlebar.</font></td>
890 </tr>
892 <tr>
893 <td align="left" valign="top"><font face="Courier New, Courier">PTitleBack</font></td>
895 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">texture (default: (solid,
896 "#616161"))</font></td>
898 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Texture for the titlebar of the
899 parent window of the currently focused transient window</font></td>
900 </tr>
902 <tr>
903 <td align="left" valign="top"><font face="Courier New, Courier">UTitleBack</font></td>
905 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">texture (default: (solid,
906 gray))</font></td>
908 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Texture for unfocused window
909 titlebars.</font></td>
910 </tr>
912 <tr>
913 <td align="left" valign="top"><font face="Courier New, Courier">MenuTitleBack</font></td>
915 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">texture (default: (solid,
916 black))</font></td>
918 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Texture for menu
919 titlebars.</font></td>
920 </tr>
922 <tr>
923 <td align="left" valign="top"><font face="Courier New, Courier">MenuTextBack</font></td>
925 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">texture (default: (solid,
926 gray))</font></td>
928 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Texture for menu
929 items</font></td>
930 </tr>
932 <tr>
933 <td align="left" valign="top"><font face="Courier New, Courier">FTitleColor</font></td>
935 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">color (default:
936 white)</font></td>
938 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">The color of the text in the
939 focused window titlebar.</font></td>
940 </tr>
942 <tr>
943 <td align="left" valign="top"><font face="Courier New, Courier">PTitleColor</font></td>
945 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">color (default:
946 white)</font></td>
948 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Color for the text in the
949 titlebar of the parent window of the currently focused transient.</font></td>
950 </tr>
952 <tr>
953 <td align="left" valign="top"><font face="Courier New, Courier">UTitleColor</font></td>
955 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">color (default:
956 black)</font></td>
958 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">The color for the text in the
959 titlebar of unfocused windows.</font></td>
960 </tr>
962 <tr>
963 <td align="left" valign="top"><font face="Courier New, Courier">MenuTitleColor</font></td>
965 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">color (default:
966 white)</font></td>
968 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Color for the text in menu
969 titlebars</font></td>
970 </tr>
972 <tr>
973 <td align="left" valign="top"><font face="Courier New, Courier">MenuTextColor</font></td>
975 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">color (default:
976 black)</font></td>
978 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Color for the text in menu
979 items</font></td>
980 </tr>
982 <tr>
983 <td align="left" valign="top"><font face="Courier New, Courier">HighlightColor</font></td>
985 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">color (default:
986 white)</font></td>
988 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Color for the highlighted item
989 in menus.</font></td>
990 </tr>
992 <tr>
993 <td align="left" valign="top"><font face="Courier New, Courier">HighlightTextColor</font></td>
995 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">color (default:
996 black)</font></td>
998 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Color for the highlighted item
999 text in menus.</font></td>
1000 </tr>
1002 <tr>
1003 <td align="left" valign="top"><font face="Courier New, Courier">MenuDisabledColor</font></td>
1005 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">color (default:
1006 "#616161")</font></td>
1008 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Color for the text of disabled
1009 menu items.</font></td>
1010 </tr>
1012 <tr>
1013 <td align="left" valign="top"><font face="Courier New, Courier">ClipTitleColor</font></td>
1015 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">color (default:
1016 black)</font></td>
1018 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Color for the text in the
1019 clip.</font></td>
1020 </tr>
1022 <tr>
1023 <td align="left" valign="top"><font face="Courier New, Courier">CClipTitleColor</font></td>
1025 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">color (default:
1026 "#454045")</font></td>
1028 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Color for the text in the
1029 collapsed clip.</font></td>
1030 </tr>
1032 <tr>
1033 <td align="left" valign="top"><font face="Courier New, Courier">WindowTitleFont</font></td>
1035 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">font (default: Helvetica bold
1036 12)</font></td>
1038 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Font for the text in window
1039 titlebars.</font></td>
1040 </tr>
1042 <tr>
1043 <td align="left" valign="top"><font face="Courier New, Courier">MenuTitleFont</font></td>
1045 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">font (default: Helvetica bold
1046 12)</font></td>
1048 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Font for the text in menu
1049 titlebars)</font></td>
1050 </tr>
1052 <tr>
1053 <td align="left" valign="top"><font face="Courier New, Courier">MenuTextFont</font></td>
1055 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">font (default: Helvetica medium
1056 12)</font></td>
1058 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Font for the text in menu
1059 items</font></td>
1060 </tr>
1062 <tr>
1063 <td align="left" valign="top"><font face="Courier New, Courier">IconTitleFont</font></td>
1065 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">font (default: Helvetica medium
1066 8)</font></td>
1068 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Font for the text in miniwindow
1069 titlebars.</font></td>
1070 </tr>
1072 <tr>
1073 <td align="left" valign="top"><font face="Courier New, Courier">ClipTitleFont</font></td>
1075 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">font (default: Helvetica bold
1076 10)</font></td>
1078 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Font for the text in the
1079 clip.</font></td>
1080 </tr>
1082 <tr>
1083 <td align="left" valign="top"><font face="Courier New, Courier">Displayfont</font></td>
1085 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">font (default: Helvetica medium
1086 12)</font></td>
1088 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Font for the text information in
1089 windows, like the size of windows during resize.</font></td>
1090 </tr>
1092 <tr>
1093 <td align="left" valign="top"><font face="Courier New, Courier">TitleJustify</font></td>
1095 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">center, left, or right (default:
1096 center)</font></td>
1098 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Justification of the text in
1099 window titlebars.</font></td>
1100 </tr>
1101 </tbody>
1102 </table>
1103 </center><br />
1104 <br />
1106 <h3><b>Keyboard Bindings</b></h3><br />
1107 <br />
1108 Keyboard shortcut specifications are in the form:<br />
1109 <br />
1110 <pre>
1111 <font face="Courier New, Courier">
1112 [&lt;modifier key names&gt; + ] &lt;key name&gt;
1113 </font>
1114 </pre><br />
1115 <br />
1116 Where <i>modifier key names</i> specify an optional modifier key, like Meta or Shift. Any number of modifier keys might
1117 be specified. The <i>key name</i> is the actual key that will trigger the action bound to the option.<br />
1118 <br />
1119 Examples:<br />
1120 <br />
1122 <table border="0" width="80%" cellspacing="0" cellpadding="5">
1123 <tbody>
1124 <tr>
1125 <th align="right">[F10]</th>
1127 <td align="left">Means the F10 key.</td>
1128 </tr>
1130 <tr>
1131 <th align="right"><font face="Times New Roman, Times, Times Roman">Meta+TAB</font></th>
1133 <td align="left"><font face="Times New Roman, Times, Times Roman">Means the TAB key with the Meta modifier key
1134 pressed at the same time.</font></td>
1135 </tr>
1137 <tr>
1138 <th align="right"><font face="Times New Roman, Times, Times Roman">Meta+Shift+TAB</font></th>
1140 <td align="left"><font face="Times New Roman, Times, Times Roman">Means the TAB key with the Meta and Shift
1141 modifier keys pressed at the same time.</font></td>
1142 </tr>
1143 </tbody>
1144 </table><br />
1145 <br />
1146 Key names can be found at /usr/X11R6/include/X11/keysymdef.h The <b>XK_</b> prefixes must be ignored (if key name is
1147 <b>XK_</b>Return use Return).<br />
1148 <br />
1150 <center>
1151 <table border="0" width="95%" cellspacing="0" cellpadding="5">
1152 <tbody>
1153 <tr>
1154 <th align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Option</font></th>
1156 <th align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Default Value</font></th>
1158 <th align="leftt" valign="top"><font face="Times New Roman, Times, Times Roman">Description</font></th>
1159 </tr>
1161 <tr>
1162 <td align="left" valign="top"><font face="Courier New, Courier">RootMenuKey</font></td>
1164 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">None</font></td>
1166 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Opens the <a href=
1167 "chap3.php#3.1.1">root window menu</a> at the current
1168 position of the mouse pointer.</font></td>
1169 </tr>
1171 <tr>
1172 <td align="left" valign="top"><font face="Courier New, Courier">WindowListKey</font></td>
1174 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">None</font></td>
1176 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Opens the <a href=
1177 "chap3.php#3.1.2">window list menu</a> menu at the current
1178 position of the mouse pointer.</font></td>
1179 </tr>
1181 <tr>
1182 <td align="left" valign="top"><font face="Courier New, Courier">WindowMenuKey</font></td>
1184 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">None</font></td>
1186 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Opens the <a href=
1187 "chap2.php#2.2.9">window commands menu</a> for the currently
1188 focused window.</font></td>
1189 </tr>
1191 <tr>
1192 <td align="left" valign="top"><font face="Courier New, Courier">MiniaturizeKey</font></td>
1194 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">None</font></td>
1196 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Miniaturizes the currently
1197 focused window.</font></td>
1198 </tr>
1200 <tr>
1201 <td align="left" valign="top"><font face="Courier New, Courier">HideKey</font></td>
1203 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">None</font></td>
1205 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Hides the currently active
1206 application.</font></td>
1207 </tr>
1209 <tr>
1210 <td align="left" valign="top"><font face="Courier New, Courier">CloseKey</font></td>
1212 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">None</font></td>
1214 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Closes the current focused
1215 window</font></td>
1216 </tr>
1218 <tr>
1219 <td align="left" valign="top"><font face="Courier New, Courier">MaximizeKey</font></td>
1221 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">None</font></td>
1223 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Maxmizes the currently focused
1224 window.</font></td>
1225 </tr>
1227 <tr>
1228 <td align="left" valign="top"><font face="Courier New, Courier">VMaximizeKey</font></td>
1230 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">None</font></td>
1232 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Vertically Maximizes the
1233 currently focused window.</font></td>
1234 </tr>
1236 <tr>
1237 <td align="left" valign="top"><font face="Courier New, Courier">RaiseKey</font></td>
1239 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Meta+Up</font></td>
1241 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Raises the currently focused
1242 window.</font></td>
1243 </tr>
1245 <tr>
1246 <td align="left" valign="top"><font face="Courier New, Courier">LowerKey</font></td>
1248 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Meta+Down</font></td>
1250 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Lowers the currently focused
1251 window.</font></td>
1252 </tr>
1254 <tr>
1255 <td align="left" valign="top"><font face="Courier New, Courier">RaiseLowerKey</font></td>
1257 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">None</font></td>
1259 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Raises the window under the
1260 pointer, or lowers it if it is already raised.</font></td>
1261 </tr>
1263 <tr>
1264 <td align="left" valign="top"><font face="Courier New, Courier">ShadeKey</font></td>
1266 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">None</font></td>
1268 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Shades the currently focused
1269 window.</font></td>
1270 </tr>
1272 <tr>
1273 <td align="left" valign="top"><font face="Courier New, Courier">SelectKey</font></td>
1275 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">None</font></td>
1277 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Selects current focused
1278 window.</font></td>
1279 </tr>
1281 <tr>
1282 <td align="left" valign="top"><font face="Courier New, Courier">FocusNextKey</font></td>
1284 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">None</font></td>
1286 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Switch focus to next
1287 window.</font></td>
1288 </tr>
1290 <tr>
1291 <td align="left" valign="top"><font face="Courier New, Courier">FocusPrevKey</font></td>
1293 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">None</font></td>
1295 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Switch focus to previous
1296 window.</font></td>
1297 </tr>
1299 <tr>
1300 <td align="left" valign="top"><font face="Courier New, Courier">NextWorkspaceKey</font></td>
1302 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">None</font></td>
1304 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Switches to next
1305 workspace.</font></td>
1306 </tr>
1308 <tr>
1309 <td align="left" valign="top"><font face="Courier New, Courier">PrevWorkspaceKey</font></td>
1311 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">None</font></td>
1313 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Switches to previous
1314 workspace.</font></td>
1315 </tr>
1317 <tr>
1318 <td align="left" valign="top"><font face="Courier New, Courier">NextWorkspaceLayerKey</font></td>
1320 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">None</font></td>
1322 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Switches to the next group of 10
1323 workspaces.</font></td>
1324 </tr>
1326 <tr>
1327 <td align="left" valign="top"><font face="Courier New, Courier">PrevWorkspaceLayerKey</font></td>
1329 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">None</font></td>
1331 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Switches to the previous group
1332 of 10 workspaces.</font></td>
1333 </tr>
1335 <tr>
1336 <td align="left" valign="top"><font face="Courier New, Courier">Workspace1Key</font></td>
1338 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">None</font></td>
1340 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Switches to workspace
1341 1.</font></td>
1342 </tr>
1344 <tr>
1345 <td align="left" valign="top"><font face="Courier New, Courier">Workspace2Key</font></td>
1347 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">None</font></td>
1349 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Switches to workspace 2,
1350 creating it if it does not exist.</font></td>
1351 </tr>
1353 <tr>
1354 <td align="left" valign="top"><font face="Courier New, Courier">Workspace3Key</font></td>
1356 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">None</font></td>
1358 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Switches to workspace 3,
1359 creating it if it does not exist.</font></td>
1360 </tr>
1362 <tr>
1363 <td align="left" valign="top"><font face="Courier New, Courier">Workspace4Key</font></td>
1365 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">None</font></td>
1367 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Switches to workspace 4,
1368 creating it if it does not exist.</font></td>
1369 </tr>
1371 <tr>
1372 <td align="left" valign="top"><font face="Courier New, Courier">Workspace5Key</font></td>
1374 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">None</font></td>
1376 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Switches to workspace 5,
1377 creating it if it does not exist.</font></td>
1378 </tr>
1380 <tr>
1381 <td align="left" valign="top"><font face="Courier New, Courier">Workspace6Key</font></td>
1383 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">None</font></td>
1385 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Switches to workspace 6,
1386 creating it if it does not exist.</font></td>
1387 </tr>
1389 <tr>
1390 <td align="left" valign="top"><font face="Courier New, Courier">Workspace7Key</font></td>
1392 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">None</font></td>
1394 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Switches to workspace 7,
1395 creating it if it does not exist.</font></td>
1396 </tr>
1398 <tr>
1399 <td align="left" valign="top"><font face="Courier New, Courier">Workspace8Key</font></td>
1401 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">None</font></td>
1403 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Switches to workspace 8,
1404 creating it if it does not exist.</font></td>
1405 </tr>
1407 <tr>
1408 <td align="left" valign="top"><font face="Courier New, Courier">Workspace9Key</font></td>
1410 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">None</font></td>
1412 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Switches to workspace 9,
1413 creating it if it does not exist.</font></td>
1414 </tr>
1416 <tr>
1417 <td align="left" valign="top"><font face="Courier New, Courier">Workspace10Key</font></td>
1419 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">None</font></td>
1421 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Switches to workspace 10,
1422 creating it if it does not exist.</font></td>
1423 </tr>
1425 <tr>
1426 <td align="left" valign="top"><font face="Courier New, Courier">ClipLowerKey</font></td>
1428 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">None</font></td>
1430 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Lowers the clip.</font></td>
1431 </tr>
1433 <tr>
1434 <td align="left" valign="top"><font face="Courier New, Courier">ClipLowerKey</font></td>
1436 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">None</font></td>
1438 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Lowers the clip.</font></td>
1439 </tr>
1441 <tr>
1442 <td align="left" valign="top"><font face="Courier New, Courier">ClipRaiseLowerKEy</font></td>
1444 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">None</font></td>
1446 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Raises the clip, or lowers it if
1447 it is already raised.</font></td>
1448 </tr>
1449 </tbody>
1450 </table>
1451 </center><br />
1452 <br />
1453 <br />
1454 <br />
1455 <a name="4.1.4"></a>
1457 <h3><a name="4.1.4">4.1.4 Window Attributes</a></h3><a name="4.1.4"></a><br />
1458 <br />
1459 Window attributes are stored in the $(HOME)/GNUstep/Defaults/WMWindowAttributes file.<br />
1460 <br />
1461 The contents of this file is a dictionary of attribute dictionaries keyed by window names. Like this:<br />
1462 <br />
1463 <pre>
1464 <font face="Courier New, Courier">
1466 "*" = {
1467 Icon = "defaultAppIcon.xpm";
1469 "xterm.XTerm" = {
1470 Icon = "xterm.xpm";
1472 xconsole = {
1473 Omnipresent = YES;
1474 NoTitlebar = YES;
1475 KeepOnTop = NO;
1478 </font>
1479 </pre>Window names are in the form<sup>1</sup>:<br />
1480 <br />
1481 &lt;window instance name&gt;.&lt;window class name&gt;<br />
1482 <br />
1483 OR<br />
1484 <br />
1485 &lt;window instance name&gt;<br />
1486 <br />
1487 OR<br />
1488 <br />
1489 &lt;window class name&gt;<br />
1490 <br />
1491 <br />
1492 Placing an asterisk as the window name means that the values set for that key are to be used as default values for all
1493 windows. So, since xconsole does not specify an Icon attribute, it will use the default value, which in the above
1494 example is defaultAppIcon.xpm.<br />
1495 <br />
1496 <hr />
1497 <font size="-1"><sup>1</sup> You can get the values for these information by running the <font face=
1498 "Courier New, Courier">xprop</font> utility on the desired window. When you do that, it will show the following line,
1499 among other things:<br />
1500 <br />
1501 <font face="Courier New, Courier">WM_CLASS(STRING) = "xterm", "XTerm"</font><br />
1502 <br />
1503 The first string (xterm) is the window instance name and the second (XTerm) the window class name.}</font>
1504 <hr />
1506 <h3><b>Options:</b></h3><br />
1507 <br />
1508 The default is NO for all options<br />
1509 <br />
1510 <br />
1512 <center>
1513 <table border="0" width="95%" cellspacing="0" cellpadding="5">
1514 <tbody>
1515 <tr>
1516 <th align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Option</font></th>
1518 <th align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Value</font></th>
1520 <th align="leftt" valign="top"><font face="Times New Roman, Times, Times Roman">Description</font></th>
1521 </tr>
1523 <tr>
1524 <td align="left" valign="top"><font face="Courier New, Courier">Icon</font></td>
1526 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">pixmap file name</font></td>
1528 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Assigns a pixmap image to be
1529 used as the icon for that window.</font></td>
1530 </tr>
1532 <tr>
1533 <td align="left" valign="top"><font face="Courier New, Courier">NoTitleBar</font></td>
1535 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">boolean</font></td>
1537 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Disables the titlebar in the
1538 window.</font></td>
1539 </tr>
1541 <tr>
1542 <td align="left" valign="top"><font face="Courier New, Courier">NoResizeBar</font></td>
1544 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">boolean</font></td>
1546 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Disables the resizebar in the
1547 window.</font></td>
1548 </tr>
1550 <tr>
1551 <td align="left" valign="top"><font face="Courier New, Courier">NoMiniaturizeButton</font></td>
1553 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">boolean</font></td>
1555 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Remove the miniaturize
1556 button.</font></td>
1557 </tr>
1559 <tr>
1560 <td align="left" valign="top"><font face="Courier New, Courier">NoCloseButton</font></td>
1562 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">boolean</font></td>
1564 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Remove the close
1565 button.</font></td>
1566 </tr>
1568 <tr>
1569 <td align="left" valign="top"><font face="Courier New, Courier">NoHideOthers</font></td>
1571 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">boolean</font></td>
1573 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Do not hide the window, or the
1574 application to which the window belongs when a <i>Hide Others</i> command is issued.</font></td>
1575 </tr>
1577 <tr>
1578 <td align="left" valign="top"><font face="Courier New, Courier">NoMouseBindings</font></td>
1580 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">boolean</font></td>
1582 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Do not grab mouse buttons in
1583 that window. This means that actions like a Meta-click on the window will be caught by the application instead
1584 of WindowMaker.</font></td>
1585 </tr>
1587 <tr>
1588 <td align="left" valign="top"><font face="Courier New, Courier">NoKeyBindings</font></td>
1590 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">boolean</font></td>
1592 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Do not grab keys in that window.
1593 This means that keystrokes that would normally be intercepted by WindowMaker (because they are bound to some
1594 action), like Meta+Up, will be passed to the application.</font></td>
1595 </tr>
1597 <tr>
1598 <td align="left" valign="top"><font face="Courier New, Courier">NoAppIcon</font></td>
1600 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">boolean</font></td>
1602 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Do not create application icon
1603 for the window. This is useful for some applications that incorrectly get more than one application
1604 icon.</font></td>
1605 </tr>
1607 <tr>
1608 <td align="left" valign="top"><font face="Courier New, Courier">KeepOnTop</font></td>
1610 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">boolean</font></td>
1612 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Always keep the window over
1613 other normal windows.</font></td>
1614 </tr>
1616 <tr>
1617 <td align="left" valign="top"><font face="Courier New, Courier">Omnipresent</font></td>
1619 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">boolean</font></td>
1621 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Make the window be present in
1622 all workspaces, AKA sticky window.</font></td>
1623 </tr>
1625 <tr>
1626 <td align="left" valign="top"><font face="Courier New, Courier">SkipWindowList</font></td>
1628 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">boolean</font></td>
1630 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Do not list the window in the
1631 <a href="chap3.php#3.12">window list menu</a>.</font></td>
1632 </tr>
1634 <tr>
1635 <td align="left" valign="top"><font face="Courier New, Courier">KeepInsideScreen</font></td>
1637 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">boolean</font></td>
1639 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Always keep the window inside
1640 the visible are of the screen.</font></td>
1641 </tr>
1643 <tr>
1644 <td align="left" valign="top"><font face="Courier New, Courier">Unfocusable</font></td>
1646 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">boolean</font></td>
1648 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Do not let the window be
1649 focused.</font></td>
1650 </tr>
1652 <tr>
1653 <td align="left" valign="top"><font face="Courier New, Courier">StartWorkspace</font></td>
1655 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Workspace number or
1656 name</font></td>
1658 <td align="left" valign="top"><font face="Times New Roman, Times, Times Roman">Make the window always be
1659 initially shown in the indicated workspace.</font></td>
1660 </tr>
1661 </tbody>
1662 </table>
1663 </center><br />
1664 <br />
1665 <a name="4.1.5"></a>
1667 <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
1668 defined in one of two distinct ways:<br />
1669 <br />
1671 <ul type="disk">
1672 <li>In the form of an array in property list format, in $(HOME)/GNUstep/Defaults/WMRootMenu</li>
1674 <li>In the form of a text file, whose location is present in $(HOME)/GNUstep/Defaults/WMRootMenu</li>
1675 </ul><br />
1676 <br />
1677 <br />
1678 </td>
1679 </tr>
1680 </table>
1681 </div>
1682 </body>
1683 </html>