1mwm(user cmd)                                                    mwm(user cmd)
2
3
4

NAME

6       mwm — The Motif Window Manager
7

SYNOPSIS

9       mwm [options]
10

DESCRIPTION

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)
Impressum