Debian Codegraph @

doc/man/man1/mwm.1

raw ◀ ▶
Source reconstructed at patch state 0 of 2 — not the installed (fully patched) source.
2 Debian patches touch this file
1 '\" t
2 ...\" mwm.sgm /main/13 1996/09/25 11:30:27 cdedoc $
3 .de P!
4 .fl
5 \!!1 setgray
6 .fl
7 \\&.\"
8 .fl
9 \!!0 setgray
10 .fl \" force out current output buffer
11 \!!save /psv exch def currentpoint translate 0 0 moveto
12 \!!/showpage{}def
13 .fl \" prolog
14 .sy sed -e 's/^/!/' \\$1\" bring in postscript file
15 \!!psv restore
16 .
17 .de pF
18 .ie \\*(f1 .ds f1 \\n(.f
19 .el .ie \\*(f2 .ds f2 \\n(.f
20 .el .ie \\*(f3 .ds f3 \\n(.f
21 .el .ie \\*(f4 .ds f4 \\n(.f
22 .el .tm ? font overflow
23 .ft \\$1
24 ..
25 .de fP
26 .ie !\\*(f4 \{\
27 . ft \\*(f4
28 . ds f4\"
29 ' br \}
30 .el .ie !\\*(f3 \{\
31 . ft \\*(f3
32 . ds f3\"
33 ' br \}
34 .el .ie !\\*(f2 \{\
35 . ft \\*(f2
36 . ds f2\"
37 ' br \}
38 .el .ie !\\*(f1 \{\
39 . ft \\*(f1
40 . ds f1\"
41 ' br \}
42 .el .tm ? font underflow
43 ..
44 .ds f1\"
45 .ds f2\"
46 .ds f3\"
47 .ds f4\"
48 .ta 8n 16n 24n 32n 40n 48n 56n 64n 72n
49 .TH "mwm" "user cmd"
50 .SH "NAME"
51 \fBmwm\fP \(em The Motif
52 Window Manager
53 .SH "SYNOPSIS"
54 .PP
55 \fBmwm\fP [\fIoptions\fP]
56 .SH "DESCRIPTION"
57 .PP
58 The \fBmwm\fP window manager provides
59 functions that facilitate control (by the user and the programmer)
60 of elements of window state such as placement, size, icon/normal display,
61 and input-focus ownership\&.
62 .PP
63 The stand-alone window manager is not an integral part
64 of CDE and does not support communication with other components in the CDE
65 environment, such as the Style Manager and the Session Manager\&.
66 .SS "Options"
67 .IP "\fI-display\fP\ \fBdisplay\fP" 10
68 This option specifies the display to use; see \fBX\fP(1)\&.
69 .IP "\fI-xrm\fP\ \fBresourcestring\fP" 10
70 This option specifies a resource string to use\&.
71 .IP "\fI-multiscreen\fP" 10
72 This option causes \fBmwm\fP to manage all screens on
73 the display\&. The default is to manage only a single screen.
74 .IP "\fI-name\fP\ \fBname\fP" 10
75 This option causes \fBmwm\fP to retrieve its resources
76 using the specified name, as in \fBname*resource\fP\&.
77 .IP "\fI-screens\fP\ \fBname\ [name\ [\&.\&.\&.]]\fP" 10
78 This option specifies the resource names to use for the screens managed
79 by \fBmwm\fP\&. If \fBmwm\fP is managing a single
80 screen, only the first name in the list is used\&. If \fBmwm\fP
81 is managing multiple screens, the names are assigned to the screens in order,
82 starting with screen 0\&. Screen 0 gets the first name, screen 1 the second
83 name, and so on\&.
84 .SS "Appearance"
85 .PP
86 The following sections describe the basic default behaviors of windows,
87 icons, the icon box, input focus, and window stacking\&. The appearance and
88 behavior of the window manager can be altered by changing the configuration
89 of specific resources\&. Resources are defined under the heading "X DEFAULTS\&."
90 .SS "Screens"
91 .PP
92 By default, \fBmwm\fP manages only the single screen specified
93 by the \fI-display\fP option or the \fBDISPLAY\fP environment variable (by default, screen 0)\&. If the \fI-multiscreen\fP option is specified or if the \fImultiScreen\fP resource is True, \fBmwm\fP tries to manage all
94 the screens on the display\&.
95 .PP
96 When \fBmwm\fP is managing multiple screens, the \fI-screens\fP option can be used to give each screen a unique
97 resource name\&. The names are separated by blanks, for example, \fI-screens\fP scr0 scr1\&. If there are more screens than names,
98 resources for the remaining screens will be retrieved using the first name\&.
99 By default, the screen number is used for the screen name\&.
100 .SS "Windows"
101 .PP
102 Default \fBmwm\fP window frames have distinct components
103 with associated functions:
104 .IP "\fITitle\ Area\fP" 10
105 In addition to displaying the client\&'s title, the title area is used
106 to move the window\&. To move the window, place the pointer over the title area,
107 press button 1 and drag the window to a new location\&. By default, a wire
108 frame is moved during the drag to indicate the new location\&. When the button
109 is released, the window is moved to the new location\&.
110 .IP "\fITitle\ Bar\fP" 10
111 The title bar includes the title area, the minimize button, the maximize
112 button, and the window menu button\&. In shaped windows, such as round windows,
113 the title bar floats above the window\&.
114 .IP "\fIMinimize\ Button\fP" 10
115 To turn the window into an icon, click button 1 on the minimize button
116 (the frame box with a \fBsmall\fP square in it)\&.
117 .IP "\fIMaximize\ Button\fP" 10
118 To make the window fill the screen (or enlarge to the largest size allowed
119 by the configuration files), click button 1 on the maximize button (the frame
120 box with a \fBlarge\fP square in it)\&.
121 .IP "\fIWindow\ Menu\ Button\fP" 10
122 The window menu button is the frame box with a horizontal bar in it\&.
123 To pull down the window menu, press button 1\&. While pressing, drag the pointer
124 on the menu to your selection, then release the button when your selection
125 is highlighted\&. Pressing button 3 in the title bar or resize border handles
126 also posts the window menu\&. Alternately, you can click button 1 to pull down
127 the menu and keep it posted; then position the pointer and select\&. You can
128 also post the window menu by pressing <Shift> <Esc> or <Alt> <Space>\&.
129 Double-clicking button 1 with the pointer on the window menu button closes
130 the window\&.
131 .PP
132 The following table lists the contents of the window menu\&.
133 .SS "Default Window Menu"
134 .TS
135 tab();
136 lw(1.803823i) lw(1.062374i) lw(2.633803i).
137 SelectionAcceleratorDescription
138 RestoreT{
139 Restores the window to its size before minimizing
140 or maximizing\&.
141 T}
142 MoveT{
143 Allows the window to be moved with keys or
144 mouse\&.
145 T}
146 SizeAllows the window to be resized\&.
147 MinimizeTurns the window into an icon\&.
148 MaximizeMakes the window fill the screen\&.
149 LowerT{
150 Moves window to bottom of window stack\&.
151 T}
152 CloseAlt+F4Causes client to terminate\&.
153 .TE
154 .IP "\fIResize\ Border\ Handles\fP" 10
155 To change the size of a window, move the pointer over a resize border
156 handle (the cursor changes), press button 1, and drag the window to a new
157 size\&. When the button is released, the window is resized\&. While dragging is
158 being done, a rubber-band outline is displayed to indicate the new window
159 size\&.
160 .IP "\fIMatte\fP" 10
161 An optional matte decoration can be added between the client area and
162 the window frame (see the \fImatteWidth\fP resource)\&. A
163 \fImatte\fP is not actually part of the window frame\&.
164 There is no functionality associated with a matte\&.
165 .SS "Icons"
166 .PP
167 Icons are small graphic representations of windows\&. A window can be
168 minimized (iconified) using the minimize button on the window frame\&. Icons
169 provide a way to reduce clutter on the screen\&.
170 .PP
171 Pressing mouse button 1 when the pointer is over an icon causes the
172 icon\&'s window menu to pop up\&. Releasing the button (press + release without
173 moving mouse = click) causes the menu to stay posted\&. The menu contains the
174 following selections:
175 .SS "Icon Window Menu"
176 .TS
177 tab();
178 lw(0.913000i) lw(1.144000i) lw(3.443000i).
179 SelectionAcceleratorDescription
180 RestoreOpens the associated window\&.
181 MoveT{
182 Allows the icon to be moved with keys\&.
183 T}
184 SizeInactive (not an option for icons)\&.
185 MinimizeInactive (not an option for icons)\&.
186 MaximizeT{
187 Opens the associated window and makes it
188 fill the screen\&.
189 T}
190 LowerMoves icon to bottom of icon stack\&.
191 CloseAlt+F4T{
192 Removes client from \fBmwm\fP
193 management\&.
194 T}
195 .TE
196 .PP
197 Note that pressing button 3 over an icon also causes the icon\&'s window
198 menu to pop up\&. To make a menu selection, drag the pointer over the menu and
199 release button 3 when the desired item is highlighted\&.
200 .PP
201 Double-clicking button 1 on an icon invokes the \fBf\&.restore_and_raise\fP function and restores the icon\&'s associated window to its previous
202 state\&. For example, if a maximized window is iconified, double-clicking button
203 1 restores it to its maximized state\&. Double-clicking button 1 on the icon
204 box\&'s icon opens the icon box and allows access to the contained icons\&. (In
205 general, double-clicking a mouse button is a quick way to perform a function\&.)
206 Pressing <Shift> <Esc> or <Menu> (the pop-up menu key) causes the
207 icon window menu of the currently selected icon to pop up\&.
208 .SS "Icon Box"
209 .PP
210 When icons begin to clutter the screen, they can be packed into an icon
211 box\&. (To use an icon box, \fBmwm\fP must be started with the
212 icon box configuration already set\&.) The icon box is a \fBmwm\fP
213 window that holds client icons\&. It includes one or more scroll bars when there
214 are more window icons than the icon box can show at the same time\&.
215 .PP
216 Icons in the icon box can be manipulated with the mouse\&. The following
217 table summarizes the behavior of this interface\&. Button actions apply whenever
218 the pointer is on any part of the icon\&. Note that double-clicking an icon
219 in the icon box invokes the \fBf\&.restore_and_raise\fP function\&.
220 .TS
221 tab();
222 lw(0.841046i) lw(1.051308i) lw(3.607646i).
223 ButtonActionDescription
224 Button 1clickSelects the icon\&.
225 Button 1double-clickT{
226 Normalizes (opens) the associated window\&.
227 Raises an already open window to the top of the stack\&.
228 T}
229 Button 1dragMoves the icon\&.
230 Button 3pressT{
231 Causes the menu for that icon to pop up\&.
232 T}
233 Button 3dragT{
234 Highlights items as the pointer moves across
235 the menu\&.
236 T}
237 .TE
238 .PP
239 Pressing mouse button 3 when the pointer is over an icon causes the
240 menu for that icon to pop up\&.
241 .SS "Icon Menu for the Icon Box"
242 .TS
243 tab();
244 lw(0.885312i) lw(1.062374i) lw(3.552314i).
245 SelectionAcceleratorDescription
246 RestoreT{
247 Opens the associated window (if not already
248 open)\&.
249 T}
250 MoveT{
251 Allows the icon to be moved with keys\&.
252 T}
253 SizeInactive\&.
254 MinimizeInactive\&.
255 MaximizeT{
256 Opens the associated window (if not already
257 open) and maximizes its size\&.
258 T}
259 LowerInactive\&.
260 CloseAlt+F4T{
261 Removes client from \fBmwm\fP
262 management\&.
263 T}
264 .TE
265 .PP
266 To pull down the window menu for the icon box itself, press button 1
267 with the pointer over the menu button for the icon box\&. The window menu of
268 the icon box differs from the window menu of a client window: The "Close"
269 selection is replaced with the "PackIcons Shift+Alt+F7" selection\&. When selected,
270 PackIcons packs the icons in the box to achieve neat rows with no empty slots\&.
271 .PP
272 You can also post the window menu by pressing <Shift>, <Esc> or
273 <Alt> <Space>\&. Pressing <Menu> (the pop-up menu key) causes the icon
274 window menu of the currently selected icon to pop up\&.
275 .SS "Input Focus"
276 .PP
277 The \fBmwm\fP window manager supports (by default) a keyboard
278 input focus policy of explicit selection\&. This means when a window is selected
279 to get keyboard input, it continues to get keyboard input until the window
280 is withdrawn from window management, another window is explicitly selected
281 to get keyboard input, or the window is iconified\&. Several resources control
282 the input focus\&. The client window with the keyboard input focus has the active
283 window appearance with a visually distinct window frame\&.
284 .PP
285 The following tables summarize the keyboard input focus selection behavior:
286 .TS
287 tab();
288 lw(0.880482i) lw(0.844298i) lw(1.350877i) lw(2.424342i).
289 ButtonActionObjectFunction Description
290 Button 1pressWindow / window frameKeyboard focus selection\&.
291 Button 1pressIconKeyboard focus selection\&.
292 .TE
293 .TS
294 tab();
295 lw(1.394366i) lw(4.105634i).
296 Key ActionFunction Description
297 [Alt][Tab]T{
298 Move input focus to next window in window
299 stack (available only in explicit focus mode)\&.
300 T}
301 [Alt][Shift][Tab]T{
302 Move input focus to previous window in window
303 stack (available only in explicit focus mode)\&.
304 T}
305 .TE
306 .SS "Window Stacking"
307 .PP
308 There are two types of window stacks: global window stacks and an application\&'s
309 local family window stack\&.
310 .PP
311 The global stacking order of windows may be changed as a result of setting
312 the keyboard input focus, iconifying a window, or performing a window manager
313 window stacking function\&. When keyboard focus policy is explicit the default
314 value of the \fIfocusAutoRaise\fP resource is True\&. This causes
315 a window to be raised to the top of the stack when it receives input focus,
316 for example, by pressing button 1 on the title bar\&. The key actions defined
317 in the previous table will thus raise the window receiving focus to the top
318 of the stack\&.
319 .PP
320 In pointer mode, the default value of \fIfocusAutoRaise\fP
321 is False, that is, the window stacking order is not changed when a window
322 receives keyboard input focus\&. The following key actions can be used to cycle
323 through the global window stack\&.
324 .TS
325 tab();
326 lw(1.567982i) lw(3.932018i).
327 Key ActionFunction Description
328 [Alt][ESC]T{
329 Place top window on bottom of stack\&.
330 T}
331 [Alt][Shift][ESC]T{
332 Place bottom window on top of stack\&.
333 T}
334 .TE
335 .PP
336 By default, a window\&'s icon is placed on the bottom of the stack when
337 the window is iconified; however, the default can be changed by the \fIlowerOnIconify\fP resource\&.
338 .PP
339 Transient windows (secondary windows such a dialog boxes) stay above
340 their parent windows by default; however, an application\&'s local family stacking
341 order may be changed to allow a transient window to be placed below its parent
342 top-level window\&. The following arguments show the modification of the stacking
343 order for the \fBf\&.lower\fP function\&.
344 .IP "\fBf\&.lower\fP" 10
345 Lowers the transient window within the family (staying above the parent)
346 and lowers the family in the global window stack\&.
347 .IP "\fBf\&.lower\fP\ [ \fIwithin\fP]" 10
348 Lowers the transient window within the family (staying above the parent)
349 but does not lower the family in the global window stack\&.
350 .IP "\fBf\&.lower\fP\ [\fIfreeFamily\fP ]" 10
351 Lowers the window free from its family stack (below the parent), but
352 does not lower the family in the global window stack\&.
353 .PP
354 The arguments \fIwithin\fP and \fIfreeFamily\fP can also be used with \fBf\&.raise\fP
355 and \fBf\&.raise_lower\fP\&.
356 .SS "Session Management"
357 .PP
358 The window manager is an X Session Management Protocol aware client\&. It responds to SaveYourself
359 (and other associated messages) by saving the geometries of its clients to a state file\&.
360 \fBmwm\fP can then be restarted by the XSMP session manager\&.
361 The default location for the state file is \fB$HOME/\&.mwmclientdb\fP\&.
362 This location can be overriden with the resource \fBsessionClientDB\fP\&.
363 .SS "X Resources"
364 .PP
365 The \fBmwm\fP command is configured from its resource
366 database\&. This database is built from the following sources\&. They are listed
367 in order of precedence, low to high:
368 .PP
369 \fB/usr/X11R6/lib/X11/app-defaults/Mwm\fP
370 .PP
371 \fB$HOME/Mwm\fP
372 .PP
373 \fBRESOURCE_MANAGER\fP root window property or \fB$HOME/\&.Xdefaults\fP
374 .PP
375 \fBXENVIRONMENT\fP variable or \fB$HOME/\&.Xdefaults-host\fP
376 .PP
377 \fBmwm\fP command line options
378 .PP
379 The file names \fB/usr/X11R6/lib/X11/app-defaults/Mwm\fP and \fB$HOME/Mwm\fP represent customary locations for these files\&. The actual
380 location of the system-wide class resource file may depend on the \fBXFILESEARCHPATH\fP environment variable and the
381 current language environment\&. The actual location of the user-specific class
382 resource file may depend on the \fBXUSERFILESEARCHPATH\fP and \fBXAPPLRESDIR\fP
383 environment variables and the current language environment\&.
384 .PP
385 Entries in the resource database may refer to other resource files for
386 specific types of resources\&. These include files that contain bitmaps, fonts,
387 and \fBmwm\fP specific resources such as menus and behavior
388 specifications (for example, button and key bindings)\&.
389 .PP
390 \fIMwm\fP is the resource class name of \fBmwm\fP and \fBmwm\fP is the default resource name used by \fBmwm\fP to look up resources\&. the \fI-screens\fP
391 command line option specifies resource names, such as "mwm_b+w" and "mwm_color"\&.)
392 In the following discussion of resource specification, "Mwm" and "mwm" (and
393 the aliased \fBmwm\fP resource names) can be used interchangeably,
394 but "mwm" takes precedence over "Mwm"\&.
395 .PP
396 The \fBmwm\fP command uses the following types of resources:
397 .IP "\fBComponent Appearance Resources:\fP" 10
398 These resources specify appearance attributes of window manager user
399 interface components\&. They can be applied to the appearance of window manager
400 menus, feedback windows (for example, the window reconfiguration feedback
401 window), client window frames, and icons\&.
402 .IP "\fBGeneral Appearance and Behavior Resources:\fP" 10
403 These resources specify \fBmwm\fP appearance and behavior
404 (for example, window management policies)\&. They are not set separately for
405 different \fBmwm\fP user interface components\&. They apply to
406 all screens and workspaces\&.
407 .IP "\fBScreen Specific Appearance and Behavior Resources:\fP" 10
408 These resources specify the appearance and behavior of \fBmwm\fP elements that are settable on a per-screen basis\&.
409 .IP "\fBClient Specific Resources:\fP" 10
410 These \fBmwm\fP resources can be set for a particular
411 client window or class of client windows\&. They specify client-specific icon
412 and client window frame appearance and behavior\&.
413 .PP
414 Resource identifiers can be either a resource name (for example, foreground)
415 or a resource class (for example, Foreground)\&. If the value of a resource
416 is a filename and if the filename is prefixed by "~/", then it is relative
417 to the path contained in the \fBHOME\fP
418 environment variable (generally the user\&'s home directory)\&.
419 .SS "Component Appearance Resources"
420 .PP
421 The syntax for specifying component appearance resources that apply
422 to window manager icons, menus, and client window frames is \fIMwm*\fP \fBresource_id\fP
423 .PP
424 For example, \fIMwm*foreground\fP is used to specify
425 the foreground color for \fBmwm\fP menus, icons, client window
426 frames, and feedback dialogs\&.
427 .PP
428 The syntax for specifying component appearance resources that apply
429 to a particular \fBmwm\fP component is \fIMwm*\fP[\fImenu\fP|\fIicon\fP|\fIclient\fP|\fIfeedback\fP] \fI*\fP\fBresource_id\fP
430 .PP
431 If \fBmenu\fP is specified, the resource is applied only
432 to \fBmwm\fP menus; if \fBicon\fP is specified,
433 the resource is applied to icons; and if \fBclient\fP is specified,
434 the resource is applied to client window frames\&. For example, \fIMwm*icon*foreground\fP is used to specify the foreground color for \fBmwm\fP
435 icons, \fIMwm*menu*foreground\fP specifies the foreground
436 color for \fBmwm\fP menus, and \fIMwm*client*foreground\fP is used to specify the foreground color for \fBmwm\fP
437 client window frames\&.
438 .PP
439 The appearance of the title area of a client window frame (including
440 window management buttons) can be separately configured\&. The syntax for configuring
441 the title area of a client window frame is \fIMwm*client*title*\fP \fBresource_id\fP
442 .PP
443 For example, \fIMwm*client*title*foreground\fP specifies
444 the foreground color for the title area\&. Defaults for title area resources
445 are based on the values of the corresponding client window frame resources\&.
446 .PP
447 The appearance of menus can be configured based on the name of the menu\&.
448 The syntax for specifying menu appearance by name is \fIMwm*menu*\fP \fBmenu_name\fP\fI*\fP\fBresource_id\fP
449 .PP
450 For example, \fIMwm*menu*my_menu*foreground\fP specifies
451 the foreground color for the menu named \fImy_menu\fP\&. The
452 user can also specify resources for window manager menu components, that is,
453 the gadgets that comprise the menu\&. These may include for example, a menu
454 title, title separator, one or more buttons, and separators\&. If a menu contains
455 more than one instance of a class, such as multiple PushButtonGadgets, the
456 name of the first instance is "PushButtonGadget1", the second is "PushButtonGadget2",
457 and so on\&. The following list identifies the naming convention used for window
458 manager menu components:
459 .IP " \(bu" 6
460 Menu Title LabelGadget - "TitleName"
461 .IP " \(bu" 6
462 Menu Title SeparatorGadget - "TitleSeparator"
463 .IP " \(bu" 6
464 CascadeButtonGadget - "CascadeButtonGadget<n>"
465 .IP " \(bu" 6
466 PushButtonGadget - "PushButtonGadget<n>"
467 .IP " \(bu" 6
468 SeparatorGadget - "SeparatorGadget<n>"
469 .PP
470 Refer to the man page for each class for a list of resources that can
471 be specified\&.
472 .PP
473 The following component appearance resources that apply to all window
474 manager parts can be specified:
475 .SS "Component Appearance Resources - All Window Manager Parts"
476 .TS
477 tab();
478 lw(1.802521i) lw(1.571429i) lw(1.178571i) lw(0.947479i).
479 NameClassValue TypeDefault
480 backgroundBackgroundcolorvaries\(dg
481 backgroundPixmapBackgroundPixmapstring\(dg\(dgvaries\(dg
482 bottomShadowColorForegroundcolorvaries\(dg
483 bottomShadowPixmapForegroundstring\(dg\(dgvaries\(dg
484 fontListFontListT{
485 string\(dg\(dg\(dg
486 T}"fixed"
487 foregroundForegroundcolorvaries\(dg
488 saveUnderSaveUnderT/FF
489 topShadowColorBackgroundcolorvaries\(dg
490 topShadowPixmapTopShadowPixmapstring\(dg\(dgvaries\(dg
491 .TE
492 .PP
493 \(dgThe default is chosen based on the visual type of the screen\&.
494 \(dg\(dgImage name\&. See \fBXmInstallImage\fP(3)\&. \(dg\(dg\(dgX11
495 X Logical Font Description
496 .IP "\fIbackground\fP\ (class\ \fIBackground\fP)" 10
497 This resource specifies the background color\&. Any legal X color may
498 be specified\&. The default value is chosen based on the visual type of the
499 screen\&.
500 .IP "\fIbackgroundPixmap\fP\ (class\ \fIBackgroundPixmap\fP)" 10
501 This resource specifies the background Pixmap of the \fBmwm\fP
502 decoration when the window is inactive (does not have the keyboard focus)\&.
503 The default value is chosen based on the visual type of the screen\&.
504 .IP "\fIbottomShadowColor\fP\ (class\ \fIForeground\fP)" 10
505 This resource specifies the bottom shadow color\&. This color is used
506 for the lower and right bevels of the window manager decoration\&. Any legal
507 X color may be specified\&. The default value is chosen based on the visual
508 type of the screen\&.
509 .IP "\fIbottomShadowPixmap\fP\ (class\ \fIBottomShadowPixmap\fP)" 10
510 This resource specifies the bottom shadow Pixmap\&. This Pixmap is used
511 for the lower and right bevels of the window manager decoration\&. The default
512 is chosen based on the visual type of the screen\&.
513 .IP "\fIfontList\fP\ (class\ \fIFontList\fP)" 10
514 This resource specifies the font used in the window manager decoration\&.
515 The character encoding of the font should match the character encoding of
516 the strings that are used\&. The default is "fixed\&."
517 .IP "\fIforeground\fP\ (class\ \fIForeground\fP)" 10
518 This resource specifies the foreground color\&. The default is chosen
519 based on the visual type of the screen\&.
520 .IP "\fIsaveUnder\fP\ (class\ \fISaveUnder\fP)" 10
521 This is used to indicate whether "save unders" are used for \fBmwm\fP components\&. For this to have any effect, save unders must be
522 implemented by the X server\&. If save unders are implemented, the X server
523 saves the contents of windows obscured by windows that have the save under
524 attribute set\&. If the \fIsaveUnder\fP resource is True, \fBmwm\fP will set the save under attribute on the window manager frame
525 of any client that has it set\&. If \fIsaveUnder\fP is False,
526 save unders will not be used on any window manager frames\&. The default value
527 is False\&.
528 .IP "\fItopShadowColor\fP\ (class\ \fIBackground\fP)" 10
529 This resource specifies the top shadow color\&. This color is used for
530 the upper and left bevels of the window manager decoration\&. The default is
531 chosen based on the visual type of the screen\&.
532 .IP "topShadowPixmap\ (\ class\ \fITopShadowPixmap)\fP" 10
533 This resource specifies the top shadow Pixmap\&. This Pixmap is used for
534 the upper and left bevels of the window manager decoration\&. The default is
535 chosen based on the visual type of the screen\&.
536 .PP
537 The following component appearance resources that apply to frame and
538 icons can be specified:
539 .SS "Frame and Icon Components"
540 .TS
541 tab();
542 lw(2.072144i) lw(1.653307i) lw(0.991984i) lw(0.782565i).
543 NameClassValue TypeDefault
544 activeBackgroundBackgroundcolorvaries\(dg
545 activeBackgroundPixmapBackgroundPixmapstring\(dg\(dgvaries\(dg
546 activeBottomShadowColorForegroundcolorvaries\(dg
547 activeBottomShadowPixmapBottomShadowPixmapstring\(dg\(dgvaries\(dg
548 activeForegroundForegroundcolorvaries\(dg
549 activeTopShadowColorBackgroundcolorvaries\(dg
550 activeTopShadowPixmapTopShadowPixmapstring\(dg\(dgvaries\(dg
551 .TE
552 .PP
553 \(dgThe default is chosen based on the visual type of the screen\&.
554 \(dg\(dgSee \fBXmInstallImage\fP(3)\&.
555 .IP "\fIactiveBackground\fP\ (class\ \fIBackground\fP)" 10
556 This resource specifies the background color of the \fBmwm\fP
557 decoration when the window is active (has the keyboard focus)\&. The default
558 is chosen based on the visual type of the screen\&.
559 .IP "\fIactiveBackgroundPixmap\fP\ (class\ \fIActiveBackgroundPixmap\fP)" 10
560 This resource specifies the background Pixmap of the \fBmwm\fP
561 decoration when the window is active (has the keyboard focus)\&. The default
562 is chosen based on the visual type of the screen\&.
563 .IP "\fIactiveBottomShadowColor\fP\ (class\ \fIForeground\fP)" 10
564 This resource specifies the bottom shadow color of the \fBmwm\fP decoration when the window is active (has the keyboard focus)\&.
565 The default is chosen based on the visual type of the screen\&.
566 .IP "\fIactiveBottomShadowPixmap\fP\ (class\ \fIBottomShadowPixmap\fP)" 10
567 This resource specifies the bottom shadow Pixmap of the \fBmwm\fP decoration when the window is active (has the keyboard focus)\&.
568 The default is chosen based on the visual type of the screen\&.
569 .IP "\fIactiveForeground\fP\ (class\ \fIForeground\fP)" 10
570 This resource specifies the foreground color of the \fBmwm\fP
571 decoration when the window is active (has the keyboard focus)\&. The default
572 is chosen based on the visual type of the screen\&.
573 .IP "\fIactiveTopShadowColor\fP\ (class\ \fIBackground\fP)" 10
574 This resource specifies the top shadow color of the \fBmwm\fP
575 decoration when the window is active (has the keyboard focus)\&. The default
576 is chosen based on the visual type of the screen\&.
577 .IP "\fIactiveTopShadowPixmap\fP\ (class\ \fITopShadowPixmap\fP)" 10
578 This resource specifies the top shadow Pixmap of the \fBmwm\fP
579 decoration when the window is active (has the keyboard focus)\&. The default
580 is chosen based on the visual type of the screen\&.
581 .SS "General Appearance and Behavior Resources"
582 .PP
583 The syntax for specifying general appearance and behavior resources
584 is \fIMwm*\fP\fBresource_id\fP
585 .PP
586 For example, \fIMwm*keyboardFocusPolicy\fP specifies
587 the window manager policy for setting the keyboard focus to a particular client
588 window\&.
589 .PP
590 The following general appearance and behavior resources can be specified:
591 .SS "General Appearance and Behavior Resources"
592 .TS
593 tab();
594 lw(1.528376i) lw(1.592955i) lw(1.054795i) lw(1.323875i).
595 NameClassValue TypeDefault
596 autoKeyFocusAutoKeyFocusT/FT
597 autoRaiseDelayAutoRaiseDelaymillisec500
598 bitmap-Bitmap-directory/usr/X11R6/include-
599 DirectoryDirectory/X11/bitmaps
600 clientAutoPlaceClientAutoPlaceT/FT
601 colormapFocus-ColormapFocus-stringkeyboard
602 PolicyPolicy
603 configFileConfigFilefile$HOME/mwmrc
604 deiconifyKeyFocusDeiconifyKeyFocusT/FT
605 doubleClick-DoubleClick-millisec\&.multi-click
606 TimeTimetime\(dg
607 enableWarpenableWarpT/FT
608 enforceKeyFocusEnforceKeyFocusT/FT
609 frameStyleFrameStylestringrecessed
610 iconAutoPlaceIconAutoPlaceT/FT
611 iconClickIconClickT/FT
612 interactivePlacementInteractivePlacementT/FT
613 keyboardFocus-KeyboardFocus-stringexplicit
614 PolicyPolicy
615 lowerOnIconifyLowerOnIconifyT/FT
616 moveThresholdMoveThresholdpixels4
617 multiScreenMultiScreenT/FF
618 passButtonsPassButtonsT/FF
619 passSelectButtonPassSelectButtonT/FT
620 positionIsFramePositionIsFrameT/FT
621 positionOnScreenPositionOnScreenT/FT
622 quitTimeoutQuitTimeoutmillisec\&.1000
623 raiseKeyFocusRaiseKeyFocusT/FF
624 refreshByClearingRefreshByClearingT/FT
625 rootButtonClickRootButtonClickT/FF
626 screensScreensstringvaries
627 sessionClientDBSessionClientDBstring$HOME/\&.mwmclientdb
628 showFeedbackShowFeedbackstringall
629 startupKeyFocusStartupKeyFocusT/FT
630 wMenuButtonClickWMenuButtonClickT/FT
631 wMenuButtonClick2WMenuButtonClick2T/FT
632 .TE
633 .PP
634 \(dgThe resource doubleClickTime is included for backward compatibility\&.
635 Use of the Xt resource multiClickTime is preferred\&.
636 .IP "\fIautoKeyFocus\fP\ (class\ \fIAutoKeyFocus\fP)" 10
637 This resource is available only when the keyboard input focus policy
638 is explicit\&. If \fIautoKeyFocus\fP is given a value of True,
639 then when a window with the keyboard input focus is withdrawn from window
640 management or is iconified, the focus is set to the previous window that had
641 the focus\&. If the value given is False, there is no automatic setting of the
642 keyboard input focus\&. It is recommended that both \fIautoKeyFocus\fP and \fIstartupKeyFocus\fP be True to work with
643 tear off menus\&. The default value is True\&.
644 .IP "\fIautoRaiseDelay\fP\ (class\ \fIAutoRaiseDelay\fP)" 10
645 This resource is available only when the \fIfocusAutoRaise\fP
646 resource is True and the keyboard focus policy is pointer\&. The \fIautoRaiseDelay\fP resource specifies the amount of time (in milliseconds)
647 that \fBmwm\fP will wait before raising a window after it gets
648 the keyboard focus\&. The default value of this resource is 500 (ms)\&.
649 .IP "\fIbitmapDirectory\fP\ (class\ \fIBitmapDirectory\fP)" 10
650 This resource identifies a directory to be searched for bitmaps referenced
651 by \fBmwm\fP resources\&. This directory is searched if a bitmap
652 is specified without an absolute pathname\&. The default value for this resource
653 is \fB/usr/X11R6/include/X11/bitmaps\fP\&. The directory \fB/usr/X11R6/include/X11/bitmaps\fP
654 represents the customary locations for this directory\&. The actual
655 location of this directory may vary on some systems\&. If the bitmap is not
656 found in the specified directory, \fBXBMLANGPATH\fP is searched\&.
657 .IP "\fIclientAutoPlace\fP\ (class\ \fIClientAutoPlace\fP)" 10
658 This resource determines the position of a window when the window has
659 not been given a program- or user-specified position\&. With a value of True,
660 windows are positioned with the top left corners of the frames offset horizontally
661 and vertically\&. A value of False causes the currently configured position
662 of the window to be used\&. In either case, \fBmwm\fP will attempt
663 to place the windows totally on-screen\&. The default value is True\&.
664 .IP "\fIcolormapFocusPolicy\fP\ (class\ \fIColormapFocusPolicy\fP)" 10
665 This resource indicates the colormap focus policy that is to be used\&.
666 If the resource value is explicit, a colormap selection action is done on
667 a client window to set the colormap focus to that window\&. If the value is
668 pointer, the client window containing the pointer has the colormap focus\&.
669 If the value is keyboard, the client window that has the keyboard input focus
670 has the colormap focus\&. The default value for this resource is keyboard\&.
671 .IP "\fIconfigFile\fP\ (class\ \fIConfigFile\fP)" 10
672 The resource value is the pathname for a \fBmwm\fP resource
673 description file\&. If the pathname begins with "~/", \fBmwm\fP
674 considers it to be relative to the user\&'s home directory (as specified by
675 the \fBHOME\fP environment variable)\&.
676 If the \fBLANG\fP environment variable
677 is set, \fBmwm\fP looks for \fI$HOME/$LANG\fP/ \fBconfigFile\fP\&. If that file does not exist or if \fBLANG\fP is not set, \fBmwm\fP looks for
678 \fB$HOME\fP/\fBconfigFile\fP\&. If the \fIconfigFile\fP pathname does not begin with "~/" or "/", \fBmwm\fP considers it to be relative to the current working directory\&. If
679 the \fIconfigFile\fP resource is not specified
680 or if that file does not exist, \fBmwm\fP uses several default
681 paths to find a configuration file\&. The order of the search is shown below: \fB/usr/X11R6/lib/X11/$LANG/system\&.mwmrc\fP\(dg
682 \fB/usr/X11R6/lib/X11/system\&.mwmrc\fP\(dg Paths marked with \&'\(dg\&' are
683 implementation dependent\&.
684 .IP "\fIdeiconifyKeyFocus\fP\ (class\ \fIDeiconifyKeyFocus\fP)" 10
685 This resource applies only when the keyboard input focus policy is explicit\&.
686 If a value of True is used, a window receives the keyboard input focus when
687 it is normalized (deiconified)\&. True is the default value\&.
688 .IP "\fIdoubleClickTime\fP\ (class\ \fIDoubleClickTime\fP)" 10
689 This resource is used to set the maximum time (in ms) between the clicks
690 (button presses) that make up a double-click\&. The use of this resource is
691 deprecated\&. Use the Xt resource \fImultiClickTime\fP instead\&.
692 The value of \fIdoubleClickTime\fP dynamically defaults to
693 the value of \fImultiClickTime\fP\&.
694 .IP "\fIenableWarp\fP\ (class\ \fIEnableWarp\fP)" 10
695 The default value of this resource, True, causes \fBmwm\fP
696 to warp the pointer to the center of the selected window during keyboard-controlled
697 resize and move operations\&. Setting the value to False causes \fBmwm\fP to leave the pointer at its original place on the screen, unless
698 the user explicitly moves it with the cursor keys or pointing device\&.
699 .IP "\fIenforceKeyFocus\fP\ (class\ \fIEnforceKeyFocus\fP)" 10
700 If this resource is given a value of True, the keyboard input focus
701 is always explicitly set to selected windows even if there is an indication
702 that they are "globally active" input windows\&. (An example of a globally active
703 window is a scroll bar that can be operated without setting the focus to that
704 client\&.) If the resource is False, the keyboard input focus is not explicitly
705 set to globally active windows\&. The default value is True\&.
706 .IP "\fIframeStyle\fP\ (class\ \fIframeStyle\fP)" 10
707 If this resource is given a value of "slab", the the window manager
708 frame is drawn such that the client area appears to be at the same height
709 as the top of the window frame\&. If the resource is set to "recessed", the
710 window frame is drawn such that the client area appears lower than the top
711 of the window frame\&. The default value is "recessed"\&.
712 .IP "\fIiconAutoPlace\fP\ (class\ \fIIconAutoPlace\fP)" 10
713 This resource indicates whether the window manager arranges icons in
714 a particular area of the screen or places each icon where the window was when
715 it was iconified\&. The value True indicates that icons are arranged in a particular
716 area of the screen, determined by the \fIiconPlacement\fP resource\&.
717 The value False indicates that an icon is placed at the location of the window
718 when it is iconified\&. The default is True\&.
719 .IP "\fIiconClick\fP\ (class\ \fIIconClick\fP)" 10
720 When this resource is given the value of True, the system menu is posted
721 and left posted when an icon is clicked\&. The default value is True\&.
722 .IP "\fIinteractivePlacement\fP\ (class\ \fIInteractivePlacement\fP)" 10
723 This resource controls the initial placement of new windows on the screen\&.
724 If the value is True, the pointer shape changes before a new window is placed
725 on the screen to indicate to the user that a position should be selected for
726 the upper-left hand corner of the window\&. If the value is False, windows are
727 placed according to the initial window configuration attributes\&. The default
728 value of this resource is False\&.
729 .IP "\fIkeyboardFocusPolicy\fP\ (class\ \fIKeyboardFocusPolicy\fP)" 10
730 If set to pointer, the keyboard focus policy is to have the keyboard
731 focus set to the client window that contains the pointer (the pointer could
732 also be in the client window decoration that \fBmwm\fP adds)\&.
733 If set to explicit, the policy is to have the keyboard focus set to a client
734 window when the user presses button 1 with the pointer on the client window
735 or any part of the associated \fBmwm\fP decoration\&. The default
736 value for this resource is explicit\&.
737 .IP "\fIlowerOnIconify\fP\ (class\ \fILowerOnIconify\fP)" 10
738 If this resource is given the default value of True, a window\&'s icon
739 appears on the bottom of the window stack when the window is minimized (iconified)\&.
740 A value of False places the icon in the stacking order at the same place as
741 its associated window\&. The default value of this resource is True\&.
742 .IP "\fImoveThreshold\fP\ (class\ \fIMoveThreshold\fP)" 10
743 This resource is used to control the sensitivity of dragging operations
744 that move windows and icons\&. The value of this resource is the number of pixels
745 that the locator is moved with a button down before the move operation is
746 initiated\&. This is used to prevent window/icon movement when you click or
747 double-click and there is unintentional pointer movement with the button down\&.
748 The default value of this resource is 4 (pixels)\&.
749 .IP "\fImultiScreen\fP\ (class\ \fIMultiScreen\fP)" 10
750 This resource, if True, causes \fBmwm\fP to manage all
751 the screens on the display\&. If False, \fBmwm\fP manages only
752 a single screen\&. The default value is False\&.
753 .IP "\fIpassButtons\fP\ (class\ \fIPassButtons\fP)" 10
754 This resource indicates whether or not button press events are passed
755 to clients after they are used to do a window manager function in the client
756 context\&. If the resource value is False, the button press is not passed to
757 the client\&. If the value is True, the button press is passed to the client
758 window\&. The window manager function is done in either case\&. The default value
759 for this resource is False\&.
760 .IP "\fIpassSelectButton\fP\ (class\ \fIPassSelectButton\fP)" 10
761 This resource indicates whether or not to pass the select button press
762 events to clients after they are used to do a window manager function in the
763 client context\&. If the resource value is False, then the button press will
764 not be passed to the client\&. If the value is True, the button press is passed
765 to the client window\&. The window manager function is done in either case\&.
766 The default value for this resource is True\&.
767 .IP "\fIpositionIsFrame\fP\ (class\ \fIPositionIsFrame\fP)" 10
768 This resource indicates how client window position information (from
769 the \fIWM_NORMAL_HINTS\fP property and from configuration requests)
770 is to be interpreted\&. If the resource value is True, the information is interpreted
771 as the position of the \fBmwm\fP client window frame\&. If the
772 value is False, it is interpreted as being the position of the client area
773 of the window\&. The default value of this resource is True\&.
774 .IP "\fIpositionOnScreen\fP\ (class\ \fIPositionOnScreen\fP)" 10
775 This resource is used to indicate that windows should initially be placed
776 (if possible) so that they are not clipped by the edge of the screen (if the
777 resource value is True)\&. If a window is larger than the size of the screen,
778 at least the upper-left corner of the window is on-screen\&. If the resource
779 value is False, windows are placed in the requested position even if totally
780 off-screen\&. The default value of this resource is True\&.
781 .IP "\fIquitTimeout\fP\ (class\ \fIQuitTimeout\fP)" 10
782 This resource specifies the amount of time (in milliseconds) that \fBmwm\fP will wait for a client to update the \fIWM_COMMAND\fP
783 property after \fBmwm\fP has sent the \fBWM_SAVE_YOURSELF\fP message\&. The default value of this resource is 1000 (ms)\&. (Refer
784 to the \fBf\&.kill\fP function description for additional information\&.)
785 .IP "\fIraiseKeyFocus\fP\ (class\ \fIRaiseKeyFocus\fP)" 10
786 This resource is available only when the keyboard input focus policy
787 is explicit\&. When set to True, this resource specifies that a window raised
788 by means of the \fBf\&.normalize_and_raise\fP function also receives
789 the input focus\&. The default value of this resource is False\&.
790 .IP "\fIrefreshByClearing\fP\ (class\ \fIRefreshByClearing\fP)" 10
791 This resource determines the mechanism used to refresh a window (or
792 the screen) when the \fBf\&.refresh_win\fP (\fBf\&.refresh\fP) function is executed\&. When set to True, an XClearArea is performed
793 over the window for \fBf\&.refresh_win\fP\&. When set to False,
794 a covering window is created and destroyed over the top of the window to be
795 refreshed\&. If the function is \fBf\&.refresh\fP and this resource
796 is set to True, then an XClearArea is performed over every window on the screen\&.
797 If the resource is set to False, then one large window covering the entire
798 screen is created and destroyed\&. The default value of this resource is True\&.
799 .IP "\fIrootButtonClick\fP\ (class\ \fIRootButtonClick\fP)" 10
800 The \fIrootButtonClick\fP resource controls whether the
801 a click on the root window will post the root menu in a "sticky" mode\&. If
802 this resource is set to True, a button click on the root window will post
803 the menu bound to the button down event for that button in a "sticky" fashion\&.
804 If this resource is set to False, then the same button click would only cause
805 the menu to flash as it would be unposted once the button up event is seen\&.
806 The criterion used to determine if it is a button click is if the pointer
807 doesn\&'t move between the button down and button up events\&. The default value
808 for this resource is True\&.
809 .IP "\fIscreens\fP\ (class\ \fIScreens\fP)" 10
810 This resource specifies the resource names to use for the screens managed
811 by \fBmwm\fP\&. If \fBmwm\fP is managing a single
812 screen, only the first name in the list is used\&. If \fBmwm\fP
813 is managing multiple screens, the names are assigned to the screens in order,
814 starting with screen 0\&. Screen 0 gets the first name, screen 1 the second
815 name, and so on\&. The default screen names are 0, 1, and so on\&.
816 .IP "\fIsessionClientDB\fP\ (class\ \fISessionClientDB\fP)" 10
817 This resource identifies a file name to use as a root when saving state
818 at the request of an XSMP session manager\&. When the session is saved, the window manager will then reuse
819 the file name by automatically incrementing a suffix\&.
820 .IP "\fIshowFeedback\fP\ (class\ \fIShowFeedback\fP)" 10
821 This resource controls whether or not feedback windows or confirmation
822 dialogs are displayed\&. A feedback window shows a client window\&'s initial
823 placement and shows position and size during move and resize operations\&.
824 Confirmation dialogs can be displayed for certain operations\&. The value for
825 this resource is a list of names of the feedback options to be enabled or
826 disabled; the names must be separated by a space\&. If an option is preceded
827 by a minus sign, that option is excluded from the list\&. The \fBsign\fP of the first item in the list determines the initial set of options\&.
828 If the sign of the first option is minus, \fBmwm\fP assumes
829 all options are present and starts subtracting from that set\&. If the sign
830 of the first decoration is plus (or not specified), \fBmwm\fP
831 starts with no options and builds up a list from the resource\&.
832 .PP
833 The names of the feedback options are shown below:
834 .TS
835 tab();
836 lw(1.097588i) lw(4.402412i).
837 NameDescription
838 allShow all feedback (Default value)\&.
839 behaviorConfirm behavior switch\&.
840 killConfirm on receipt of KILL signal\&.
841 moveShow position during move\&.
842 noneShow no feedback\&.
843 placementT{
844 Show position and size during initial placement\&.
845 T}
846 quitConfirm quitting \fBmwm\fP\&.
847 resizeShow size during resize\&.
848 restartConfirm \fBmwm\fP restart\&.
849 .TE
850 .PP
851 The following command line illustrates the syntax for showFeedback:
852 .PP
853 .nf
854 \f(CW\fIMwm*showFeedback: placement resize behavior restart\fP\fR
855 .fi
856 .PP
857 .PP
858 This resource specification provides feedback for initial client placement
859 and resize, and enables the dialog boxes to confirm the restart and set behavior
860 functions\&. It disables feedback for the move function\&. The default value for
861 this resource is all\&.
862 .IP "\fIstartupKeyFocus\fP\ (class\ \fIStartupKeyFocus\fP)" 10
863 This resource is available only when the keyboard input focus policy
864 is explicit\&. When given the default value of True, a window gets the keyboard
865 input focus when the window is mapped (that is, initially managed by the window
866 manager)\&. It is recommended that both \fIautoKeyFocus\fP and \fIstartupKeyFocus\fP be True to work with tear off menus\&. The default
867 value is True\&.
868 .IP "\fIwMenuButtonClick\fP\ (class\ \fIWMenuButtonClick\fP)" 10
869 This resource indicates whether a click of the mouse when the pointer
870 is over the window menu button posts and leaves posted the window menu\&. If
871 the value given this resource is True, the menu remains posted\&. True is the
872 default value for this resource\&.
873 .IP "\fIwMenuButtonClick2\fP\ (class\ \fIWMenuButtonClick2\fP)" 10
874 When this resource is given the default value of True, a double-click
875 action on the window menu button does an \fIf\&.kill function\fP\&.
876 .SS "Screen Specific Appearance and Behavior Resources"
877 .PP
878 The syntax for specifying screen specific resources is \fIMwm*\fP \fBscreen_name\fP\fI*\fP\fBresource_id\fP For example, \fIMwm*1*keyBindings\fP specifies
879 the key bindings to use for screen "1"\&.
880 .SS "Screen Specific Resources"
881 .TS
882 tab();
883 lw(1.768627i) lw(1.790196i) lw(0.927451i) lw(1.013725i).
884 NameClassValue TypeDefault
885 buttonBindingsButtonBindingsstringDefaultButtonBindings
886 cleanTextCleanTextT/FT
887 fadeNormalIconFadeNormalIconT/FF
888 feedbackGeometryFeedbackGeometrystringcenter on screen
889 frameBorderWidthFrameBorderWidthpixelsvaries
890 iconBoxGeometryIconBoxGeometrystring6x1+0-0
891 iconBoxNameIconBoxNamestringiconbox
892 iconBoxSBDisplayPolicyIconBoxSBDisplayPolicystringall
893 iconBoxTitleIconBoxTitleXmStringIcons
894 iconDecorationIconDecorationstringvaries
895 iconImageMaximumIconImageMaximumwxh48x48
896 iconImageMinimumIconImageMinimumwxh16x16
897 iconPlacementIconPlacementstringleft bottom
898 iconPlacementMarginIconPlacementMarginpixelsvaries
899 keyBindingsKeyBindingsstringDefaultKeyBindings
900 limitResizeLimitResizeT/FT
901 maximumMaximumSizeMaximumMaximumSizewxh (pixels)2X screen w&h
902 moveOpaqueMoveOpaqueT/FF
903 resizeBorderWidthResizeBorderWidthpixelsvaries
904 resizeCursorsResizeCursorsT/FT
905 transientDecorationTransientDecorationstringmenu title
906 transientFunctionsTransientFunctionsstringT{
907 -minimize-maximize
908 T}
909 useIconBoxUseIconBoxT/FF
910 .TE
911 .IP "\fIbuttonBindings\fP\ (class\ \fIButtonBindings\fP)" 10
912 This resource identifies the set of button bindings for window management
913 functions\&. The named set of button bindings is specified in the \fBmwm\fP resource description file\&. These button bindings are \fBmerged\fP with the built-in default bindings\&. The default value for
914 this resource is "DefaultButtonBindings"\&.
915 .IP "\fIcleanText\fP\ (class\ \fICleanText\fP)" 10
916 This resource controls the display of window manager text in the client
917 title and feedback windows\&. If the default value of True is used, the text
918 is drawn with a clear (no stipple) background\&. This makes text easier to read
919 on monochrome systems where a backgroundPixmap is specified\&. Only the stippling
920 in the area immediately around the text is cleared\&. If False, the text is
921 drawn directly on top of the existing background\&.
922 .IP "\fIfadeNormalIcon\fP\ (class\ \fIFadeNormalIcon\fP)" 10
923 If this resource is given a value of True, an icon is grayed out whenever
924 it has been normalized (its window has been opened)\&. The default value is
925 False\&.
926 .IP "\fIfeedbackGeometry\fP\ (class\ \fIFeedbackGeometry\fP)" 10
927 This resource sets the position of the move and resize feedback window\&.
928 If this resource is not specified, the default is to place the feedback window
929 at the center of the screen\&. The value of the resource is a standard window
930 geometry string with the following syntax: [\fI=\fP]{ \fI+-\fP}\fBxoffset\fP{\fI+-\fP} \fByoffset\fP]
931 .IP "\fIframeBorderWidth\fP\ (class\ \fIFrameBorderWidth\fP)" 10
932 This resource specifies the width (in pixels) of a client window frame
933 border without resize handles\&. The border width includes the 3-D shadows\&.
934 The default value is based on the size and resolution of the screen\&.
935 .IP "\fIiconBoxGeometry\fP\ (class\ \fIIconBoxGeometry\fP)" 10
936 This resource indicates the initial position and size of the icon box\&.
937 The value of the resource is a standard window geometry string with the following
938 syntax: [\fI=\fP][\fBwidth\fP \fIx\fP\fBheight\fP][{\fI+-\fP}\fBxoffset\fP {\fI+-\fP}\fByoffset\fP] If the offsets
939 are not provided, the iconPlacement policy is used to determine the initial
940 placement\&. The units for width and height are columns and rows\&. The actual
941 screen size of the icon box window depends on the iconImageMaximum (size)
942 and \fIiconDecoration\fP resources\&. The default value for size
943 is (6 * iconWidth + padding) wide by (1 * iconHeight + padding) high\&. The
944 default value of the location is +0 -0\&.
945 .IP "\fIiconBoxName\fP\ (class\ \fIIconBoxName\fP)" 10
946 This resource specifies the name that is used to look up icon box resources\&.
947 The default name is iconbox\&.
948 .IP "\fIiconBoxSBDisplayPolicy\fP\ (class\ \fIIconBoxSBDisplayPolicy\fP)" 10
949 This resource specifies the scroll bar display policy of the window
950 manager in the icon box\&. The resource has three possible values: all, vertical,
951 and horizontal\&. The default value, "all", causes both vertical and horizontal
952 scroll bars always to appear\&. The value "vertical" causes a single vertical
953 scroll bar to appear in the icon box and sets the orientation of the icon
954 box to horizontal (regardless of the iconBoxGeometry specification)\&. The value
955 "horizontal" causes a single horizontal scroll bar to appear in the icon box
956 and sets the orientation of the icon box to vertical (regardless of the iconBoxGeometry
957 specification)\&.
958 .IP "\fIiconBoxTitle\fP\ (class\ \fIIconBoxTitle\fP)" 10
959 This resource specifies the name that is used in the title area of the
960 icon box frame\&. The default value is Icons\&.
961 .IP "\fIiconDecoration\fP\ (class\ \fIIconDecoration\fP)" 10
962 This resource specifies the general icon decoration\&. The resource value
963 is label (only the label part is displayed) or image (only the image part
964 is displayed) or label image (both the label and image parts are displayed)\&.
965 A value of activelabel can also be specified to get a label (not truncated
966 to the width of the icon) when the icon is selected\&. The default icon decoration
967 for icon box icons is that each icon has a label part and an image part (label
968 image)\&. The default icon decoration for stand alone icons is that each icon
969 has an active label part, a label part, and an image part (activelabel label
970 image)\&.
971 .IP "\fIiconImageMaximum\fP\ (class\ \fIIconImageMaximum\fP)" 10
972 This resource specifies the maximum size of the icon image\&. The resource
973 value is \fBwidth\fP\fIx\fP \fBheight\fP (for example, 64x64)\&. The maximum supported size is 128x128\&.
974 The default value of this resource is 50x50\&.
975 .IP "\fIiconImageMinimum\fP\ (class\ \fIIconImageMinimum\fP)" 10
976 This resource specifies the minimum size of the icon image\&. The resource
977 value is \fBwidth\fP\fIx\fP \fBheight\fP (for example, 32x50)\&. The minimum supported size is 16x16\&.
978 The default value of this resource is 16x16\&.
979 .IP "\fIiconPlacement\fP\ (class\ \fIIconPlacement\fP)" 10
980 This resource specifies the icon placement scheme to be used\&. The resource
981 value has the following syntax:
982 .IP "" 10
983 \fBprimary_layout secondary_layout [tight]\fP
984 .PP
985 The layout values are one of the following:
986 .TS
987 tab();
988 lw(0.796053i) lw(4.703947i).
989 ValueDescription
990 topLay the icons out top to bottom\&.
991 bottomLay the icons out bottom to top\&.
992 leftLay the icons out left to right\&.
993 rightLay the icons out right to left\&.
994 .TE
995 .PP
996 A horizontal (vertical) layout value should not be used for both the \fBprimary_layout\fP and the \fBsecondary_layout\fP (for
997 example, don\&'t use top for the \fBprimary_layout\fP and bottom
998 for the \fBsecondary_layout\fP)\&.
999 .PP
1000 The \fBprimary_layout\fP indicates whether, when an icon
1001 placement is done, the icon is placed in a row or a column and the direction
1002 of placement\&. The \fBsecondary_layout\fP indicates where to place
1003 new rows or columns\&. For example, top right indicates that icons should be
1004 placed top to bottom on the screen and that columns should be added from right
1005 to left on the screen\&.
1006 .PP
1007 The default placement is left bottom (icons are placed left to right
1008 on the screen, with the first row on the bottom of the screen, and new rows
1009 added from the bottom of the screen to the top of the screen)\&. A \fBtight\fP value places icons with zero spacing in between icons\&. This
1010 value is useful for aesthetic reasons, as well as X-terminals with small screens\&.
1011 .IP "\fIiconPlacementMargin\fP\ (class\ \fIIconPlacementMargin\fP)" 10
1012 This resource sets the distance between the edge of the screen and the
1013 icons that are placed along the edge of the screen\&. The value should be greater
1014 than or equal to 0\&. A default value (see below) is used if the value specified
1015 is invalid\&. The default value for this resource is equal to the space between
1016 icons as they are placed on the screen (this space is based on maximizing
1017 the number of icons in each row and column)\&.
1018 .IP "\fIkeyBindings\fP\ (class\ \fIKeyBindings\fP)" 10
1019 This resource identifies the set of key bindings for window management
1020 functions\&. If specified, these key bindings \fBreplace\fP the
1021 built-in default bindings\&. The named set of key bindings is specified in \fBmwm\fP resource description file\&. The default value for this resource
1022 is "DefaultKeyBindings"\&.
1023 .IP "\fIlimitResize\fP\ (class\ \fILimitResize\fP)" 10
1024 If this resource is True, the user is not allowed to resize a window
1025 to greater than the maximum size\&. The default value for this resource is True\&.
1026 .IP "\fImaximumMaximumSize\fP\ (class\ \fIMaximumMaximumSize\fP)" 10
1027 This resource is used to limit the maximum size of a client window as
1028 set by the user or client\&. The resource value is \fBwidth\fP\fIx\fP\fBheight\fP (for example, 1024x1024)
1029 where the width and height are in pixels\&. The default value of this resource
1030 is twice the screen width and height\&.
1031 .IP "\fImoveOpaque\fP\ (class\ \fIMoveOpaque\fP)" 10
1032 This resource controls whether the actual window is moved or a rectangular
1033 outline of the window is moved\&. A default value of False displays a rectangular
1034 outline on moves\&.
1035 .IP "\fIresizeBorderWidth\fP\ (class\ \fIResizeBorderWidth\fP)" 10
1036 This resource specifies the width (in pixels) of a client window frame
1037 border with resize handles\&. The specified border width includes the 3-D shadows\&.
1038 The default value is based on the size and resolution of the screen\&.
1039 .IP "\fIresizeCursors\fP\ (class\ \fIResizeCursors\fP)" 10
1040 This is used to indicate whether the resize cursors are always displayed
1041 when the pointer is in the window size border\&. If True, the cursors are shown,
1042 otherwise the window manager cursor is shown\&. The default value is True\&.
1043 .IP "\fItransientDecoration\fP\ (class\ \fITransientDecoration\fP)" 10
1044 This controls the amount of decoration that \fBmwm\fP
1045 puts on transient windows\&. The decoration specification is exactly the same
1046 as for the \fIclientDecoration\fP (client specific) resource\&.
1047 Transient windows are identified by the \fIWM_TRANSIENT_FOR\fP
1048 property, which is added by the client to indicate a relatively temporary
1049 window\&. The default value for this resource is menu title (that is, transient
1050 windows have frame borders and a titlebar with a window menu button)\&.
1051 .IP "" 10
1052 An application can also specify which decorations \fBmwm\fP
1053 should apply to its windows\&. If it does so, \fBmwm\fP applies
1054 only those decorations indicated by both the application and the \fItransientDecoration\fP resource\&. Otherwise, \fBmwm\fP
1055 applies the decorations indicated by the \fItransientDecoration\fP
1056 resource\&. For more information see the description of \fBXmNmwmDecorations\fP on the \fBVendorShell\fP(3)
1057 reference page\&.
1058 .IP "\fItransientFunctions\fP\ (class\ \fITransientFunctions\fP)" 10
1059 This resource is used to indicate which window management functions
1060 are applicable (or not applicable) to transient windows\&. The function specification
1061 is exactly the same as for the \fIclientFunctions\fP (client
1062 specific) resource\&. The default value for this resource is -minimize -maximize\&.
1063 .IP "" 10
1064 An application can also specify which functions \fBmwm\fP
1065 should apply to its windows\&. If it does so, \fBmwm\fP applies
1066 only those functions indicated by both the application and the \fItransientFunctions\fP resource\&. Otherwise, \fBmwm\fP
1067 applies the functions indicated by the \fItransientFunctions\fP
1068 resource\&. For more information see the description of \fBXmNmwmFunctions\fP on the \fBVendorShell\fP(3) reference
1069 page\&.
1070 .IP "\fIuseIconBox\fP\ (class\ \fIUseIconBox\fP)" 10
1071 If this resource is given a value of True, icons are placed in an icon
1072 box\&. When an icon box is not used, the icons are placed on the root window
1073 (default value)\&.
1074 .SS "Client Specific Resources"
1075 .PP
1076 The syntax for specifying client specific resources is
1077 .PP
1078 \fIMwm*\fP\fBclient_name_or_class\fP \fI*\fP\fBresource_id\fP
1079 .PP
1080 For example, \fIMwm*mterm*windowMenu\fP is used to specify
1081 the window menu to be used with mterm clients\&. The syntax for specifying client
1082 specific resources for all classes of clients is
1083 .PP
1084 \fIMwm*\fP\fBresource_id\fP
1085 .PP
1086 Specific client specifications take precedence over the specifications
1087 for all clients\&. For example, \fIMwm*windowMenu\fP is used
1088 to specify the window menu to be used for all classes of clients that don\&'t
1089 have a window menu specified\&.
1090 .PP
1091 The syntax for specifying resource values for windows that have an unknown
1092 name and class (that is, windows that do not have a \fBWM_CLASS\fP
1093 property associated with them) is
1094 .PP
1095 \fIMwm*defaults*\fP\fBresource_id\fP
1096 .PP
1097 For example, \fIMwm*defaults*iconImage\fP is used to
1098 specify the icon image to be used for windows that have an unknown name and
1099 class\&.
1100 .PP
1101 The following client specific resources can be specified:
1102 .SS "Client Specific Resources"
1103 .TS
1104 tab();
1105 lw(1.999018i) lw(1.458743i) lw(0.918468i) lw(1.123772i).
1106 NameClassValue TypeDefault
1107 clientDecorationClientDecorationstringall\&.
1108 clientFunctionsClientFunctionsstringall\&.
1109 focusAutoRaiseFocusAutoRaiseT/Fvaries
1110 iconImageIconImagepathname(image)
1111 iconImage-Backgroundcoloricon background
1112 Background
1113 iconImageBottom-Foregroundcoloricon
1114 ShadowColorbottom shadow
1115 iconImageBottom-BottomShadow-coloricon bottom
1116 ShadowPixmapPixmapshadow pixmap
1117 iconImageForegroundForegroundcolorvaries
1118 iconImageTopShadowColorBackgroundcoloricon top
1119 shadow color
1120 iconImageTop-TopShadowPixmapcoloricon top
1121 ShadowPixmapshadow pixmap
1122 matteBackgroundBackgroundcolorbackground
1123 matteBottom-Foregroundcolorbottom
1124 ShadowColorshadow color
1125 matteBottom-BottomShadow-colorbottom
1126 ShadowPixmapPixmapshadow pixmap
1127 matteForegroundForegroundcolorforeground
1128 matteTopShadowColorBackgroundcolortop
1129 shadow color
1130 matteTopShadowPixmapTopShadowPixmapcolortop
1131 shadow pixmap
1132 matteWidthMatteWidthpixels0
1133 maximumClientSizeMaximumClientSizewxh
1134 vertical horizontalfill the screen
1135 useClientIconUseClientIconT/FT
1136 usePPositionUsePPositionstringnonzero
1137 windowMenuWindowMenustringDefaultWindowMenu
1138 .TE
1139 .IP "\fIclientDecoration\fP\ (class\ \fIClientDecoration\fP)" 10
1140 This resource controls the amount of window frame decoration\&. The resource
1141 is specified as a list of decorations to specify their inclusion in the frame\&.
1142 If a decoration is preceded by a minus sign, that decoration is excluded from
1143 the frame\&. The \fBsign\fP of the first item in the list determines
1144 the initial amount of decoration\&. If the sign of the first decoration is minus, \fBmwm\fP assumes all decorations are present and starts subtracting
1145 from that set\&. If the sign of the first decoration is plus (or not specified),
1146 then \fBmwm\fP starts with no decoration and builds up a list
1147 from the resource\&.
1148 .IP "" 10
1149 An application can also specify which decorations \fBmwm\fP
1150 should apply to its windows\&. If it does so, \fBmwm\fP applies
1151 only those decorations indicated by both the application and the \fIclientDecoration\fP resource\&. Otherwise, \fBmwm\fP applies
1152 the decorations indicated by the \fIclientDecoration\fP resource\&.
1153 For more information see the description of \fBXmNmwmDecorations\fP on the \fBVendorShell\fP(3) reference
1154 page\&.
1155 .TS
1156 tab();
1157 lw(0.989035i) lw(4.510965i).
1158 NameDescription
1159 allT{
1160 Include all decorations (default value)\&.
1161 T}
1162 borderWindow border\&.
1163 maximizeT{
1164 Maximize button (includes title bar)\&.
1165 T}
1166 minimizeT{
1167 Minimize button (includes title bar)\&.
1168 T}
1169 noneNo decorations\&.
1170 resizehT{
1171 Border resize handles (includes border)\&.
1172 T}
1173 menuT{
1174 Window menu button (includes title bar)\&.
1175 T}
1176 titleTitle bar (includes border)\&.
1177 .TE
1178 .PP
1179 Examples: \fIMwm*XClock\&.clientDecoration: -resizeh -maximize\fP This removes the resize handles and maximize button from XClock
1180 windows\&. \fIMwm*XClock\&.clientDecoration: menu minimize border\fP This does the same thing as above\&. Note that either \fImenu\fP or \fIminimize\fP implies
1181 \fItitle\fP\&.
1182 .IP "\fIclientFunctions\fP\ (class\ \fIClientFunctions\fP)" 10
1183 This resource is used to indicate which \fBmwm\fP functions
1184 are applicable (or not applicable) to the client window\&. The value for the
1185 resource is a list of functions\&. If the first function in the list has a minus
1186 sign in front of it, then \fBmwm\fP starts with all functions
1187 and subtracts from that set\&. If the first function in the list has a plus
1188 sign in front of it, then \fBmwm\fP starts with no functions
1189 and builds up a list\&. Each function in the list must be preceded by the appropriate
1190 plus or minus sign and separated from the next function by a space\&.
1191 .IP "" 10
1192 An application can also specify which functions \fBmwm\fP
1193 should apply to its windows\&. If it does so, \fBmwm\fP applies
1194 only those functions indicated by both the application and the \fIclientFunctions\fP resource\&. Otherwise, \fBmwm\fP applies
1195 the functions indicated by the \fIclientFunctions\fP resource\&.
1196 For more information see the description of \fBXmNmwmFunctions\fP on the \fBVendorShell\fP(3) reference
1197 page\&.
1198 .PP
1199 The following table lists the functions available for this resource:
1200 .TS
1201 tab();
1202 lw(0.928728i) lw(4.571272i).
1203 NameDescription
1204 allT{
1205 Include all functions (default value)\&.
1206 T}
1207 noneNo functions\&.
1208 resizef\&.resize\(dg\&.
1209 movef\&.move\(dg\&.
1210 minimizef\&.minimize\(dg\&.
1211 maximizef\&.maximize\(dg\&.
1212 closef\&.kill\(dg\&.
1213 .TE
1214 .PP
1215 \(dgSee \fBmwmrc\fP(4)\&.
1216 .IP "\fIfocusAutoRaise\fP\ (class\ \fIFocusAutoRaise\fP)" 10
1217 When the value of this resource is True, clients are raised when they
1218 get the keyboard input focus\&. If the value is False, the stacking of windows
1219 on the display is not changed when a window gets the keyboard input focus\&.
1220 The default value is True when the keyboardFocusPolicy is explicit and False
1221 when the keyboardFocusPolicy is pointer\&.
1222 .IP "\fIiconImage\fP\ (class\ \fIIconImage\fP)" 10
1223 This resource can be used to specify an icon image for a client (for
1224 example, "Mwm*myclock*iconImage")\&. The resource value is a pathname for a
1225 pixmap or bitmap file\&. The value of the (client specific) \fIuseClientIcon\fP resource is used to determine whether or not user supplied icon
1226 images are used instead of client supplied icon images\&. The default value
1227 is to display a built-in window manager icon image\&.
1228 .IP "\fIiconImageBackground\fP\ (class\ \fIBackground\fP)" 10
1229 This resource specifies the background color of the icon image that
1230 is displayed in the image part of an icon\&. The default value of this resource
1231 is the icon background color (that is, specified by "Mwm*background or Mwm*icon*background)\&.
1232 .IP "\fIiconImageBottomShadowColor\fP\ (class\ \fIForeground\fP)" 10
1233 This resource specifies the bottom shadow color of the icon image that
1234 is displayed in the image part of an icon\&. The default value of this resource
1235 is the icon bottom shadow color (that is, specified by Mwm*icon*bottomShadowColor)\&.
1236 .IP "\fIiconImageBottomShadowPixmap\fP\ (class\ \fIBottomShadowPixmap\fP)" 10
1237 This resource specifies the bottom shadow Pixmap of the icon image that
1238 is displayed in the image part of an icon\&. The default value of this resource
1239 is the icon bottom shadow Pixmap (that is, specified by Mwm*icon*bottomShadowPixmap)\&.
1240 .IP "\fIiconImageForeground\fP\ (class\ \fIForeground\fP)" 10
1241 This resource specifies the foreground color of the icon image that
1242 is displayed in the image part of an icon\&. The default value of this resource
1243 varies depending on the icon background\&.
1244 .IP "\fIiconImageTopShadowColor\fP\ (class\ \fIBackground\fP)" 10
1245 This resource specifies the top shadow color of the icon image that
1246 is displayed in the image part of an icon\&. The default value of this resource
1247 is the icon top shadow color (that is, specified by Mwm*icon*topShadowColor)\&.
1248 .IP "\fIiconImageTopShadowPixmap\fP\ (class\ \fITopShadowPixmap\fP)" 10
1249 This resource specifies the top shadow Pixmap of the icon image that
1250 is displayed in the image part of an icon\&. The default value of this resource
1251 is the icon top shadow pixmap (that is, specified by Mwm*icon*topShadowPixmap)\&.
1252 .IP "\fImatteBackground\fP\ \ (class\ \fIBackground\fP)" 10
1253 This resource specifies the background color of the matte, when \fImatteWidth\fP is positive\&. The default value of this resource is the
1254 client background color (that is, specified by "Mwm*background or Mwm*client*background)\&.
1255 .IP "\fImatteBottomShadowColor\fP\ (class\ \fIForeground\fP)" 10
1256 This resource specifies the bottom shadow color of the matte, when \fImatteWidth\fP is positive\&. The default value of this resource is the
1257 client bottom shadow color (that is, specified by Mwm*bottomShadowColor or
1258 Mwm*client*bottomShadowColor)\&.
1259 .IP "\fImatteBottomShadowPixmap\fP\ (class\ \fIBottomShadowPixmap\fP)" 10
1260 This resource specifies the bottom shadow Pixmap of the matte, when \fImatteWidth\fP is positive\&. The default value of this resource is the
1261 client bottom shadow pixmap (that is, specified by Mwm*bottomShadowPixmap
1262 or Mwm*client*bottomShadowPixmap)\&.
1263 .IP "\fImatteForeground\fP\ (class\ \fIForeground\fP)" 10
1264 This resource specifies the foreground color of the matte, when \fImatteWidth\fP is positive\&. The default value of this resource is the
1265 client foreground color (that is, specified by Mwm*foreground or Mwm*client*foreground)\&.
1266 .IP "\fImatteTopShadowColor\fP\ (class\ \fIBackground\fP)" 10
1267 This resource specifies the top shadow color of the matte, when \fImatteWidth\fP is positive\&. The default value of this resource is the
1268 client top shadow color (that is, specified by Mwm*topShadowColor or Mwm*client*topShadowColor)\&.
1269 .IP "\fImatteTopShadowPixmap\fP\ (class\ \fITopShadowPixmap\fP)" 10
1270 This resource specifies the top shadow pixmap of the matte, when \fImatteWidth\fP is positive\&. The default value of this resource is the
1271 client top shadow pixmap (that is, specified by "Mwm*topShadowPixmap or Mwm*client*topShadowPixmap)\&.
1272 .IP "\fImatteWidth\fP\ (class\ \fIMatteWidth\fP)" 10
1273 This resource specifies the width of the optional matte\&. The default
1274 value is 0, which effectively disables the matte\&.
1275 .IP "\fImaximumClientSize\fP\ (class\ \fIMaximumClientSize\fP)" 10
1276 This resource is either a size specification or a direction that indicates
1277 how a client window is to be maximized\&. The resource value can be specified
1278 as a size specification \fBwidth\fP\fIx\fP\fBheight\fP\&. The width and height are interpreted in
1279 the units that the client uses (for example, for terminal emulators this is
1280 generally characters)\&. Alternately, "vertical" or "horizontal" can be specified
1281 to indicate the direction in which the client maximizes\&.
1282 .IP "" 10
1283 If this resource is not specified, the maximum size from the \fIWM_NORMAL_HINTS\fP property is used if set\&. Otherwise the default
1284 value is the size where the client window with window management borders fills
1285 the screen\&. When the maximum client size is not determined by the \fImaximumClientSize\fP resource, the \fImaximumMaximumSize\fP
1286 resource value is used as a constraint on the maximum size\&.
1287 .IP "\fIuseClientIcon\fP\ (class\ \fIUseClientIcon\fP)" 10
1288 If the value given for this resource is True, a client-supplied icon
1289 image takes precedence over a user-supplied icon image\&. The default value
1290 is True, giving the client-supplied icon image higher precedence than the
1291 user-supplied icon image\&.
1292 .IP "\fIusePPosition\fP\ (class\ \fIUsePPosition\fP)" 10
1293 This resource specifies whether Mwm honors program specified position \fBPPosition\fP specified in the \fIWM_NORMAL_HINTS\fP property in the absence of an user specified position\&. Setting
1294 this resource to on, causes \fBmwm\fP to always honor program
1295 specified position\&. Setting this resource to off, causes \fBmwm\fP
1296 to always ignore program specified position\&. Setting this resource to the
1297 default value of nonzero cause \fBmwm\fP to honor program specified
1298 position other than (0,0)\&.
1299 .IP "\fIwindowMenu\fP\ (class\ \fIWindowMenu\fP)" 10
1300 This resource indicates the name of the menu pane that is posted when
1301 the window menu is popped up (usually by pressing button 1 on the window
1302 menu button on the client window frame)\&. Menu panes are specified in the \fBmwm\fP resource description file\&. Window menus can be customized on
1303 a client class basis by creating custom menus in your \fBmwmrc\fP
1304 file (see \fBmwmrc\fP(4) and specifying resources to activate
1305 the custom menus\&. The resources have the form \fIMwm*\fP \fBclient_name_or_class\fP\fI*windowMenu\fP\&. The default
1306 value of this resource is DefaultWindowMenu\&.
1307 .SS "Resource Description File"
1308 .PP
1309 The \fBmwm\fP resource description file is a supplementary
1310 resource file that contains resource descriptions that are referred to by
1311 entries in the resource manager property (see \fBxrdb\fP(1) and
1312 the defaults files (\fB\&.Xdefaults\fP, \fBapp-defaults/Mwm\fP )\&. It contains descriptions of resources that are to be used by \fBmwm\fP, and that cannot be easily encoded in the defaults files (a
1313 bitmap file is an analogous type of resource description file)\&. A particular \fBmwm\fP resource description file can be selected using the
1314 \fIconfigFile\fP resource\&.
1315 .PP
1316 The following types of resources can be described in the \fBmwm\fP resource description file:
1317 .IP "\fIButtons\fP" 10
1318 Window manager functions can be bound (associated) with button events\&.
1319 .IP "\fIKeys\fP" 10
1320 Window manager functions can be bound (associated) with key press events\&.
1321 .IP "\fIMenus\fP" 10
1322 Menu panes can be used for the window menu and other menus posted with
1323 key bindings and button bindings\&.
1324 .IP "" 10
1325 The \fBmwm\fP resource description file is described in \fBmwmrc\fP(4)\&.
1326 .SS "Environment"
1327 .PP
1328 The \fBmwm\fP window manager uses the environment variable \fBHOME\fP specifying the user\&'s home directory\&.
1329 .PP
1330 The \fBmwm\fP window manager uses the environment variable \fBLANG\fP specifying the user\&'s choice of language
1331 for the \fBmwm\fP message catalog and the \fBmwm\fP
1332 resource description file\&.
1333 .PP
1334 The \fBmwm\fP window uses the environment variable \fBXFILESEARCHPATH\fP, \fBXUSERFILESEARCHPATH\fP, \fBXAPPLRESDIR\fP, \fBXENVIRONMENT\fP, \fBLANG\fP, and \fBHOME\fP in determining search paths for resource defaults files\&.
1335 The \fBmwm\fP window manager may also us \fBXBMLANGPATH\fP to search for bitmap files\&.
1336 .PP
1337 The \fBmwm\fP window manager reads the \fB$HOME/\&.motifbind\fP
1338 file if it exists to install a virtual key bindings property on
1339 the root window\&. For more information on the content of the \fB\&.motifbind\fP file, see
1340 .PP
1341 The \fBmwm\fP window manager uses the environment variable
1342 \fBMWMSHELL\fP (or \fBSHELL\fP, \fIif\fP \fBMWMSHELL\fP is not set), specifying
1343 the shell to use when executing commands via the \fBf\&.exec\fP
1344 function\&.
1345 .SS "Files"
1346 .PP
1347 \fB/usr/X11R6/lib/X11/$LANG/system\&.mwmrc\fP
1348 .PP
1349 \fB/usr/X11R6/lib/X11/system\&.mwmrc\fP
1350 .PP
1351 \fB/usr/X11R6/lib/X11/app-defaults/Mwm\fP
1352 .PP
1353 \fB$HOME/Mwm\fP
1354 .PP
1355 \fB$HOME/$LANG/\&.mwmrc\fP
1356 .PP
1357 \fB$HOME/\&.mwmrc\fP
1358 .SS "RELATED INFORMATION"
1359 .PP
1360 \fBVendorShell\fP(3), \fBVirtualBindings\fP(3), \fBX\fP(1), \fBXmInstallImage\fP(3), \fBxrdb\fP(1)\&.
1361 ...\" created by instant / docbook-to-man, Sun 22 Dec 1996, 20:15