1mwm(user cmd) mwm(user cmd)
2
3
4
6 mwm — The Motif Window Manager
7
9 mwm [options]
10
12 The mwm window manager provides functions that facilitate control (by
13 the user and the programmer) of elements of window state such as place‐
14 ment, size, icon/normal display, and input-focus ownership.
15
16 The stand-alone window manager is not an integral part of CDE and does
17 not support communication with other components in the CDE environment,
18 such as the Style Manager and the Session Manager.
19
20 Options
21 -display display
22 This option specifies the display to use; see X(1).
23
24 -xrm resourcestring
25 This option specifies a resource string to use.
26
27 -multiscreen
28 This option causes mwm to manage all screens on the display.
29 The default is to manage only a single screen.
30
31 -name name
32 This option causes mwm to retrieve its resources using the
33 specified name, as in name*resource.
34
35 -screens name [name [...]]
36 This option specifies the resource names to use for the
37 screens managed by mwm. If mwm is managing a single screen,
38 only the first name in the list is used. If mwm is managing
39 multiple screens, the names are assigned to the screens in
40 order, starting with screen 0. Screen 0 gets the first name,
41 screen 1 the second name, and so on.
42
43 Appearance
44 The following sections describe the basic default behaviors of windows,
45 icons, the icon box, input focus, and window stacking. The appearance
46 and behavior of the window manager can be altered by changing the con‐
47 figuration of specific resources. Resources are defined under the head‐
48 ing "X DEFAULTS."
49
50 Screens
51 By default, mwm manages only the single screen specified by the -dis‐
52 play option or the DISPLAY environment variable (by default, screen 0).
53 If the -multiscreen option is specified or if the multiScreen resource
54 is True, mwm tries to manage all the screens on the display.
55
56 When mwm is managing multiple screens, the -screens option can be used
57 to give each screen a unique resource name. The names are separated by
58 blanks, for example, -screens scr0 scr1. If there are more screens than
59 names, resources for the remaining screens will be retrieved using the
60 first name. By default, the screen number is used for the screen name.
61
62 Windows
63 Default mwm window frames have distinct components with associated
64 functions:
65
66 Title Area
67 In addition to displaying the client's title, the title area
68 is used to move the window. To move the window, place the
69 pointer over the title area, press button 1 and drag the win‐
70 dow to a new location. By default, a wire frame is moved dur‐
71 ing the drag to indicate the new location. When the button is
72 released, the window is moved to the new location.
73
74 Title Bar The title bar includes the title area, the minimize button,
75 the maximize button, and the window menu button. In shaped
76 windows, such as round windows, the title bar floats above
77 the window.
78
79 Minimize Button
80 To turn the window into an icon, click button 1 on the mini‐
81 mize button (the frame box with a small square in it).
82
83 Maximize Button
84 To make the window fill the screen (or enlarge to the largest
85 size allowed by the configuration files), click button 1 on
86 the maximize button (the frame box with a large square in
87 it).
88
89 Window Menu Button
90 The window menu button is the frame box with a horizontal bar
91 in it. To pull down the window menu, press button 1. While
92 pressing, drag the pointer on the menu to your selection,
93 then release the button when your selection is highlighted.
94 Pressing button 3 in the title bar or resize border handles
95 also posts the window menu. Alternately, you can click button
96 1 to pull down the menu and keep it posted; then position the
97 pointer and select. You can also post the window menu by
98 pressing <Shift> <Esc> or <Alt> <Space>. Double-clicking
99 button 1 with the pointer on the window menu button closes
100 the window.
101
102 The following table lists the contents of the window menu.
103
104 Default Window Menu
105 Selection Accelerator Description
106 Restore Restores the window to its size
107 before minimizing or maximizing.
108 Move Allows the window to be moved
109 with keys or mouse.
110 Size Allows the window to be resized.
111 Minimize Turns the window into an icon.
112 Maximize Makes the window fill the screen.
113 Lower Moves window to bottom of window
114 stack.
115 Close Alt+F4 Causes client to terminate.
116
117 Resize Border Handles
118 To change the size of a window, move the pointer over a
119 resize border handle (the cursor changes), press button 1,
120 and drag the window to a new size. When the button is
121 released, the window is resized. While dragging is being
122 done, a rubber-band outline is displayed to indicate the new
123 window size.
124
125 Matte An optional matte decoration can be added between the client
126 area and the window frame (see the matteWidth resource). A
127 matte is not actually part of the window frame. There is no
128 functionality associated with a matte.
129
130 Icons
131 Icons are small graphic representations of windows. A window can be
132 minimized (iconified) using the minimize button on the window frame.
133 Icons provide a way to reduce clutter on the screen.
134
135 Pressing mouse button 1 when the pointer is over an icon causes the
136 icon's window menu to pop up. Releasing the button (press + release
137 without moving mouse = click) causes the menu to stay posted. The menu
138 contains the following selections:
139
140 Icon Window Menu
141 Selection Accelerator Description
142 Restore Opens the associated window.
143 Move Allows the icon to be moved with
144 keys.
145 Size Inactive (not an option for icons).
146 Minimize Inactive (not an option for icons).
147 Maximize Opens the associated window and
148 makes it fill the screen.
149 Lower Moves icon to bottom of icon stack.
150 Close Alt+F4 Removes client from mwm management.
151
152 Note that pressing button 3 over an icon also causes the icon's window
153 menu to pop up. To make a menu selection, drag the pointer over the
154 menu and release button 3 when the desired item is highlighted.
155
156 Double-clicking button 1 on an icon invokes the f.restore_and_raise
157 function and restores the icon's associated window to its previous
158 state. For example, if a maximized window is iconified, double-clicking
159 button 1 restores it to its maximized state. Double-clicking button 1
160 on the icon box's icon opens the icon box and allows access to the con‐
161 tained icons. (In general, double-clicking a mouse button is a quick
162 way to perform a function.) Pressing <Shift> <Esc> or <Menu> (the pop-
163 up menu key) causes the icon window menu of the currently selected icon
164 to pop up.
165
166 Icon Box
167 When icons begin to clutter the screen, they can be packed into an icon
168 box. (To use an icon box, mwm must be started with the icon box config‐
169 uration already set.) The icon box is a mwm window that holds client
170 icons. It includes one or more scroll bars when there are more window
171 icons than the icon box can show at the same time.
172
173 Icons in the icon box can be manipulated with the mouse. The following
174 table summarizes the behavior of this interface. Button actions apply
175 whenever the pointer is on any part of the icon. Note that double-
176 clicking an icon in the icon box invokes the f.restore_and_raise func‐
177 tion.
178
179 Button Action Description
180 Button 1 click Selects the icon.
181 Button 1 double-click Normalizes (opens) the associated
182 window. Raises an already open win‐
183 dow to the top of the stack.
184 Button 1 drag Moves the icon.
185 Button 3 press Causes the menu for that icon to pop
186 up.
187 Button 3 drag Highlights items as the pointer
188 moves across the menu.
189
190 Pressing mouse button 3 when the pointer is over an icon causes the
191 menu for that icon to pop up.
192
193 Icon Menu for the Icon Box
194 Selection Accelerator Description
195 Restore Opens the associated window (if not
196 already open).
197 Move Allows the icon to be moved with
198 keys.
199 Size Inactive.
200 Minimize Inactive.
201 Maximize Opens the associated window (if not
202 already open) and maximizes its
203 size.
204
205 Lower Inactive.
206 Close Alt+F4 Removes client from mwm management.
207
208 To pull down the window menu for the icon box itself, press button 1
209 with the pointer over the menu button for the icon box. The window menu
210 of the icon box differs from the window menu of a client window: The
211 "Close" selection is replaced with the "PackIcons Shift+Alt+F7" selec‐
212 tion. When selected, PackIcons packs the icons in the box to achieve
213 neat rows with no empty slots.
214
215 You can also post the window menu by pressing <Shift>, <Esc> or <Alt>
216 <Space>. Pressing <Menu> (the pop-up menu key) causes the icon window
217 menu of the currently selected icon to pop up.
218
219 Input Focus
220 The mwm window manager supports (by default) a keyboard input focus
221 policy of explicit selection. This means when a window is selected to
222 get keyboard input, it continues to get keyboard input until the window
223 is withdrawn from window management, another window is explicitly
224 selected to get keyboard input, or the window is iconified. Several
225 resources control the input focus. The client window with the keyboard
226 input focus has the active window appearance with a visually distinct
227 window frame.
228
229 The following tables summarize the keyboard input focus selection
230 behavior:
231
232 Button Action Object Function Description
233 Button 1 press Window / window frame Keyboard focus selection.
234 Button 1 press Icon Keyboard focus selection.
235
236 Key Action Function Description
237 [Alt][Tab] Move input focus to next window in window
238 stack (available only in explicit focus
239 mode).
240 [Alt][Shift][Tab] Move input focus to previous window in
241 window stack (available only in explicit
242 focus mode).
243
244 Window Stacking
245 There are two types of window stacks: global window stacks and an
246 application's local family window stack.
247
248 The global stacking order of windows may be changed as a result of set‐
249 ting the keyboard input focus, iconifying a window, or performing a
250 window manager window stacking function. When keyboard focus policy is
251 explicit the default value of the focusAutoRaise resource is True. This
252 causes a window to be raised to the top of the stack when it receives
253 input focus, for example, by pressing button 1 on the title bar. The
254 key actions defined in the previous table will thus raise the window
255 receiving focus to the top of the stack.
256
257 In pointer mode, the default value of focusAutoRaise is False, that is,
258 the window stacking order is not changed when a window receives key‐
259 board input focus. The following key actions can be used to cycle
260 through the global window stack.
261
262 Key Action Function Description
263 [Alt][ESC] Place top window on bottom of stack.
264 [Alt][Shift][ESC] Place bottom window on top of stack.
265
266 By default, a window's icon is placed on the bottom of the stack when
267 the window is iconified; however, the default can be changed by the
268 lowerOnIconify resource.
269
270 Transient windows (secondary windows such a dialog boxes) stay above
271 their parent windows by default; however, an application's local family
272 stacking order may be changed to allow a transient window to be placed
273 below its parent top-level window. The following arguments show the
274 modification of the stacking order for the f.lower function.
275
276 f.lower Lowers the transient window within the family (staying above
277 the parent) and lowers the family in the global window stack.
278
279 f.lower [ within]
280 Lowers the transient window within the family (staying above
281 the parent) but does not lower the family in the global win‐
282 dow stack.
283
284 f.lower [freeFamily ]
285 Lowers the window free from its family stack (below the par‐
286 ent), but does not lower the family in the global window
287 stack.
288
289 The arguments within and freeFamily can also be used with f.raise and
290 f.raise_lower.
291
292 Session Management
293 The window manager is an X Session Management Protocol aware client. It
294 responds to SaveYourself (and other associated messages) by saving the
295 geometries of its clients to a state file. mwm can then be restarted
296 by the XSMP session manager. The default location for the state file
297 is $HOME/.mwmclientdb. This location can be overriden with the
298 resource sessionClientDB.
299
300 X Resources
301 The mwm command is configured from its resource database. This database
302 is built from the following sources. They are listed in order of prece‐
303 dence, low to high:
304
305 /usr/share/X11/app-defaults/Mwm
306
307 $HOME/Mwm
308
309 RESOURCE_MANAGER root window property or $HOME/.Xdefaults
310
311 XENVIRONMENT variable or $HOME/.Xdefaults-host
312
313 mwm command line options
314
315 The file names /usr/share/X11/app-defaults/Mwm and $HOME/Mwm represent
316 customary locations for these files. The actual location of the system-
317 wide class resource file may depend on the XFILESEARCHPATH environment
318 variable and the current language environment. The actual location of
319 the user-specific class resource file may depend on the XUSERFILE‐
320 SEARCHPATH and XAPPLRESDIR environment variables and the current lan‐
321 guage environment.
322
323 Entries in the resource database may refer to other resource files for
324 specific types of resources. These include files that contain bitmaps,
325 fonts, and mwm specific resources such as menus and behavior specifica‐
326 tions (for example, button and key bindings).
327
328 Mwm is the resource class name of mwm and mwm is the default resource
329 name used by mwm to look up resources. the -screens command line option
330 specifies resource names, such as "mwm_b+w" and "mwm_color".) In the
331 following discussion of resource specification, "Mwm" and "mwm" (and
332 the aliased mwm resource names) can be used interchangeably, but "mwm"
333 takes precedence over "Mwm".
334
335 The mwm command uses the following types of resources:
336
337 Component Appearance Resources:
338 These resources specify appearance attributes of window man‐
339 ager user interface components. They can be applied to the
340 appearance of window manager menus, feedback windows (for
341 example, the window reconfiguration feedback window), client
342 window frames, and icons.
343
344 General Appearance and Behavior Resources:
345 These resources specify mwm appearance and behavior (for
346 example, window management policies). They are not set sepa‐
347 rately for different mwm user interface components. They
348 apply to all screens and workspaces.
349
350 Screen Specific Appearance and Behavior Resources:
351 These resources specify the appearance and behavior of mwm
352 elements that are settable on a per-screen basis.
353
354 Client Specific Resources:
355 These mwm resources can be set for a particular client window
356 or class of client windows. They specify client-specific icon
357 and client window frame appearance and behavior.
358
359 Resource identifiers can be either a resource name (for example, fore‐
360 ground) or a resource class (for example, Foreground). If the value of
361 a resource is a filename and if the filename is prefixed by "~/", then
362 it is relative to the path contained in the HOME environment variable
363 (generally the user's home directory).
364
365 Component Appearance Resources
366 The syntax for specifying component appearance resources that apply to
367 window manager icons, menus, and client window frames is Mwm*
368 resource_id
369
370 For example, Mwm*foreground is used to specify the foreground color for
371 mwm menus, icons, client window frames, and feedback dialogs.
372
373 The syntax for specifying component appearance resources that apply to
374 a particular mwm component is Mwm*[menu|icon|client|feedback]
375 *resource_id
376
377 If menu is specified, the resource is applied only to mwm menus; if
378 icon is specified, the resource is applied to icons; and if client is
379 specified, the resource is applied to client window frames. For exam‐
380 ple, Mwm*icon*foreground is used to specify the foreground color for
381 mwm icons, Mwm*menu*foreground specifies the foreground color for mwm
382 menus, and Mwm*client*foreground is used to specify the foreground
383 color for mwm client window frames.
384
385 The appearance of the title area of a client window frame (including
386 window management buttons) can be separately configured. The syntax for
387 configuring the title area of a client window frame is
388 Mwm*client*title* resource_id
389
390 For example, Mwm*client*title*foreground specifies the foreground color
391 for the title area. Defaults for title area resources are based on the
392 values of the corresponding client window frame resources.
393
394 The appearance of menus can be configured based on the name of the
395 menu. The syntax for specifying menu appearance by name is Mwm*menu*
396 menu_name*resource_id
397
398 For example, Mwm*menu*my_menu*foreground specifies the foreground color
399 for the menu named my_menu. The user can also specify resources for
400 window manager menu components, that is, the gadgets that comprise the
401 menu. These may include for example, a menu title, title separator, one
402 or more buttons, and separators. If a menu contains more than one
403 instance of a class, such as multiple PushButtonGadgets, the name of
404 the first instance is "PushButtonGadget1", the second is "PushButton‐
405 Gadget2", and so on. The following list identifies the naming conven‐
406 tion used for window manager menu components:
407
408 · Menu Title LabelGadget - "TitleName"
409
410 · Menu Title SeparatorGadget - "TitleSeparator"
411
412 · CascadeButtonGadget - "CascadeButtonGadget<n>"
413
414 · PushButtonGadget - "PushButtonGadget<n>"
415
416 · SeparatorGadget - "SeparatorGadget<n>"
417
418 Refer to the man page for each class for a list of resources that can
419 be specified.
420
421 The following component appearance resources that apply to all window
422 manager parts can be specified:
423
424 Component Appearance Resources - All Window Manager Parts
425 Name Class Value Type Default
426 background Background color varies†
427 backgroundPixmap BackgroundPixmap string†† varies†
428 bottomShadowColor Foreground color varies†
429 bottomShadowPixmap Foreground string†† varies†
430 fontList FontList string††† "fixed"
431 foreground Foreground color varies†
432 saveUnder SaveUnder T/F F
433 topShadowColor Background color varies†
434 topShadowPixmap TopShadowPixmap string†† varies†
435
436 †The default is chosen based on the visual type of the screen. ††Image
437 name. See XmInstallImage(3). †††X11 X Logical Font Description
438
439 background (class Background)
440 This resource specifies the background color. Any legal X
441 color may be specified. The default value is chosen based on
442 the visual type of the screen.
443
444 backgroundPixmap (class BackgroundPixmap)
445 This resource specifies the background Pixmap of the mwm dec‐
446 oration when the window is inactive (does not have the key‐
447 board focus). The default value is chosen based on the vis‐
448 ual type of the screen.
449
450 bottomShadowColor (class Foreground)
451 This resource specifies the bottom shadow color. This color
452 is used for the lower and right bevels of the window manager
453 decoration. Any legal X color may be specified. The default
454 value is chosen based on the visual type of the screen.
455
456 bottomShadowPixmap (class BottomShadowPixmap)
457 This resource specifies the bottom shadow Pixmap. This Pixmap
458 is used for the lower and right bevels of the window manager
459 decoration. The default is chosen based on the visual type of
460 the screen.
461
462 fontList (class FontList)
463 This resource specifies the font used in the window manager
464 decoration. The character encoding of the font should match
465 the character encoding of the strings that are used. The
466 default is "fixed."
467
468 foreground (class Foreground)
469 This resource specifies the foreground color. The default is
470 chosen based on the visual type of the screen.
471
472 saveUnder (class SaveUnder)
473 This is used to indicate whether "save unders" are used for
474 mwm components. For this to have any effect, save unders must
475 be implemented by the X server. If save unders are imple‐
476 mented, the X server saves the contents of windows obscured
477 by windows that have the save under attribute set. If the
478 saveUnder resource is True, mwm will set the save under
479 attribute on the window manager frame of any client that has
480 it set. If saveUnder is False, save unders will not be used
481 on any window manager frames. The default value is False.
482
483 topShadowColor (class Background)
484 This resource specifies the top shadow color. This color is
485 used for the upper and left bevels of the window manager dec‐
486 oration. The default is chosen based on the visual type of
487 the screen.
488
489 topShadowPixmap ( class TopShadowPixmap)
490 This resource specifies the top shadow Pixmap. This Pixmap is
491 used for the upper and left bevels of the window manager dec‐
492 oration. The default is chosen based on the visual type of
493 the screen.
494
495 The following component appearance resources that apply to frame and
496 icons can be specified:
497
498 Frame and Icon Components
499 Name Class Value Type Default
500 activeBackground Background color varies†
501 activeBackgroundPixmap BackgroundPixmap string†† varies†
502 activeBottomShadowColor Foreground color varies†
503 activeBottomShadowPixmap BottomShadowPixmap string†† varies†
504 activeForeground Foreground color varies†
505 activeTopShadowColor Background color varies†
506 activeTopShadowPixmap TopShadowPixmap string†† varies†
507
508 †The default is chosen based on the visual type of the screen. ††See
509 XmInstallImage(3).
510
511 activeBackground (class Background)
512 This resource specifies the background color of the mwm deco‐
513 ration when the window is active (has the keyboard focus).
514 The default is chosen based on the visual type of the screen.
515
516 activeBackgroundPixmap (class ActiveBackgroundPixmap)
517 This resource specifies the background Pixmap of the mwm dec‐
518 oration when the window is active (has the keyboard focus).
519 The default is chosen based on the visual type of the screen.
520
521 activeBottomShadowColor (class Foreground)
522 This resource specifies the bottom shadow color of the mwm
523 decoration when the window is active (has the keyboard
524 focus). The default is chosen based on the visual type of
525 the screen.
526
527 activeBottomShadowPixmap (class BottomShadowPixmap)
528 This resource specifies the bottom shadow Pixmap of the mwm
529 decoration when the window is active (has the keyboard
530 focus). The default is chosen based on the visual type of
531 the screen.
532
533 activeForeground (class Foreground)
534 This resource specifies the foreground color of the mwm deco‐
535 ration when the window is active (has the keyboard focus).
536 The default is chosen based on the visual type of the screen.
537
538 activeTopShadowColor (class Background)
539 This resource specifies the top shadow color of the mwm deco‐
540 ration when the window is active (has the keyboard focus).
541 The default is chosen based on the visual type of the screen.
542
543 activeTopShadowPixmap (class TopShadowPixmap)
544 This resource specifies the top shadow Pixmap of the mwm dec‐
545 oration when the window is active (has the keyboard focus).
546 The default is chosen based on the visual type of the screen.
547
548 General Appearance and Behavior Resources
549 The syntax for specifying general appearance and behavior resources is
550 Mwm*resource_id
551
552 For example, Mwm*keyboardFocusPolicy specifies the window manager pol‐
553 icy for setting the keyboard focus to a particular client window.
554
555 The following general appearance and behavior resources can be speci‐
556 fied:
557
558 General Appearance and Behavior Resources
559 Name Class Value Type Default
560 autoKeyFocus AutoKeyFocus T/F T
561 autoRaiseDelay AutoRaiseDelay millisec 500
562 bitmap- Bitmap- directory /usr/include-
563 Directory Directory /X11/bitmaps
564 clientAutoPlace ClientAutoPlace T/F T
565 colormapFocus- ColormapFocus- string keyboard
566 Policy Policy
567 configFile ConfigFile file $HOME/mwmrc
568 deiconifyKeyFocus DeiconifyKeyFocus T/F T
569 doubleClick- DoubleClick- millisec. multi-click
570 Time Time time†
571 enableWarp enableWarp T/F T
572 enforceKeyFocus EnforceKeyFocus T/F T
573 frameStyle FrameStyle string recessed
574 iconAutoPlace IconAutoPlace T/F T
575 iconClick IconClick T/F T
576 interactivePlacement InteractivePlacement T/F T
577 keyboardFocus- KeyboardFocus- string explicit
578 Policy Policy
579 lowerOnIconify LowerOnIconify T/F T
580 moveThreshold MoveThreshold pixels 4
581 multiScreen MultiScreen T/F F
582 passButtons PassButtons T/F F
583 passSelectButton PassSelectButton T/F T
584 positionIsFrame PositionIsFrame T/F T
585 positionOnScreen PositionOnScreen T/F T
586 quitTimeout QuitTimeout millisec. 1000
587 raiseKeyFocus RaiseKeyFocus T/F F
588 refreshByClearing RefreshByClearing T/F T
589 rootButtonClick RootButtonClick T/F F
590 screens Screens string varies
591 sessionClientDB SessionClientDB string $HOME/.mwmclientdb
592 showFeedback ShowFeedback string all
593 startupKeyFocus StartupKeyFocus T/F T
594 wMenuButtonClick WMenuButtonClick T/F T
595 wMenuButtonClick2 WMenuButtonClick2 T/F T
596
597 †The resource doubleClickTime is included for backward compatibility.
598 Use of the Xt resource multiClickTime is preferred.
599
600 autoKeyFocus (class AutoKeyFocus)
601 This resource is available only when the keyboard input focus
602 policy is explicit. If autoKeyFocus is given a value of True,
603 then when a window with the keyboard input focus is withdrawn
604 from window management or is iconified, the focus is set to
605 the previous window that had the focus. If the value given is
606 False, there is no automatic setting of the keyboard input
607 focus. It is recommended that both autoKeyFocus and startup‐
608 KeyFocus be True to work with tear off menus. The default
609 value is True.
610
611 autoRaiseDelay (class AutoRaiseDelay)
612 This resource is available only when the focusAutoRaise
613 resource is True and the keyboard focus policy is pointer.
614 The autoRaiseDelay resource specifies the amount of time (in
615 milliseconds) that mwm will wait before raising a window
616 after it gets the keyboard focus. The default value of this
617 resource is 500 (ms).
618
619 bitmapDirectory (class BitmapDirectory)
620 This resource identifies a directory to be searched for bit‐
621 maps referenced by mwm resources. This directory is searched
622 if a bitmap is specified without an absolute pathname. The
623 default value for this resource is /usr/include/X11/bitmaps.
624 The directory /usr/include/X11/bitmaps represents the custom‐
625 ary locations for this directory. The actual location of this
626 directory may vary on some systems. If the bitmap is not
627 found in the specified directory, XBMLANGPATH is searched.
628
629 clientAutoPlace (class ClientAutoPlace)
630 This resource determines the position of a window when the
631 window has not been given a program- or user-specified posi‐
632 tion. With a value of True, windows are positioned with the
633 top left corners of the frames offset horizontally and verti‐
634 cally. A value of False causes the currently configured posi‐
635 tion of the window to be used. In either case, mwm will
636 attempt to place the windows totally on-screen. The default
637 value is True.
638
639 colormapFocusPolicy (class ColormapFocusPolicy)
640 This resource indicates the colormap focus policy that is to
641 be used. If the resource value is explicit, a colormap
642 selection action is done on a client window to set the col‐
643 ormap focus to that window. If the value is pointer, the
644 client window containing the pointer has the colormap focus.
645 If the value is keyboard, the client window that has the key‐
646 board input focus has the colormap focus. The default value
647 for this resource is keyboard.
648
649 configFile (class ConfigFile)
650 The resource value is the pathname for a mwm resource
651 description file. If the pathname begins with "~/", mwm con‐
652 siders it to be relative to the user's home directory (as
653 specified by the HOME environment variable). If the LANG
654 environment variable is set, mwm looks for $HOME/$LANG/ con‐
655 figFile. If that file does not exist or if LANG is not set,
656 mwm looks for $HOME/configFile. If the configFile pathname
657 does not begin with "~/" or "/", mwm considers it to be rela‐
658 tive to the current working directory. If the configFile
659 resource is not specified or if that file does not exist, mwm
660 uses several default paths to find a configuration file. The
661 order of the search is shown below: /etc/X11/mwm/$LANG/sys‐
662 tem.mwmrc† /etc/X11/mwm/system.mwmrc† Paths marked with '†'
663 are implementation dependent.
664
665 deiconifyKeyFocus (class DeiconifyKeyFocus)
666 This resource applies only when the keyboard input focus pol‐
667 icy is explicit. If a value of True is used, a window
668 receives the keyboard input focus when it is normalized
669 (deiconified). True is the default value.
670
671 doubleClickTime (class DoubleClickTime)
672 This resource is used to set the maximum time (in ms) between
673 the clicks (button presses) that make up a double-click. The
674 use of this resource is deprecated. Use the Xt resource mul‐
675 tiClickTime instead. The value of doubleClickTime dynami‐
676 cally defaults to the value of multiClickTime.
677
678 enableWarp (class EnableWarp)
679 The default value of this resource, True, causes mwm to warp
680 the pointer to the center of the selected window during key‐
681 board-controlled resize and move operations. Setting the
682 value to False causes mwm to leave the pointer at its origi‐
683 nal place on the screen, unless the user explicitly moves it
684 with the cursor keys or pointing device.
685
686 enforceKeyFocus (class EnforceKeyFocus)
687 If this resource is given a value of True, the keyboard input
688 focus is always explicitly set to selected windows even if
689 there is an indication that they are "globally active" input
690 windows. (An example of a globally active window is a scroll
691 bar that can be operated without setting the focus to that
692 client.) If the resource is False, the keyboard input focus
693 is not explicitly set to globally active windows. The default
694 value is True.
695
696 frameStyle (class frameStyle)
697 If this resource is given a value of "slab", the the window
698 manager frame is drawn such that the client area appears to
699 be at the same height as the top of the window frame. If the
700 resource is set to "recessed", the window frame is drawn such
701 that the client area appears lower than the top of the window
702 frame. The default value is "recessed".
703
704 iconAutoPlace (class IconAutoPlace)
705 This resource indicates whether the window manager arranges
706 icons in a particular area of the screen or places each icon
707 where the window was when it was iconified. The value True
708 indicates that icons are arranged in a particular area of the
709 screen, determined by the iconPlacement resource. The value
710 False indicates that an icon is placed at the location of the
711 window when it is iconified. The default is True.
712
713 iconClick (class IconClick)
714 When this resource is given the value of True, the system
715 menu is posted and left posted when an icon is clicked. The
716 default value is True.
717
718 interactivePlacement (class InteractivePlacement)
719 This resource controls the initial placement of new windows
720 on the screen. If the value is True, the pointer shape
721 changes before a new window is placed on the screen to indi‐
722 cate to the user that a position should be selected for the
723 upper-left hand corner of the window. If the value is False,
724 windows are placed according to the initial window configura‐
725 tion attributes. The default value of this resource is False.
726
727 keyboardFocusPolicy (class KeyboardFocusPolicy)
728 If set to pointer, the keyboard focus policy is to have the
729 keyboard focus set to the client window that contains the
730 pointer (the pointer could also be in the client window deco‐
731 ration that mwm adds). If set to explicit, the policy is to
732 have the keyboard focus set to a client window when the user
733 presses button 1 with the pointer on the client window or any
734 part of the associated mwm decoration. The default value for
735 this resource is explicit.
736
737 lowerOnIconify (class LowerOnIconify)
738 If this resource is given the default value of True, a win‐
739 dow's icon appears on the bottom of the window stack when the
740 window is minimized (iconified). A value of False places the
741 icon in the stacking order at the same place as its associ‐
742 ated window. The default value of this resource is True.
743
744 moveThreshold (class MoveThreshold)
745 This resource is used to control the sensitivity of dragging
746 operations that move windows and icons. The value of this
747 resource is the number of pixels that the locator is moved
748 with a button down before the move operation is initiated.
749 This is used to prevent window/icon movement when you click
750 or double-click and there is unintentional pointer movement
751 with the button down. The default value of this resource is
752 4 (pixels).
753
754 multiScreen (class MultiScreen)
755 This resource, if True, causes mwm to manage all the screens
756 on the display. If False, mwm manages only a single screen.
757 The default value is False.
758
759 passButtons (class PassButtons)
760 This resource indicates whether or not button press events
761 are passed to clients after they are used to do a window man‐
762 ager function in the client context. If the resource value is
763 False, the button press is not passed to the client. If the
764 value is True, the button press is passed to the client win‐
765 dow. The window manager function is done in either case. The
766 default value for this resource is False.
767
768 passSelectButton (class PassSelectButton)
769 This resource indicates whether or not to pass the select
770 button press events to clients after they are used to do a
771 window manager function in the client context. If the
772 resource value is False, then the button press will not be
773 passed to the client. If the value is True, the button press
774 is passed to the client window. The window manager function
775 is done in either case. The default value for this resource
776 is True.
777
778 positionIsFrame (class PositionIsFrame)
779 This resource indicates how client window position informa‐
780 tion (from the WM_NORMAL_HINTS property and from configura‐
781 tion requests) is to be interpreted. If the resource value is
782 True, the information is interpreted as the position of the
783 mwm client window frame. If the value is False, it is inter‐
784 preted as being the position of the client area of the win‐
785 dow. The default value of this resource is True.
786
787 positionOnScreen (class PositionOnScreen)
788 This resource is used to indicate that windows should ini‐
789 tially be placed (if possible) so that they are not clipped
790 by the edge of the screen (if the resource value is True). If
791 a window is larger than the size of the screen, at least the
792 upper-left corner of the window is on-screen. If the resource
793 value is False, windows are placed in the requested position
794 even if totally off-screen. The default value of this
795 resource is True.
796
797 quitTimeout (class QuitTimeout)
798 This resource specifies the amount of time (in milliseconds)
799 that mwm will wait for a client to update the WM_COMMAND
800 property after mwm has sent the WM_SAVE_YOURSELF message. The
801 default value of this resource is 1000 (ms). (Refer to the
802 f.kill function description for additional information.)
803
804 raiseKeyFocus (class RaiseKeyFocus)
805 This resource is available only when the keyboard input focus
806 policy is explicit. When set to True, this resource specifies
807 that a window raised by means of the f.normalize_and_raise
808 function also receives the input focus. The default value of
809 this resource is False.
810
811 refreshByClearing (class RefreshByClearing)
812 This resource determines the mechanism used to refresh a win‐
813 dow (or the screen) when the f.refresh_win (f.refresh) func‐
814 tion is executed. When set to True, an XClearArea is per‐
815 formed over the window for f.refresh_win. When set to False,
816 a covering window is created and destroyed over the top of
817 the window to be refreshed. If the function is f.refresh and
818 this resource is set to True, then an XClearArea is performed
819 over every window on the screen. If the resource is set to
820 False, then one large window covering the entire screen is
821 created and destroyed. The default value of this resource is
822 True.
823
824 rootButtonClick (class RootButtonClick)
825 The rootButtonClick resource controls whether the a click on
826 the root window will post the root menu in a "sticky" mode.
827 If this resource is set to True, a button click on the root
828 window will post the menu bound to the button down event for
829 that button in a "sticky" fashion. If this resource is set
830 to False, then the same button click would only cause the
831 menu to flash as it would be unposted once the button up
832 event is seen. The criterion used to determine if it is a
833 button click is if the pointer doesn't move between the but‐
834 ton down and button up events. The default value for this
835 resource is True.
836
837 screens (class Screens)
838 This resource specifies the resource names to use for the
839 screens managed by mwm. If mwm is managing a single screen,
840 only the first name in the list is used. If mwm is managing
841 multiple screens, the names are assigned to the screens in
842 order, starting with screen 0. Screen 0 gets the first name,
843 screen 1 the second name, and so on. The default screen names
844 are 0, 1, and so on.
845
846 sessionClientDB (class SessionClientDB)
847 This resource identifies a file name to use as a root when
848 saving state at the request of an XSMP session manager. When
849 the session is saved, the window manager will then reuse the
850 file name by automatically incrementing a suffix.
851
852 showFeedback (class ShowFeedback)
853 This resource controls whether or not feedback windows or
854 confirmation dialogs are displayed. A feedback window shows a
855 client window's initial placement and shows position and size
856 during move and resize operations. Confirmation dialogs can
857 be displayed for certain operations. The value for this
858 resource is a list of names of the feedback options to be
859 enabled or disabled; the names must be separated by a space.
860 If an option is preceded by a minus sign, that option is
861 excluded from the list. The sign of the first item in the
862 list determines the initial set of options. If the sign of
863 the first option is minus, mwm assumes all options are
864 present and starts subtracting from that set. If the sign of
865 the first decoration is plus (or not specified), mwm starts
866 with no options and builds up a list from the resource.
867
868 The names of the feedback options are shown below:
869
870 Name Description
871 all Show all feedback (Default value).
872 behavior Confirm behavior switch.
873 kill Confirm on receipt of KILL signal.
874 move Show position during move.
875 none Show no feedback.
876 placement Show position and size during initial place‐
877 ment.
878 quit Confirm quitting mwm.
879 resize Show size during resize.
880 restart Confirm mwm restart.
881
882 The following command line illustrates the syntax for showFeedback:
883
884 Mwm*showFeedback: placement resize behavior restart
885
886 This resource specification provides feedback for initial client place‐
887 ment and resize, and enables the dialog boxes to confirm the restart
888 and set behavior functions. It disables feedback for the move function.
889 The default value for this resource is all.
890
891 startupKeyFocus (class StartupKeyFocus)
892 This resource is available only when the keyboard input focus
893 policy is explicit. When given the default value of True, a
894 window gets the keyboard input focus when the window is
895 mapped (that is, initially managed by the window manager). It
896 is recommended that both autoKeyFocus and startupKeyFocus be
897 True to work with tear off menus. The default value is True.
898
899 wMenuButtonClick (class WMenuButtonClick)
900 This resource indicates whether a click of the mouse when the
901 pointer is over the window menu button posts and leaves
902 posted the window menu. If the value given this resource is
903 True, the menu remains posted. True is the default value for
904 this resource.
905
906 wMenuButtonClick2 (class WMenuButtonClick2)
907 When this resource is given the default value of True, a dou‐
908 ble-click action on the window menu button does an f.kill
909 function.
910
911 Screen Specific Appearance and Behavior Resources
912 The syntax for specifying screen specific resources is Mwm*
913 screen_name*resource_id For example, Mwm*1*keyBindings specifies the
914 key bindings to use for screen "1".
915
916 Screen Specific Resources
917 Name Class Value Type Default
918 buttonBindings ButtonBindings string DefaultButtonBindings
919 cleanText CleanText T/F T
920 fadeNormalIcon FadeNormalIcon T/F F
921 feedbackGeometry FeedbackGeometry string center on screen
922 frameBorderWidth FrameBorderWidth pixels varies
923 iconBoxGeometry IconBoxGeometry string 6x1+0-0
924 iconBoxName IconBoxName string iconbox
925 iconBoxSBDisplayPolicy IconBoxSBDisplayPolicy string all
926 iconBoxTitle IconBoxTitle XmString Icons
927 iconDecoration IconDecoration string varies
928 iconImageMaximum IconImageMaximum wxh 48x48
929 iconImageMinimum IconImageMinimum wxh 16x16
930 iconPlacement IconPlacement string left bottom
931 iconPlacementMargin IconPlacementMargin pixels varies
932 keyBindings KeyBindings string DefaultKeyBindings
933 limitResize LimitResize T/F T
934 maximumMaximumSize MaximumMaximumSize wxh (pixels) 2X screen w&h
935 moveOpaque MoveOpaque T/F F
936 resizeBorderWidth ResizeBorderWidth pixels varies
937 resizeCursors ResizeCursors T/F T
938 transientDecoration TransientDecoration string menu title
939 transientFunctions TransientFunctions string -minimize-maximize
940 useIconBox UseIconBox T/F F
941
942 buttonBindings (class ButtonBindings)
943 This resource identifies the set of button bindings for win‐
944 dow management functions. The named set of button bindings is
945 specified in the mwm resource description file. These button
946 bindings are merged with the built-in default bindings. The
947 default value for this resource is "DefaultButtonBindings".
948
949 cleanText (class CleanText)
950 This resource controls the display of window manager text in
951 the client title and feedback windows. If the default value
952 of True is used, the text is drawn with a clear (no stipple)
953 background. This makes text easier to read on monochrome sys‐
954 tems where a backgroundPixmap is specified. Only the stip‐
955 pling in the area immediately around the text is cleared. If
956 False, the text is drawn directly on top of the existing
957 background.
958
959 fadeNormalIcon (class FadeNormalIcon)
960 If this resource is given a value of True, an icon is grayed
961 out whenever it has been normalized (its window has been
962 opened). The default value is False.
963
964 feedbackGeometry (class FeedbackGeometry)
965 This resource sets the position of the move and resize feed‐
966 back window. If this resource is not specified, the default
967 is to place the feedback window at the center of the screen.
968 The value of the resource is a standard window geometry
969 string with the following syntax: [=]{ +-}xoffset{+-} yoff‐
970 set]
971
972 frameBorderWidth (class FrameBorderWidth)
973 This resource specifies the width (in pixels) of a client
974 window frame border without resize handles. The border width
975 includes the 3-D shadows. The default value is based on the
976 size and resolution of the screen.
977
978 iconBoxGeometry (class IconBoxGeometry)
979 This resource indicates the initial position and size of the
980 icon box. The value of the resource is a standard window
981 geometry string with the following syntax: [=][width
982 xheight][{+-}xoffset {+-}yoffset] If the offsets are not pro‐
983 vided, the iconPlacement policy is used to determine the ini‐
984 tial placement. The units for width and height are columns
985 and rows. The actual screen size of the icon box window
986 depends on the iconImageMaximum (size) and iconDecoration
987 resources. The default value for size is (6 * iconWidth +
988 padding) wide by (1 * iconHeight + padding) high. The default
989 value of the location is +0 -0.
990
991 iconBoxName (class IconBoxName)
992 This resource specifies the name that is used to look up icon
993 box resources. The default name is iconbox.
994
995 iconBoxSBDisplayPolicy (class IconBoxSBDisplayPolicy)
996 This resource specifies the scroll bar display policy of the
997 window manager in the icon box. The resource has three possi‐
998 ble values: all, vertical, and horizontal. The default value,
999 "all", causes both vertical and horizontal scroll bars always
1000 to appear. The value "vertical" causes a single vertical
1001 scroll bar to appear in the icon box and sets the orientation
1002 of the icon box to horizontal (regardless of the iconBoxGeom‐
1003 etry specification). The value "horizontal" causes a single
1004 horizontal scroll bar to appear in the icon box and sets the
1005 orientation of the icon box to vertical (regardless of the
1006 iconBoxGeometry specification).
1007
1008 iconBoxTitle (class IconBoxTitle)
1009 This resource specifies the name that is used in the title
1010 area of the icon box frame. The default value is Icons.
1011
1012 iconDecoration (class IconDecoration)
1013 This resource specifies the general icon decoration. The
1014 resource value is label (only the label part is displayed) or
1015 image (only the image part is displayed) or label image (both
1016 the label and image parts are displayed). A value of active‐
1017 label can also be specified to get a label (not truncated to
1018 the width of the icon) when the icon is selected. The default
1019 icon decoration for icon box icons is that each icon has a
1020 label part and an image part (label image). The default icon
1021 decoration for stand alone icons is that each icon has an
1022 active label part, a label part, and an image part (activela‐
1023 bel label image).
1024
1025 iconImageMaximum (class IconImageMaximum)
1026 This resource specifies the maximum size of the icon image.
1027 The resource value is widthx height (for example, 64x64). The
1028 maximum supported size is 128x128. The default value of this
1029 resource is 50x50.
1030
1031 iconImageMinimum (class IconImageMinimum)
1032 This resource specifies the minimum size of the icon image.
1033 The resource value is widthx height (for example, 32x50). The
1034 minimum supported size is 16x16. The default value of this
1035 resource is 16x16.
1036
1037 iconPlacement (class IconPlacement)
1038 This resource specifies the icon placement scheme to be used.
1039 The resource value has the following syntax:
1040
1041 primary_layout secondary_layout [tight]
1042
1043 The layout values are one of the following:
1044
1045 Value Description
1046 top Lay the icons out top to bottom.
1047 bottom Lay the icons out bottom to top.
1048 left Lay the icons out left to right.
1049 right Lay the icons out right to left.
1050
1051 A horizontal (vertical) layout value should not be used for both the
1052 primary_layout and the secondary_layout (for example, don't use top for
1053 the primary_layout and bottom for the secondary_layout).
1054
1055 The primary_layout indicates whether, when an icon placement is done,
1056 the icon is placed in a row or a column and the direction of placement.
1057 The secondary_layout indicates where to place new rows or columns. For
1058 example, top right indicates that icons should be placed top to bottom
1059 on the screen and that columns should be added from right to left on
1060 the screen.
1061
1062 The default placement is left bottom (icons are placed left to right on
1063 the screen, with the first row on the bottom of the screen, and new
1064 rows added from the bottom of the screen to the top of the screen). A
1065 tight value places icons with zero spacing in between icons. This value
1066 is useful for aesthetic reasons, as well as X-terminals with small
1067 screens.
1068
1069 iconPlacementMargin (class IconPlacementMargin)
1070 This resource sets the distance between the edge of the
1071 screen and the icons that are placed along the edge of the
1072 screen. The value should be greater than or equal to 0. A
1073 default value (see below) is used if the value specified is
1074 invalid. The default value for this resource is equal to the
1075 space between icons as they are placed on the screen (this
1076 space is based on maximizing the number of icons in each row
1077 and column).
1078
1079 keyBindings (class KeyBindings)
1080 This resource identifies the set of key bindings for window
1081 management functions. If specified, these key bindings
1082 replace the built-in default bindings. The named set of key
1083 bindings is specified in mwm resource description file. The
1084 default value for this resource is "DefaultKeyBindings".
1085
1086 limitResize (class LimitResize)
1087 If this resource is True, the user is not allowed to resize a
1088 window to greater than the maximum size. The default value
1089 for this resource is True.
1090
1091 maximumMaximumSize (class MaximumMaximumSize)
1092 This resource is used to limit the maximum size of a client
1093 window as set by the user or client. The resource value is
1094 widthxheight (for example, 1024x1024) where the width and
1095 height are in pixels. The default value of this resource is
1096 twice the screen width and height.
1097
1098 moveOpaque (class MoveOpaque)
1099 This resource controls whether the actual window is moved or
1100 a rectangular outline of the window is moved. A default value
1101 of False displays a rectangular outline on moves.
1102
1103 resizeBorderWidth (class ResizeBorderWidth)
1104 This resource specifies the width (in pixels) of a client
1105 window frame border with resize handles. The specified border
1106 width includes the 3-D shadows. The default value is based
1107 on the size and resolution of the screen.
1108
1109 resizeCursors (class ResizeCursors)
1110 This is used to indicate whether the resize cursors are
1111 always displayed when the pointer is in the window size bor‐
1112 der. If True, the cursors are shown, otherwise the window
1113 manager cursor is shown. The default value is True.
1114
1115 transientDecoration (class TransientDecoration)
1116 This controls the amount of decoration that mwm puts on tran‐
1117 sient windows. The decoration specification is exactly the
1118 same as for the clientDecoration (client specific) resource.
1119 Transient windows are identified by the WM_TRANSIENT_FOR
1120 property, which is added by the client to indicate a rela‐
1121 tively temporary window. The default value for this resource
1122 is menu title (that is, transient windows have frame borders
1123 and a titlebar with a window menu button).
1124
1125 An application can also specify which decorations mwm should
1126 apply to its windows. If it does so, mwm applies only those
1127 decorations indicated by both the application and the tran‐
1128 sientDecoration resource. Otherwise, mwm applies the decora‐
1129 tions indicated by the transientDecoration resource. For more
1130 information see the description of XmNmwmDecorations on the
1131 VendorShell(3) reference page.
1132
1133 transientFunctions (class TransientFunctions)
1134 This resource is used to indicate which window management
1135 functions are applicable (or not applicable) to transient
1136 windows. The function specification is exactly the same as
1137 for the clientFunctions (client specific) resource. The
1138 default value for this resource is -minimize -maximize.
1139
1140 An application can also specify which functions mwm should
1141 apply to its windows. If it does so, mwm applies only those
1142 functions indicated by both the application and the tran‐
1143 sientFunctions resource. Otherwise, mwm applies the functions
1144 indicated by the transientFunctions resource. For more infor‐
1145 mation see the description of XmNmwmFunctions on the Vendor‐
1146 Shell(3) reference page.
1147
1148 useIconBox (class UseIconBox)
1149 If this resource is given a value of True, icons are placed
1150 in an icon box. When an icon box is not used, the icons are
1151 placed on the root window (default value).
1152
1153 Client Specific Resources
1154 The syntax for specifying client specific resources is
1155
1156 Mwm*client_name_or_class *resource_id
1157
1158 For example, Mwm*mterm*windowMenu is used to specify the window menu to
1159 be used with mterm clients. The syntax for specifying client specific
1160 resources for all classes of clients is
1161
1162 Mwm*resource_id
1163
1164 Specific client specifications take precedence over the specifications
1165 for all clients. For example, Mwm*windowMenu is used to specify the
1166 window menu to be used for all classes of clients that don't have a
1167 window menu specified.
1168
1169 The syntax for specifying resource values for windows that have an
1170 unknown name and class (that is, windows that do not have a WM_CLASS
1171 property associated with them) is
1172
1173 Mwm*defaults*resource_id
1174
1175 For example, Mwm*defaults*iconImage is used to specify the icon image
1176 to be used for windows that have an unknown name and class.
1177
1178 The following client specific resources can be specified:
1179
1180 Client Specific Resources
1181 Name Class Value Type Default
1182
1183 clientDecoration ClientDecoration string all.
1184 clientFunctions ClientFunctions string all.
1185 focusAutoRaise FocusAutoRaise T/F varies
1186 iconImage IconImage pathname (image)
1187 iconImage- Background color icon background
1188 Background
1189 iconImageBottom- Foreground color icon
1190 ShadowColor bottom shadow
1191 iconImageBottom- BottomShadow- color icon bottom
1192 ShadowPixmap Pixmap shadow pixmap
1193 iconImageForeground Foreground color varies
1194 iconImageTopShadowColor Background color icon top
1195 shadow color
1196 iconImageTop- TopShadowPixmap color icon top
1197 ShadowPixmap shadow pixmap
1198 matteBackground Background color background
1199 matteBottom- Foreground color bottom
1200 ShadowColor shadow color
1201 matteBottom- BottomShadow- color bottom
1202 ShadowPixmap Pixmap shadow pixmap
1203 matteForeground Foreground color foreground
1204 matteTopShadowColor Background color top
1205 shadow color
1206 matteTopShadowPixmap TopShadowPixmap color top
1207 shadow pixmap
1208 matteWidth MatteWidth pixels 0
1209 maximumClientSize MaximumClientSize wxh
1210 vertical horizontal fill the screen
1211 useClientIcon UseClientIcon T/F T
1212 usePPosition UsePPosition string nonzero
1213 windowMenu WindowMenu string DefaultWindowMenu
1214
1215 clientDecoration (class ClientDecoration)
1216 This resource controls the amount of window frame decoration.
1217 The resource is specified as a list of decorations to specify
1218 their inclusion in the frame. If a decoration is preceded by
1219 a minus sign, that decoration is excluded from the frame. The
1220 sign of the first item in the list determines the initial
1221 amount of decoration. If the sign of the first decoration is
1222 minus, mwm assumes all decorations are present and starts
1223 subtracting from that set. If the sign of the first decora‐
1224 tion is plus (or not specified), then mwm starts with no dec‐
1225 oration and builds up a list from the resource.
1226
1227 An application can also specify which decorations mwm should
1228 apply to its windows. If it does so, mwm applies only those
1229 decorations indicated by both the application and the client‐
1230 Decoration resource. Otherwise, mwm applies the decorations
1231 indicated by the clientDecoration resource. For more infor‐
1232 mation see the description of XmNmwmDecorations on the Ven‐
1233 dorShell(3) reference page.
1234
1235 Name Description
1236 all Include all decorations (default value).
1237 border Window border.
1238 maximize Maximize button (includes title bar).
1239 minimize Minimize button (includes title bar).
1240 none No decorations.
1241 resizeh Border resize handles (includes border).
1242 menu Window menu button (includes title bar).
1243 title Title bar (includes border).
1244
1245 Examples: Mwm*XClock.clientDecoration: -resizeh -maximize This removes
1246 the resize handles and maximize button from XClock windows.
1247 Mwm*XClock.clientDecoration: menu minimize border This does the same
1248 thing as above. Note that either menu or minimize implies title.
1249
1250 clientFunctions (class ClientFunctions)
1251 This resource is used to indicate which mwm functions are
1252 applicable (or not applicable) to the client window. The
1253 value for the resource is a list of functions. If the first
1254 function in the list has a minus sign in front of it, then
1255 mwm starts with all functions and subtracts from that set. If
1256 the first function in the list has a plus sign in front of
1257 it, then mwm starts with no functions and builds up a list.
1258 Each function in the list must be preceded by the appropriate
1259 plus or minus sign and separated from the next function by a
1260 space.
1261
1262 An application can also specify which functions mwm should
1263 apply to its windows. If it does so, mwm applies only those
1264 functions indicated by both the application and the client‐
1265 Functions resource. Otherwise, mwm applies the functions
1266 indicated by the clientFunctions resource. For more informa‐
1267 tion see the description of XmNmwmFunctions on the Vendor‐
1268 Shell(3) reference page.
1269
1270 The following table lists the functions available for this resource:
1271
1272 Name Description
1273 all Include all functions (default value).
1274 none No functions.
1275 resize f.resize†.
1276 move f.move†.
1277 minimize f.minimize†.
1278 maximize f.maximize†.
1279 close f.kill†.
1280
1281 †See mwmrc(4).
1282
1283 focusAutoRaise (class FocusAutoRaise)
1284 When the value of this resource is True, clients are raised
1285 when they get the keyboard input focus. If the value is
1286 False, the stacking of windows on the display is not changed
1287 when a window gets the keyboard input focus. The default
1288 value is True when the keyboardFocusPolicy is explicit and
1289 False when the keyboardFocusPolicy is pointer.
1290
1291 iconImage (class IconImage)
1292 This resource can be used to specify an icon image for a
1293 client (for example, "Mwm*myclock*iconImage"). The resource
1294 value is a pathname for a pixmap or bitmap file. The value of
1295 the (client specific) useClientIcon resource is used to
1296 determine whether or not user supplied icon images are used
1297 instead of client supplied icon images. The default value is
1298 to display a built-in window manager icon image.
1299
1300 iconImageBackground (class Background)
1301 This resource specifies the background color of the icon
1302 image that is displayed in the image part of an icon. The
1303 default value of this resource is the icon background color
1304 (that is, specified by "Mwm*background or Mwm*icon*back‐
1305 ground).
1306
1307 iconImageBottomShadowColor (class Foreground)
1308 This resource specifies the bottom shadow color of the icon
1309 image that is displayed in the image part of an icon. The
1310 default value of this resource is the icon bottom shadow
1311 color (that is, specified by Mwm*icon*bottomShadowColor).
1312
1313 iconImageBottomShadowPixmap (class BottomShadowPixmap)
1314 This resource specifies the bottom shadow Pixmap of the icon
1315 image that is displayed in the image part of an icon. The
1316 default value of this resource is the icon bottom shadow
1317 Pixmap (that is, specified by Mwm*icon*bottomShadowPixmap).
1318
1319 iconImageForeground (class Foreground)
1320 This resource specifies the foreground color of the icon
1321 image that is displayed in the image part of an icon. The
1322 default value of this resource varies depending on the icon
1323 background.
1324
1325 iconImageTopShadowColor (class Background)
1326 This resource specifies the top shadow color of the icon
1327 image that is displayed in the image part of an icon. The
1328 default value of this resource is the icon top shadow color
1329 (that is, specified by Mwm*icon*topShadowColor).
1330
1331 iconImageTopShadowPixmap (class TopShadowPixmap)
1332 This resource specifies the top shadow Pixmap of the icon
1333 image that is displayed in the image part of an icon. The
1334 default value of this resource is the icon top shadow pixmap
1335 (that is, specified by Mwm*icon*topShadowPixmap).
1336
1337 matteBackground (class Background)
1338 This resource specifies the background color of the matte,
1339 when matteWidth is positive. The default value of this
1340 resource is the client background color (that is, specified
1341 by "Mwm*background or Mwm*client*background).
1342
1343 matteBottomShadowColor (class Foreground)
1344 This resource specifies the bottom shadow color of the matte,
1345 when matteWidth is positive. The default value of this
1346 resource is the client bottom shadow color (that is, speci‐
1347 fied by Mwm*bottomShadowColor or Mwm*client*bottomShadow‐
1348 Color).
1349
1350 matteBottomShadowPixmap (class BottomShadowPixmap)
1351 This resource specifies the bottom shadow Pixmap of the
1352 matte, when matteWidth is positive. The default value of this
1353 resource is the client bottom shadow pixmap (that is, speci‐
1354 fied by Mwm*bottomShadowPixmap or Mwm*client*bottomShadow‐
1355 Pixmap).
1356
1357 matteForeground (class Foreground)
1358 This resource specifies the foreground color of the matte,
1359 when matteWidth is positive. The default value of this
1360 resource is the client foreground color (that is, specified
1361 by Mwm*foreground or Mwm*client*foreground).
1362
1363 matteTopShadowColor (class Background)
1364 This resource specifies the top shadow color of the matte,
1365 when matteWidth is positive. The default value of this
1366 resource is the client top shadow color (that is, specified
1367 by Mwm*topShadowColor or Mwm*client*topShadowColor).
1368
1369 matteTopShadowPixmap (class TopShadowPixmap)
1370 This resource specifies the top shadow pixmap of the matte,
1371 when matteWidth is positive. The default value of this
1372 resource is the client top shadow pixmap (that is, specified
1373 by "Mwm*topShadowPixmap or Mwm*client*topShadowPixmap).
1374
1375 matteWidth (class MatteWidth)
1376 This resource specifies the width of the optional matte. The
1377 default value is 0, which effectively disables the matte.
1378
1379 maximumClientSize (class MaximumClientSize)
1380 This resource is either a size specification or a direction
1381 that indicates how a client window is to be maximized. The
1382 resource value can be specified as a size specification
1383 widthxheight. The width and height are interpreted in the
1384 units that the client uses (for example, for terminal emula‐
1385 tors this is generally characters). Alternately, "vertical"
1386 or "horizontal" can be specified to indicate the direction in
1387 which the client maximizes.
1388
1389 If this resource is not specified, the maximum size from the
1390 WM_NORMAL_HINTS property is used if set. Otherwise the
1391 default value is the size where the client window with window
1392 management borders fills the screen. When the maximum client
1393 size is not determined by the maximumClientSize resource, the
1394 maximumMaximumSize resource value is used as a constraint on
1395 the maximum size.
1396
1397 useClientIcon (class UseClientIcon)
1398 If the value given for this resource is True, a client-sup‐
1399 plied icon image takes precedence over a user-supplied icon
1400 image. The default value is True, giving the client-supplied
1401 icon image higher precedence than the user-supplied icon
1402 image.
1403
1404 usePPosition (class UsePPosition)
1405 This resource specifies whether Mwm honors program specified
1406 position PPosition specified in the WM_NORMAL_HINTS property
1407 in the absence of an user specified position. Setting this
1408 resource to on, causes mwm to always honor program specified
1409 position. Setting this resource to off, causes mwm to always
1410 ignore program specified position. Setting this resource to
1411 the default value of nonzero cause mwm to honor program spec‐
1412 ified position other than (0,0).
1413
1414 windowMenu (class WindowMenu)
1415 This resource indicates the name of the menu pane that is
1416 posted when the window menu is popped up (usually by pressing
1417 button 1 on the window menu button on the client window
1418 frame). Menu panes are specified in the mwm resource descrip‐
1419 tion file. Window menus can be customized on a client class
1420 basis by creating custom menus in your mwmrc file (see
1421 mwmrc(4) and specifying resources to activate the custom
1422 menus. The resources have the form Mwm*
1423 client_name_or_class*windowMenu. The default value of this
1424 resource is DefaultWindowMenu.
1425
1426 Resource Description File
1427 The mwm resource description file is a supplementary resource file that
1428 contains resource descriptions that are referred to by entries in the
1429 resource manager property (see xrdb(1) and the defaults files (.Xde‐
1430 faults, app-defaults/Mwm ). It contains descriptions of resources that
1431 are to be used by mwm, and that cannot be easily encoded in the
1432 defaults files (a bitmap file is an analogous type of resource descrip‐
1433 tion file). A particular mwm resource description file can be selected
1434 using the configFile resource.
1435
1436 The following types of resources can be described in the mwm resource
1437 description file:
1438
1439 Buttons Window manager functions can be bound (associated) with but‐
1440 ton events.
1441
1442 Keys Window manager functions can be bound (associated) with key
1443 press events.
1444
1445 Menus Menu panes can be used for the window menu and other menus
1446 posted with key bindings and button bindings.
1447
1448 The mwm resource description file is described in mwmrc(4).
1449
1450 Environment
1451 The mwm window manager uses the environment variable HOME specifying
1452 the user's home directory.
1453
1454 The mwm window manager uses the environment variable LANG specifying
1455 the user's choice of language for the mwm message catalog and the mwm
1456 resource description file.
1457
1458 The mwm window uses the environment variable XFILESEARCHPATH, XUSER‐
1459 FILESEARCHPATH, XAPPLRESDIR, XENVIRONMENT, LANG, and HOME in determin‐
1460 ing search paths for resource defaults files. The mwm window manager
1461 may also us XBMLANGPATH to search for bitmap files.
1462
1463 The mwm window manager reads the $HOME/.motifbind file if it exists to
1464 install a virtual key bindings property on the root window. For more
1465 information on the content of the .motifbind file, see
1466
1467 The mwm window manager uses the environment variable MWMSHELL (or
1468 SHELL, if MWMSHELL is not set), specifying the shell to use when exe‐
1469 cuting commands via the f.exec function.
1470
1471 Files
1472 /etc/X11/mwm/$LANG/system.mwmrc
1473
1474 /etc/X11/mwm/system.mwmrc
1475
1476 /usr/share/X11/app-defaults/Mwm
1477
1478 $HOME/Mwm
1479
1480 $HOME/$LANG/.mwmrc
1481
1482 $HOME/.mwmrc
1483
1484 RELATED INFORMATION
1485 VendorShell(3), VirtualBindings(3), X(1), XmInstallImage(3), xrdb(1).
1486
1487
1488
1489 mwm(user cmd)