Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
mwm(1)			    General Commands Manual			mwm(1)

NAME
       mwm -- The Motif	Window Manager

SYNOPSIS
       mwm [options]

DESCRIPTION
       The  mwm	 window	manager	provides functions that	facilitate control (by
       the user	and the	programmer) of elements	of window state	such as	place-
       ment, size, icon/normal display,	and input-focus	ownership.

       The  stand-alone	window manager is not an integral part of CDE and does
       not support communication with other components in the CDE environment,
       such as the Style Manager and the Session Manager.

   Options
       -display	display
		 This option specifies the display to use; see X(1).

       -xrm resourcestring
		 This option specifies a resource string to use.

       -multiscreen
		 This  option causes mwm to manage all screens on the display.
		 The default is	to manage only a single	screen.

       -name name
		 This option causes mwm	to retrieve its	 resources  using  the
		 specified name, as in name*resource.

       -screens	name [name [...]]
		 This  option  specifies  the  resource	 names	to use for the
		 screens managed by mwm. If mwm	is managing a  single  screen,
		 only  the  first name in the list is used. If mwm is managing
		 multiple screens, the names are assigned to  the  screens  in
		 order,	 starting with screen 0. Screen	0 gets the first name,
		 screen	1 the second name, and so on.

   Appearance
       The following sections describe the basic default behaviors of windows,
       icons,  the  icon box, input focus, and window stacking.	The appearance
       and behavior of the window manager can be altered by changing the  con-
       figuration of specific resources. Resources are defined under the head-
       ing "X DEFAULTS."

   Screens
       By default, mwm manages only the	single screen specified	by  the	 -dis-
       play option or the DISPLAY environment variable (by default, screen 0).
       If the -multiscreen option is specified or if the multiScreen  resource
       is True,	mwm tries to manage all	the screens on the display.

       When  mwm is managing multiple screens, the -screens option can be used
       to give each screen a unique resource name. The names are separated  by
       blanks, for example, -screens scr0 scr1.	If there are more screens than
       names, resources	for the	remaining screens will be retrieved using  the
       first name.  By default,	the screen number is used for the screen name.

   Windows
       Default	mwm  window  frames  have  distinct components with associated
       functions:

       Title Area
		 In addition to	displaying the client's	title, the title  area
		 is  used  to  move  the window. To move the window, place the
		 pointer over the title	area, press button 1 and drag the win-
		 dow to	a new location.	By default, a wire frame is moved dur-
		 ing the drag to indicate the new location. When the button is
		 released, the window is moved to the new location.

       Title Bar The  title  bar includes the title area, the minimize button,
		 the maximize button, and the window menu  button.  In	shaped
		 windows,  such	 as  round windows, the	title bar floats above
		 the window.

       Minimize	Button
		 To turn the window into an icon, click	button 1 on the	 mini-
		 mize button (the frame	box with a small square	in it).

       Maximize	Button
		 To make the window fill the screen (or	enlarge	to the largest
		 size allowed by the configuration files), click button	 1  on
		 the  maximize	button	(the  frame box	with a large square in
		 it).

       Window Menu Button
		 The window menu button	is the frame box with a	horizontal bar
		 in  it.   To pull down	the window menu, press button 1. While
		 pressing, drag	the pointer on the  menu  to  your  selection,
		 then  release	the button when	your selection is highlighted.
		 Pressing button 3 in the title	bar or resize  border  handles
		 also posts the	window menu. Alternately, you can click	button
		 1 to pull down	the menu and keep it posted; then position the
		 pointer  and  select.	You  can  also post the	window menu by
		 pressing <Shift> <Esc>	 or  <Alt>  <Space>.   Double-clicking
		 button	 1  with  the pointer on the window menu button	closes
		 the window.

       The following table lists the contents of the window menu.

   Default Window Menu
       Selection	    Accelerator	  Description
       Restore				  Restores the window to  its  size
					  before minimizing or maximizing.
       Move				  Allows  the  window  to  be moved
					  with keys or mouse.
       Size				  Allows the window to be resized.
       Minimize				  Turns	the window into	an icon.
       Maximize				  Makes	the window fill	the screen.
       Lower				  Moves	window to bottom of  window
					  stack.
       Close		    Alt+F4	  Causes client	to terminate.

       Resize Border Handles
		 To  change  the size of a window, move	the pointer over a re-
		 size border handle (the cursor	changes), press	button 1,  and
		 drag  the  window to a	new size. When the button is released,
		 the window is resized.	While dragging is being	done,  a  rub-
		 ber-band  outline  is	displayed  to  indicate	the new	window
		 size.

       Matte	 An optional matte decoration can be added between the	client
		 area  and  the	 window	frame (see the matteWidth resource). A
		 matte is not actually part of the window frame.  There	is  no
		 functionality associated with a matte.

   Icons
       Icons  are  small  graphic  representations of windows. A window	can be
       minimized (iconified) using the minimize	button on  the	window	frame.
       Icons provide a way to reduce clutter on	the screen.

       Pressing	 mouse	button	1  when	the pointer is over an icon causes the
       icon's window menu to pop up. Releasing the  button  (press  +  release
       without	moving mouse = click) causes the menu to stay posted. The menu
       contains	the following selections:

   Icon	Window Menu
       Selection   Accelerator	  Description
       Restore			  Opens	the associated window.
       Move			  Allows the icon to  be  moved	 with
				  keys.
       Size			  Inactive (not	an option for icons).
       Minimize			  Inactive (not	an option for icons).
       Maximize			  Opens	 the  associated  window  and
				  makes	it fill	the screen.
       Lower			  Moves	icon to	bottom of icon stack.
       Close	   Alt+F4	  Removes client from mwm management.

       Note that pressing button 3 over	an icon	also causes the	icon's	window
       menu  to	 pop  up.  To make a menu selection, drag the pointer over the
       menu and	release	button 3 when the desired item is highlighted.

       Double-clicking button 1	on an  icon  invokes  the  f.restore_and_raise
       function	 and  restores	the  icon's  associated	window to its previous
       state. For example, if a	maximized window is iconified, double-clicking
       button  1  restores it to its maximized state. Double-clicking button 1
       on the icon box's icon opens the	icon box and allows access to the con-
       tained  icons.  (In  general, double-clicking a mouse button is a quick
       way to perform a	function.)  Pressing <Shift> <Esc> or <Menu> (the pop-
       up menu key) causes the icon window menu	of the currently selected icon
       to pop up.

   Icon	Box
       When icons begin	to clutter the screen, they can	be packed into an icon
       box. (To	use an icon box, mwm must be started with the icon box config-
       uration already set.) The icon box is a mwm window  that	 holds	client
       icons.  It  includes one	or more	scroll bars when there are more	window
       icons than the icon box can show	at the same time.

       Icons in	the icon box can be manipulated	with the mouse.	The  following
       table  summarizes  the behavior of this interface. Button actions apply
       whenever	the pointer is on any part of  the  icon.  Note	 that  double-
       clicking	 an icon in the	icon box invokes the f.restore_and_raise func-
       tion.

       Button	  Action	 Description
       Button 1	  click		 Selects the icon.
       Button 1	  double-click	 Normalizes  (opens)  the  associated
				 window.  Raises an already open win-
				 dow to	the top	of the stack.
       Button 1	  drag		 Moves the icon.
       Button 3	  press		 Causes	the menu for that icon to pop
				 up.
       Button 3	  drag		 Highlights   items  as	 the  pointer
				 moves across the menu.

       Pressing	mouse button 3 when the	pointer	is over	 an  icon  causes  the
       menu for	that icon to pop up.

   Icon	Menu for the Icon Box
       Selection   Accelerator	 Description
       Restore			 Opens the associated window (if not
				 already open).
       Move			 Allows	the icon to  be	 moved	with
				 keys.
       Size			 Inactive.
       Minimize			 Inactive.
       Maximize			 Opens the associated window (if not
				 already  open)	 and  maximizes	 its
				 size.

       Lower			 Inactive.
       Close	   Alt+F4	 Removes client	from mwm management.

       To  pull	 down  the window menu for the icon box	itself,	press button 1
       with the	pointer	over the menu button for the icon box. The window menu
       of  the	icon  box differs from the window menu of a client window: The
       "Close" selection is replaced with the "PackIcons Shift+Alt+F7"	selec-
       tion.  When  selected,  PackIcons packs the icons in the	box to achieve
       neat rows with no empty slots.

       You can also post the window menu by pressing <Shift>, <Esc>  or	 <Alt>
       <Space>.	 Pressing  <Menu> (the pop-up menu key)	causes the icon	window
       menu of the currently selected icon to pop up.

   Input Focus
       The mwm window manager supports (by default)  a	keyboard  input	 focus
       policy  of  explicit selection. This means when a window	is selected to
       get keyboard input, it continues	to get keyboard	input until the	window
       is  withdrawn  from window management, another window is	explicitly se-
       lected to get keyboard input, or	the window is iconified.  Several  re-
       sources	control	 the  input focus. The client window with the keyboard
       input focus has the active window appearance with a  visually  distinct
       window frame.

       The  following  tables summarize	the keyboard input focus selection be-
       havior:

       Button	   Action     Object		      Function Description
       Button 1	   press      Window / window frame   Keyboard focus selection.
       Button 1	   press      Icon		      Keyboard focus selection.

       Key Action	   Function Description
       [Alt][Tab]	   Move	input focus to next window in window
			   stack  (available  only in explicit focus
			   mode).
       [Alt][Shift][Tab]   Move	input focus to	previous  window  in
			   window  stack (available only in explicit
			   focus mode).

   Window Stacking
       There are two types of window stacks: global window stacks and  an  ap-
       plication's local family	window stack.

       The global stacking order of windows may	be changed as a	result of set-
       ting the	keyboard input focus, iconifying a  window,  or	 performing  a
       window  manager window stacking function. When keyboard focus policy is
       explicit	the default value of the focusAutoRaise	resource is True. This
       causes  a  window to be raised to the top of the	stack when it receives
       input focus, for	example, by pressing button 1 on the  title  bar.  The
       key  actions  defined  in the previous table will thus raise the	window
       receiving focus to the top of the stack.

       In pointer mode,	the default value of focusAutoRaise is False, that is,
       the  window  stacking  order is not changed when	a window receives key-
       board input focus. The following	key  actions  can  be  used  to	 cycle
       through the global window stack.

       Key Action	   Function Description
       [Alt][ESC]	   Place top window on bottom of stack.
       [Alt][Shift][ESC]   Place bottom	window on top of stack.

       By  default,  a window's	icon is	placed on the bottom of	the stack when
       the window is iconified;	however, the default can  be  changed  by  the
       lowerOnIconify resource.

       Transient  windows  (secondary  windows such a dialog boxes) stay above
       their parent windows by default;	however, an application's local	family
       stacking	 order may be changed to allow a transient window to be	placed
       below its parent	top-level window. The  following  arguments  show  the
       modification of the stacking order for the f.lower function.

       f.lower	 Lowers	 the transient window within the family	(staying above
		 the parent) and lowers	the family in the global window	stack.

       f.lower [ within]
		 Lowers	the transient window within the	family (staying	 above
		 the  parent) but does not lower the family in the global win-
		 dow stack.

       f.lower [freeFamily ]
		 Lowers	the window free	from its family	stack (below the  par-
		 ent),	but  does  not	lower  the family in the global	window
		 stack.

       The arguments within and	freeFamily can also be used with  f.raise  and
       f.raise_lower.

   Session Management
       The window manager is an	X Session Management Protocol aware client. It
       responds	to SaveYourself	(and other associated messages)	by saving  the
       geometries  of  its clients to a	state file.  mwm can then be restarted
       by the XSMP session manager.  The default location for the  state  file
       is  $HOME/.mwmclientdb.	 This  location	 can be	overriden with the re-
       source sessionClientDB.

   X Resources
       The mwm command is configured from its resource database. This database
       is built	from the following sources. They are listed in order of	prece-
       dence, low to high:

       /usr/X11R6/lib/X11/app-defaults/Mwm

       $HOME/Mwm

       RESOURCE_MANAGER	root window property or	$HOME/.Xdefaults

       XENVIRONMENT variable or	$HOME/.Xdefaults-host

       mwm command line	options

       The file	names /usr/X11R6/lib/X11/app-defaults/Mwm and $HOME/Mwm	repre-
       sent  customary	locations  for these files. The	actual location	of the
       system-wide class resource file may depend on the XFILESEARCHPATH envi-
       ronment variable	and the	current	language environment. The actual loca-
       tion of the user-specific class resource	file may depend	on the	XUSER-
       FILESEARCHPATH  and  XAPPLRESDIR	 environment variables and the current
       language	environment.

       Entries in the resource database	may refer to other resource files  for
       specific	 types of resources. These include files that contain bitmaps,
       fonts, and mwm specific resources such as menus and behavior specifica-
       tions (for example, button and key bindings).

       Mwm  is	the resource class name	of mwm and mwm is the default resource
       name used by mwm	to look	up resources. the -screens command line	option
       specifies  resource  names, such	as "mwm_b+w" and "mwm_color".)	In the
       following discussion of resource	specification, "Mwm"  and  "mwm"  (and
       the  aliased mwm	resource names)	can be used interchangeably, but "mwm"
       takes precedence	over "Mwm".

       The mwm command uses the	following types	of resources:

       Component Appearance Resources:
		 These resources specify appearance attributes of window  man-
		 ager  user  interface	components. They can be	applied	to the
		 appearance of window manager menus, feedback windows (for ex-
		 ample,	 the  window  reconfiguration feedback window),	client
		 window	frames,	and icons.

       General Appearance and Behavior Resources:
		 These resources specify mwm appearance	and behavior (for  ex-
		 ample,	 window	 management  policies).	They are not set sepa-
		 rately	for different mwm user interface components. They  ap-
		 ply to	all screens and	workspaces.

       Screen Specific Appearance and Behavior Resources:
		 These	resources  specify  the	appearance and behavior	of mwm
		 elements that are settable on a per-screen basis.

       Client Specific Resources:
		 These mwm resources can be set	for a particular client	window
		 or class of client windows. They specify client-specific icon
		 and client window frame appearance and	behavior.

       Resource	identifiers can	be either a resource name (for example,	 fore-
       ground)	or a resource class (for example, Foreground). If the value of
       a resource is a filename	and if the filename is prefixed	by "~/",  then
       it  is  relative	to the path contained in the HOME environment variable
       (generally the user's home directory).

   Component Appearance	Resources
       The syntax for specifying component appearance resources	that apply  to
       window  manager	icons,	menus,	and  client  window frames is Mwm* re-
       source_id

       For example, Mwm*foreground is used to specify the foreground color for
       mwm menus, icons, client	window frames, and feedback dialogs.

       The  syntax for specifying component appearance resources that apply to
       a particular  mwm  component  is	 Mwm*[menu|icon|client|feedback]  *re-
       source_id

       If  menu	 is  specified,	 the resource is applied only to mwm menus; if
       icon is specified, the resource is applied to icons; and	if  client  is
       specified,  the	resource is applied to client window frames. For exam-
       ple, Mwm*icon*foreground	is used	to specify the	foreground  color  for
       mwm  icons,  Mwm*menu*foreground	specifies the foreground color for mwm
       menus, and Mwm*client*foreground	is  used  to  specify  the  foreground
       color for mwm client window frames.

       The  appearance	of  the	title area of a	client window frame (including
       window management buttons) can be separately configured.	The syntax for
       configuring  the	 title area of a client	window frame is	Mwm*client*ti-
       tle* resource_id

       For example, Mwm*client*title*foreground	specifies the foreground color
       for  the	title area. Defaults for title area resources are based	on the
       values of the corresponding client window frame resources.

       The appearance of menus can be configured based	on  the	 name  of  the
       menu.   The  syntax for specifying menu appearance by name is Mwm*menu*
       menu_name*resource_id

       For example, Mwm*menu*my_menu*foreground	specifies the foreground color
       for  the	 menu  named  my_menu. The user	can also specify resources for
       window manager menu components, that is,	the gadgets that comprise  the
       menu. These may include for example, a menu title, title	separator, one
       or more buttons,	and separators.	If a menu contains more	than  one  in-
       stance  of a class, such	as multiple PushButtonGadgets, the name	of the
       first instance is "PushButtonGadget1", the  second  is  "PushButtonGad-
       get2",  and  so on. The following list identifies the naming convention
       used for	window manager menu components:

	  o  Menu Title	LabelGadget - "TitleName"

	  o  Menu Title	SeparatorGadget	- "TitleSeparator"

	  o  CascadeButtonGadget - "CascadeButtonGadget<n>"

	  o  PushButtonGadget -	"PushButtonGadget<n>"

	  o  SeparatorGadget - "SeparatorGadget<n>"

       Refer to	the man	page for each class for	a list of resources  that  can
       be specified.

       The  following  component appearance resources that apply to all	window
       manager parts can be specified:

   Component Appearance	Resources - All	Window Manager Parts
       Name		    Class	       Value Type	 Default
       background	    Background	       color		 varies<*>
       backgroundPixmap	    BackgroundPixmap   string<*><*>	 varies<*>
       bottomShadowColor    Foreground	       color		 varies<*>
       bottomShadowPixmap   Foreground	       string<*><*>	 varies<*>
       fontList		    FontList	       string<*><*><*>	 "fixed"
       foreground	    Foreground	       color		 varies<*>
       saveUnder	    SaveUnder	       T/F		 F
       topShadowColor	    Background	       color		 varies<*>
       topShadowPixmap	    TopShadowPixmap    string<*><*>	 varies<*>

       <*>The  default	is  chosen  based  on  the  visual type	of the screen.
       <*><*>Image name. See XmInstallImage(3).	<*><*><*>X11  X	 Logical  Font
       Description

       background (class  Background)
		 This  resource	 specifies  the	 background color. Any legal X
		 color may be specified. The default value is chosen based  on
		 the visual type of the	screen.

       backgroundPixmap	(class	BackgroundPixmap)
		 This resource specifies the background	Pixmap of the mwm dec-
		 oration when the window is inactive (does not have  the  key-
		 board	focus).	 The default value is chosen based on the vis-
		 ual type of the screen.

       bottomShadowColor (class	 Foreground)
		 This resource specifies the bottom shadow color.  This	 color
		 is  used for the lower	and right bevels of the	window manager
		 decoration. Any legal X color may be specified.  The  default
		 value is chosen based on the visual type of the screen.

       bottomShadowPixmap (class  BottomShadowPixmap)
		 This resource specifies the bottom shadow Pixmap. This	Pixmap
		 is used for the lower and right bevels	of the window  manager
		 decoration. The default is chosen based on the	visual type of
		 the screen.

       fontList	(class	FontList)
		 This resource specifies the font used in the  window  manager
		 decoration.   The character encoding of the font should match
		 the character encoding	of the strings that are	used. The  de-
		 fault is "fixed."

       foreground (class  Foreground)
		 This  resource	specifies the foreground color.	The default is
		 chosen	based on the visual type of the	screen.

       saveUnder (class	 SaveUnder)
		 This is used to indicate whether "save	unders"	are  used  for
		 mwm components. For this to have any effect, save unders must
		 be implemented	by the X server. If  save  unders  are	imple-
		 mented,  the  X server	saves the contents of windows obscured
		 by windows that have the save under  attribute	 set.  If  the
		 saveUnder  resource  is True, mwm will	set the	save under at-
		 tribute on the	window manager frame of	any client that	has it
		 set.  If  saveUnder is	False, save unders will	not be used on
		 any window manager frames. The	default	value is False.

       topShadowColor (class  Background)
		 This resource specifies the top shadow	color. This  color  is
		 used for the upper and	left bevels of the window manager dec-
		 oration. The default is chosen	based on the  visual  type  of
		 the screen.

       topShadowPixmap ( class	TopShadowPixmap)
		 This resource specifies the top shadow	Pixmap.	This Pixmap is
		 used for the upper and	left bevels of the window manager dec-
		 oration.  The	default	 is chosen based on the	visual type of
		 the screen.

       The following component appearance resources that apply	to  frame  and
       icons can be specified:

   Frame and Icon Components
       Name			  Class		       Value Type     Default
       activeBackground		  Background	       color	      varies<*>
       activeBackgroundPixmap	  BackgroundPixmap     string<*><*>   varies<*>
       activeBottomShadowColor	  Foreground	       color	      varies<*>
       activeBottomShadowPixmap	  BottomShadowPixmap   string<*><*>   varies<*>
       activeForeground		  Foreground	       color	      varies<*>
       activeTopShadowColor	  Background	       color	      varies<*>
       activeTopShadowPixmap	  TopShadowPixmap      string<*><*>   varies<*>

       <*>The  default	is  chosen  based  on  the  visual type	of the screen.
       <*><*>See XmInstallImage(3).

       activeBackground	(class	Background)
		 This resource specifies the background	color of the mwm deco-
		 ration	 when  the  window is active (has the keyboard focus).
		 The default is	chosen based on	the visual type	of the screen.

       activeBackgroundPixmap (class  ActiveBackgroundPixmap)
		 This resource specifies the background	Pixmap of the mwm dec-
		 oration  when	the window is active (has the keyboard focus).
		 The default is	chosen based on	the visual type	of the screen.

       activeBottomShadowColor (class  Foreground)
		 This resource specifies the bottom shadow color  of  the  mwm
		 decoration  when  the	window is active (has the keyboard fo-
		 cus).	The default is chosen based on the visual type of  the
		 screen.

       activeBottomShadowPixmap	(class	BottomShadowPixmap)
		 This  resource	 specifies the bottom shadow Pixmap of the mwm
		 decoration when the window is active (has  the	 keyboard  fo-
		 cus).	 The default is	chosen based on	the visual type	of the
		 screen.

       activeForeground	(class	Foreground)
		 This resource specifies the foreground	color of the mwm deco-
		 ration	 when  the  window is active (has the keyboard focus).
		 The default is	chosen based on	the visual type	of the screen.

       activeTopShadowColor (class  Background)
		 This resource specifies the top shadow	color of the mwm deco-
		 ration	 when  the  window is active (has the keyboard focus).
		 The default is	chosen based on	the visual type	of the screen.

       activeTopShadowPixmap (class  TopShadowPixmap)
		 This resource specifies the top shadow	Pixmap of the mwm dec-
		 oration  when	the window is active (has the keyboard focus).
		 The default is	chosen based on	the visual type	of the screen.

   General Appearance and Behavior Resources
       The syntax for specifying general appearance and	behavior resources  is
       Mwm*resource_id

       For  example, Mwm*keyboardFocusPolicy specifies the window manager pol-
       icy for setting the keyboard focus to a particular client window.

       The following general appearance	and behavior resources can  be	speci-
       fied:

   General Appearance and Behavior Resources
       Name		      Class		     Value Type	   Default
       autoKeyFocus	      AutoKeyFocus	     T/F	   T
       autoRaiseDelay	      AutoRaiseDelay	     millisec	   500
       bitmap-		      Bitmap-		     directory	   /usr/X11R6/include-
       Directory	      Directory				   /X11/bitmaps
       clientAutoPlace	      ClientAutoPlace	     T/F	   T
       colormapFocus-	      ColormapFocus-	     string	   keyboard
       Policy		      Policy
       configFile	      ConfigFile	     file	   $HOME/mwmrc
       deiconifyKeyFocus      DeiconifyKeyFocus	     T/F	   T
       doubleClick-	      DoubleClick-	     millisec.	   multi-click
       Time		      Time				   time<*>
       enableWarp	      enableWarp	     T/F	   T
       enforceKeyFocus	      EnforceKeyFocus	     T/F	   T
       frameStyle	      FrameStyle	     string	   recessed
       iconAutoPlace	      IconAutoPlace	     T/F	   T
       iconClick	      IconClick		     T/F	   T
       interactivePlacement   InteractivePlacement   T/F	   T
       keyboardFocus-	      KeyboardFocus-	     string	   explicit
       Policy		      Policy
       lowerOnIconify	      LowerOnIconify	     T/F	   T
       moveThreshold	      MoveThreshold	     pixels	   4
       multiScreen	      MultiScreen	     T/F	   F
       passButtons	      PassButtons	     T/F	   F
       passSelectButton	      PassSelectButton	     T/F	   T
       positionIsFrame	      PositionIsFrame	     T/F	   T
       positionOnScreen	      PositionOnScreen	     T/F	   T
       quitTimeout	      QuitTimeout	     millisec.	   1000
       raiseKeyFocus	      RaiseKeyFocus	     T/F	   F
       refreshByClearing      RefreshByClearing	     T/F	   T
       rootButtonClick	      RootButtonClick	     T/F	   F
       screens		      Screens		     string	   varies
       sessionClientDB	      SessionClientDB	     string	   $HOME/.mwmclientdb
       showFeedback	      ShowFeedback	     string	   all
       startupKeyFocus	      StartupKeyFocus	     T/F	   T
       wMenuButtonClick	      WMenuButtonClick	     T/F	   T
       wMenuButtonClick2      WMenuButtonClick2	     T/F	   T

       <*>The resource doubleClickTime is included for backward	compatibility.
       Use of the Xt resource multiClickTime is	preferred.

       autoKeyFocus (class  AutoKeyFocus)
		 This resource is available only when the keyboard input focus
		 policy	is explicit. If	autoKeyFocus is	given a	value of True,
		 then when a window with the keyboard input focus is withdrawn
		 from  window  management or is	iconified, the focus is	set to
		 the previous window that had the focus. If the	value given is
		 False,	 there	is  no automatic setting of the	keyboard input
		 focus.	It is recommended that both autoKeyFocus and  startup-
		 KeyFocus  be  True  to	 work with tear	off menus. The default
		 value is True.

       autoRaiseDelay (class  AutoRaiseDelay)
		 This resource is available only when the  focusAutoRaise  re-
		 source	 is True and the keyboard focus	policy is pointer. The
		 autoRaiseDelay	resource specifies the amount of time (in mil-
		 liseconds)  that  mwm will wait before	raising	a window after
		 it gets the keyboard focus. The default  value	 of  this  re-
		 source	is 500 (ms).

       bitmapDirectory (class  BitmapDirectory)
		 This  resource	identifies a directory to be searched for bit-
		 maps referenced by mwm	resources. This	directory is  searched
		 if  a	bitmap	is specified without an	absolute pathname. The
		 default   value   for	 this	resource   is	/usr/X11R6/in-
		 clude/X11/bitmaps.  The directory /usr/X11R6/include/X11/bit-
		 maps represents the customary locations for  this  directory.
		 The  actual  location of this directory may vary on some sys-
		 tems. If the bitmap is	not found in the specified  directory,
		 XBMLANGPATH is	searched.

       clientAutoPlace (class  ClientAutoPlace)
		 This  resource	 determines  the position of a window when the
		 window	has not	been given a program- or user-specified	 posi-
		 tion.	With  a	value of True, windows are positioned with the
		 top left corners of the frames	offset horizontally and	verti-
		 cally.	A value	of False causes	the currently configured posi-
		 tion of the window to be used.	In either case,	mwm  will  at-
		 tempt	to  place  the	windows	totally	on-screen. The default
		 value is True.

       colormapFocusPolicy (class  ColormapFocusPolicy)
		 This resource indicates the colormap focus policy that	is  to
		 be  used.   If	the resource value is explicit,	a colormap se-
		 lection action	is done	on a client window to set the colormap
		 focus	to  that  window.  If the value	is pointer, the	client
		 window	containing the pointer has the colormap	focus.	If the
		 value	is  keyboard,  the client window that has the keyboard
		 input focus has the colormap focus.  The  default  value  for
		 this resource is keyboard.

       configFile (class  ConfigFile)
		 The  resource	value  is  the pathname	for a mwm resource de-
		 scription file. If the	pathname begins	with "~/", mwm consid-
		 ers it	to be relative to the user's home directory (as	speci-
		 fied by the HOME environment variable).  If the LANG environ-
		 ment  variable	is set,	mwm looks for $HOME/$LANG/ configFile.
		 If that file does not exist or	if LANG	is not set, mwm	 looks
		 for $HOME/configFile. If the configFile pathname does not be-
		 gin with "~/" or "/", mwm considers it	to be relative to  the
		 current  working directory. If	the configFile resource	is not
		 specified or if that file does	not exist,  mwm	 uses  several
		 default  paths	to find	a configuration	file. The order	of the
		 search	  is   shown   below:	 /usr/X11R6/lib/X11/$LANG/sys-
		 tem.mwmrc<*>  /usr/X11R6/lib/X11/system.mwmrc<*> Paths	marked
		 with '<*>' are	implementation dependent.

       deiconifyKeyFocus (class	 DeiconifyKeyFocus)
		 This resource applies only when the keyboard input focus pol-
		 icy  is  explicit.   If a value of True is used, a window re-
		 ceives	the keyboard input focus when it  is  normalized  (de-
		 iconified). True is the default value.

       doubleClickTime (class  DoubleClickTime)
		 This resource is used to set the maximum time (in ms) between
		 the clicks (button presses) that make up a double-click.  The
		 use  of this resource is deprecated. Use the Xt resource mul-
		 tiClickTime instead.  The value  of  doubleClickTime  dynami-
		 cally defaults	to the value of	multiClickTime.

       enableWarp (class  EnableWarp)
		 The  default value of this resource, True, causes mwm to warp
		 the pointer to	the center of the selected window during  key-
		 board-controlled  resize  and	move  operations.  Setting the
		 value to False	causes mwm to leave the	pointer	at its	origi-
		 nal  place on the screen, unless the user explicitly moves it
		 with the cursor keys or pointing device.

       enforceKeyFocus (class  EnforceKeyFocus)
		 If this resource is given a value of True, the	keyboard input
		 focus	is  always  explicitly set to selected windows even if
		 there is an indication	that they are "globally	active"	 input
		 windows.  (An example of a globally active window is a	scroll
		 bar that can be operated without setting the  focus  to  that
		 client.)  If  the resource is False, the keyboard input focus
		 is not	explicitly set to globally active windows. The default
		 value is True.

       frameStyle (class  frameStyle)
		 If  this  resource is given a value of	"slab",	the the	window
		 manager frame is drawn	such that the client area  appears  to
		 be  at	the same height	as the top of the window frame.	If the
		 resource is set to "recessed",	the window frame is drawn such
		 that the client area appears lower than the top of the	window
		 frame.	The default value is "recessed".

       iconAutoPlace (class  IconAutoPlace)
		 This resource indicates whether the window  manager  arranges
		 icons	in a particular	area of	the screen or places each icon
		 where the window was when it was iconified.  The  value  True
		 indicates that	icons are arranged in a	particular area	of the
		 screen, determined by the iconPlacement resource.  The	 value
		 False indicates that an icon is placed	at the location	of the
		 window	when it	is iconified. The default is True.

       iconClick (class	 IconClick)
		 When this resource is given the value	of  True,  the	system
		 menu  is  posted and left posted when an icon is clicked. The
		 default value is True.

       interactivePlacement (class  InteractivePlacement)
		 This resource controls	the initial placement of  new  windows
		 on  the  screen.   If	the  value  is True, the pointer shape
		 changes before	a new window is	placed on the screen to	 indi-
		 cate  to  the user that a position should be selected for the
		 upper-left hand corner	of the window. If the value is	False,
		 windows are placed according to the initial window configura-
		 tion attributes. The default value of this resource is	False.

       keyboardFocusPolicy (class  KeyboardFocusPolicy)
		 If set	to pointer, the	keyboard focus policy is to  have  the
		 keyboard  focus  set  to  the client window that contains the
		 pointer (the pointer could also be in the client window deco-
		 ration	 that mwm adds).  If set to explicit, the policy is to
		 have the keyboard focus set to	a client window	when the  user
		 presses button	1 with the pointer on the client window	or any
		 part of the associated	mwm decoration.	The default value  for
		 this resource is explicit.

       lowerOnIconify (class  LowerOnIconify)
		 If  this  resource is given the default value of True,	a win-
		 dow's icon appears on the bottom of the window	stack when the
		 window	is minimized (iconified).  A value of False places the
		 icon in the stacking order at the same	place as  its  associ-
		 ated window. The default value	of this	resource is True.

       moveThreshold (class  MoveThreshold)
		 This  resource	is used	to control the sensitivity of dragging
		 operations that move windows and icons. The value of this re-
		 source	is the number of pixels	that the locator is moved with
		 a button down before the move operation is initiated. This is
		 used  to  prevent window/icon movement	when you click or dou-
		 ble-click and there is	unintentional  pointer	movement  with
		 the  button  down.   The  default value of this resource is 4
		 (pixels).

       multiScreen (class  MultiScreen)
		 This resource,	if True, causes	mwm to manage all the  screens
		 on  the  display. If False, mwm manages only a	single screen.
		 The default value is False.

       passButtons (class  PassButtons)
		 This resource indicates whether or not	 button	 press	events
		 are passed to clients after they are used to do a window man-
		 ager function in the client context. If the resource value is
		 False,	 the  button press is not passed to the	client.	If the
		 value is True,	the button press is passed to the client  win-
		 dow.  The window manager function is done in either case. The
		 default value for this	resource is False.

       passSelectButton	(class	PassSelectButton)
		 This resource indicates whether or not	 to  pass  the	select
		 button	 press	events	to clients after they are used to do a
		 window	manager	function in the	client	context.  If  the  re-
		 source	 value	is  False,  then  the button press will	not be
		 passed	to the client. If the value is True, the button	 press
		 is  passed  to	the client window. The window manager function
		 is done in either case.  The default value for	this  resource
		 is True.

       positionIsFrame (class  PositionIsFrame)
		 This  resource	 indicates how client window position informa-
		 tion (from the	WM_NORMAL_HINTS	property and  from  configura-
		 tion requests)	is to be interpreted. If the resource value is
		 True, the information is interpreted as the position  of  the
		 mwm  client window frame. If the value	is False, it is	inter-
		 preted	as being the position of the client area of  the  win-
		 dow. The default value	of this	resource is True.

       positionOnScreen	(class	PositionOnScreen)
		 This  resource	 is  used to indicate that windows should ini-
		 tially	be placed (if possible)	so that	they are  not  clipped
		 by the	edge of	the screen (if the resource value is True). If
		 a window is larger than the size of the screen, at least  the
		 upper-left corner of the window is on-screen. If the resource
		 value is False, windows are placed in the requested  position
		 even  if  totally  off-screen.	 The default value of this re-
		 source	is True.

       quitTimeout (class  QuitTimeout)
		 This resource specifies the amount of time (in	 milliseconds)
		 that  mwm  will  wait	for  a client to update	the WM_COMMAND
		 property after	mwm has	sent the WM_SAVE_YOURSELF message. The
		 default  value	 of  this resource is 1000 (ms). (Refer	to the
		 f.kill	function description for additional information.)

       raiseKeyFocus (class  RaiseKeyFocus)
		 This resource is available only when the keyboard input focus
		 policy	is explicit. When set to True, this resource specifies
		 that a	window raised by means	of  the	 f.normalize_and_raise
		 function  also	receives the input focus. The default value of
		 this resource is False.

       refreshByClearing (class	 RefreshByClearing)
		 This resource determines the mechanism	used to	refresh	a win-
		 dow  (or the screen) when the f.refresh_win (f.refresh) func-
		 tion is executed. When	set to True,  an  XClearArea  is  per-
		 formed	 over the window for f.refresh_win. When set to	False,
		 a covering window is created and destroyed over  the  top  of
		 the  window to	be refreshed. If the function is f.refresh and
		 this resource is set to True, then an XClearArea is performed
		 over  every  window on	the screen.  If	the resource is	set to
		 False,	then one large window covering the  entire  screen  is
		 created  and destroyed. The default value of this resource is
		 True.

       rootButtonClick (class  RootButtonClick)
		 The rootButtonClick resource controls whether the a click  on
		 the  root  window will	post the root menu in a	"sticky" mode.
		 If this resource is set to True, a button click on  the  root
		 window	 will post the menu bound to the button	down event for
		 that button in	a "sticky" fashion.  If	this resource  is  set
		 to  False,  then  the	same button click would	only cause the
		 menu to flash as it would be  unposted	 once  the  button  up
		 event	is  seen.   The	criterion used to determine if it is a
		 button	click is if the	pointer	doesn't	move between the  but-
		 ton down and button up	events.	The default value for this re-
		 source	is True.

       screens (class  Screens)
		 This resource specifies the resource names  to	 use  for  the
		 screens  managed  by mwm. If mwm is managing a	single screen,
		 only the first	name in	the list is used. If mwm  is  managing
		 multiple  screens,  the  names	are assigned to	the screens in
		 order,	starting with screen 0.	Screen 0 gets the first	 name,
		 screen	1 the second name, and so on. The default screen names
		 are 0,	1, and so on.

       sessionClientDB (class  SessionClientDB)
		 This resource identifies a file name to use as	 a  root  when
		 saving	 state at the request of an XSMP session manager. When
		 the session is	saved, the window manager will then reuse  the
		 file name by automatically incrementing a suffix.

       showFeedback (class  ShowFeedback)
		 This  resource	 controls  whether  or not feedback windows or
		 confirmation dialogs are displayed. A feedback	window shows a
		 client	window's initial placement and shows position and size
		 during	move and resize	operations.  Confirmation dialogs  can
		 be  displayed	for certain operations.	The value for this re-
		 source	is a list of names of the feedback options to  be  en-
		 abled or disabled; the	names must be separated	by a space. If
		 an option is preceded by a minus sign,	 that  option  is  ex-
		 cluded	 from the list.	The sign of the	first item in the list
		 determines the	initial	set of options.	 If the	 sign  of  the
		 first	option	is  minus, mwm assumes all options are present
		 and starts subtracting	from that set.	If  the	 sign  of  the
		 first	decoration is plus (or not specified), mwm starts with
		 no options and	builds up a list from the resource.

       The names of the	feedback options are shown below:

       Name	     Description
       all	     Show all feedback (Default	value).
       behavior	     Confirm behavior switch.
       kill	     Confirm on	receipt	of KILL	signal.
       move	     Show position during move.
       none	     Show no feedback.
       placement     Show position and size during initial place-
		     ment.
       quit	     Confirm quitting mwm.
       resize	     Show size during resize.
       restart	     Confirm mwm restart.

       The following command line illustrates the syntax for showFeedback:

       Mwm*showFeedback: placement resize behavior restart

       This resource specification provides feedback for initial client	place-
       ment and	resize,	and enables the	dialog boxes to	 confirm  the  restart
       and set behavior	functions. It disables feedback	for the	move function.
       The default value for this resource is all.

       startupKeyFocus (class  StartupKeyFocus)
		 This resource is available only when the keyboard input focus
		 policy	 is  explicit. When given the default value of True, a
		 window	gets the keyboard  input  focus	 when  the  window  is
		 mapped	(that is, initially managed by the window manager). It
		 is recommended	that both autoKeyFocus and startupKeyFocus  be
		 True to work with tear	off menus. The default value is	True.

       wMenuButtonClick	(class	WMenuButtonClick)
		 This resource indicates whether a click of the	mouse when the
		 pointer is over the  window  menu  button  posts  and	leaves
		 posted	 the  window menu. If the value	given this resource is
		 True, the menu	remains	posted.	True is	the default value  for
		 this resource.

       wMenuButtonClick2 (class	 WMenuButtonClick2)
		 When this resource is given the default value of True,	a dou-
		 ble-click action on the window	menu  button  does  an	f.kill
		 function.

   Screen Specific Appearance and Behavior Resources
       The   syntax   for   specifying	 screen	 specific  resources  is  Mwm*
       screen_name*resource_id For example,  Mwm*1*keyBindings	specifies  the
       key bindings to use for screen "1".

   Screen Specific Resources
       Name			Class			 Value Type	Default
       buttonBindings		ButtonBindings		 string		DefaultButtonBindings
       cleanText		CleanText		 T/F		T
       fadeNormalIcon		FadeNormalIcon		 T/F		F
       feedbackGeometry		FeedbackGeometry	 string		center on screen
       frameBorderWidth		FrameBorderWidth	 pixels		varies
       iconBoxGeometry		IconBoxGeometry		 string		6x1+0-0
       iconBoxName		IconBoxName		 string		iconbox
       iconBoxSBDisplayPolicy	IconBoxSBDisplayPolicy	 string		all
       iconBoxTitle		IconBoxTitle		 XmString	Icons
       iconDecoration		IconDecoration		 string		varies
       iconImageMaximum		IconImageMaximum	 wxh		48x48
       iconImageMinimum		IconImageMinimum	 wxh		16x16
       iconPlacement		IconPlacement		 string		left bottom
       iconPlacementMargin	IconPlacementMargin	 pixels		varies
       keyBindings		KeyBindings		 string		DefaultKeyBindings
       limitResize		LimitResize		 T/F		T
       maximumMaximumSize	MaximumMaximumSize	 wxh (pixels)	2X screen w&h
       moveOpaque		MoveOpaque		 T/F		F
       resizeBorderWidth	ResizeBorderWidth	 pixels		varies
       resizeCursors		ResizeCursors		 T/F		T
       transientDecoration	TransientDecoration	 string		menu title
       transientFunctions	TransientFunctions	 string		-minimize-maximize
       useIconBox		UseIconBox		 T/F		F

       buttonBindings (class  ButtonBindings)
		 This  resource	identifies the set of button bindings for win-
		 dow management	functions. The named set of button bindings is
		 specified  in the mwm resource	description file. These	button
		 bindings are merged with the built-in default	bindings.  The
		 default value for this	resource is "DefaultButtonBindings".

       cleanText (class	 CleanText)
		 This  resource	controls the display of	window manager text in
		 the client title and feedback windows.	If the	default	 value
		 of  True is used, the text is drawn with a clear (no stipple)
		 background. This makes	text easier to read on monochrome sys-
		 tems  where  a	 backgroundPixmap is specified.	Only the stip-
		 pling in the area immediately around the text is cleared.  If
		 False,	 the  text  is	drawn  directly	on top of the existing
		 background.

       fadeNormalIcon (class  FadeNormalIcon)
		 If this resource is given a value of True, an icon is	grayed
		 out  whenever	it  has	 been  normalized (its window has been
		 opened). The default value is False.

       feedbackGeometry	(class	FeedbackGeometry)
		 This resource sets the	position of the	move and resize	 feed-
		 back  window.	If this	resource is not	specified, the default
		 is to place the feedback window at the	center of the  screen.
		 The  value  of	 the  resource	is  a standard window geometry
		 string	with the following syntax: [=]{	 +-}xoffset{+-}	 yoff-
		 set]

       frameBorderWidth	(class	FrameBorderWidth)
		 This  resource	 specifies  the	 width (in pixels) of a	client
		 window	frame border without resize handles. The border	 width
		 includes  the 3-D shadows.  The default value is based	on the
		 size and resolution of	the screen.

       iconBoxGeometry (class  IconBoxGeometry)
		 This resource indicates the initial position and size of  the
		 icon box.  The	value of the resource is a standard window ge-
		 ometry	 string	  with	 the   following   syntax:   [=][width
		 xheight][{+-}xoffset {+-}yoffset] If the offsets are not pro-
		 vided,	the iconPlacement policy is used to determine the ini-
		 tial  placement.  The	units for width	and height are columns
		 and rows. The actual screen size of the icon box  window  de-
		 pends	on  the	iconImageMaximum (size)	and iconDecoration re-
		 sources. The default value for	size is	(6 * iconWidth +  pad-
		 ding)	wide  by  (1 * iconHeight + padding) high. The default
		 value of the location is +0 -0.

       iconBoxName (class  IconBoxName)
		 This resource specifies the name that is used to look up icon
		 box resources.	 The default name is iconbox.

       iconBoxSBDisplayPolicy (class  IconBoxSBDisplayPolicy)
		 This  resource	specifies the scroll bar display policy	of the
		 window	manager	in the icon box. The resource has three	possi-
		 ble values: all, vertical, and	horizontal. The	default	value,
		 "all",	causes both vertical and horizontal scroll bars	always
		 to  appear.  The  value  "vertical"  causes a single vertical
		 scroll	bar to appear in the icon box and sets the orientation
		 of the	icon box to horizontal (regardless of the iconBoxGeom-
		 etry specification). The value	"horizontal" causes  a	single
		 horizontal  scroll bar	to appear in the icon box and sets the
		 orientation of	the icon box to	vertical  (regardless  of  the
		 iconBoxGeometry specification).

       iconBoxTitle (class  IconBoxTitle)
		 This  resource	 specifies  the	name that is used in the title
		 area of the icon box frame. The default value is Icons.

       iconDecoration (class  IconDecoration)
		 This resource specifies the general icon decoration. The  re-
		 source	 value	is label (only the label part is displayed) or
		 image (only the image part is displayed) or label image (both
		 the label and image parts are displayed).  A value of active-
		 label can also	be specified to	get a label (not truncated  to
		 the width of the icon)	when the icon is selected. The default
		 icon decoration for icon box icons is that each  icon	has  a
		 label	part and an image part (label image). The default icon
		 decoration for	stand alone icons is that each icon has	an ac-
		 tive label part, a label part,	and an image part (activelabel
		 label image).

       iconImageMaximum	(class	IconImageMaximum)
		 This resource specifies the maximum size of the  icon	image.
		 The resource value is widthx height (for example, 64x64). The
		 maximum supported size	is 128x128.  The default value of this
		 resource is 50x50.

       iconImageMinimum	(class	IconImageMinimum)
		 This  resource	 specifies the minimum size of the icon	image.
		 The resource value is widthx height (for example, 32x50). The
		 minimum  supported  size is 16x16.  The default value of this
		 resource is 16x16.

       iconPlacement (class  IconPlacement)
		 This resource specifies the icon placement scheme to be used.
		 The resource value has	the following syntax:

		 primary_layout	secondary_layout [tight]

       The layout values are one of the	following:

       Value	  Description
       top	  Lay the icons	out top	to bottom.
       bottom	  Lay the icons	out bottom to top.
       left	  Lay the icons	out left to right.
       right	  Lay the icons	out right to left.

       A  horizontal  (vertical)  layout value should not be used for both the
       primary_layout and the secondary_layout (for example, don't use top for
       the primary_layout and bottom for the secondary_layout).

       The  primary_layout  indicates whether, when an icon placement is done,
       the icon	is placed in a row or a	column and the direction of placement.
       The  secondary_layout indicates where to	place new rows or columns. For
       example,	top right indicates that icons should be placed	top to	bottom
       on  the	screen	and that columns should	be added from right to left on
       the screen.

       The default placement is	left bottom (icons are placed left to right on
       the  screen,  with  the	first row on the bottom	of the screen, and new
       rows added from the bottom of the screen	to the top of the  screen).  A
       tight value places icons	with zero spacing in between icons. This value
       is useful for aesthetic reasons,	as  well  as  X-terminals  with	 small
       screens.

       iconPlacementMargin (class  IconPlacementMargin)
		 This  resource	 sets  the  distance  between  the edge	of the
		 screen	and the	icons that are placed along the	 edge  of  the
		 screen. The value should be greater than or equal to 0. A de-
		 fault value (see below) is used if the	value specified	is in-
		 valid.	 The  default  value for this resource is equal	to the
		 space between icons as	they are placed	on  the	 screen	 (this
		 space	is based on maximizing the number of icons in each row
		 and column).

       keyBindings (class  KeyBindings)
		 This resource identifies the set of key bindings  for	window
		 management  functions.	 If  specified,	these key bindings re-
		 place the built-in default bindings. The  named  set  of  key
		 bindings  is  specified in mwm	resource description file. The
		 default value for this	resource is "DefaultKeyBindings".

       limitResize (class  LimitResize)
		 If this resource is True, the user is not allowed to resize a
		 window	 to  greater  than the maximum size. The default value
		 for this resource is True.

       maximumMaximumSize (class  MaximumMaximumSize)
		 This resource is used to limit	the maximum size of  a	client
		 window	 as  set  by the user or client. The resource value is
		 widthxheight (for example, 1024x1024)	where  the  width  and
		 height	 are  in pixels. The default value of this resource is
		 twice the screen width	and height.

       moveOpaque (class  MoveOpaque)
		 This resource controls	whether	the actual window is moved  or
		 a rectangular outline of the window is	moved. A default value
		 of False displays a rectangular outline on moves.

       resizeBorderWidth (class	 ResizeBorderWidth)
		 This resource specifies the width (in	pixels)	 of  a	client
		 window	frame border with resize handles. The specified	border
		 width includes	the 3-D	shadows.  The default value  is	 based
		 on the	size and resolution of the screen.

       resizeCursors (class  ResizeCursors)
		 This  is  used	to indicate whether the	resize cursors are al-
		 ways displayed	when the pointer is in the window size border.
		 If  True, the cursors are shown, otherwise the	window manager
		 cursor	is shown. The default value is True.

       transientDecoration (class  TransientDecoration)
		 This controls the amount of decoration	that mwm puts on tran-
		 sient	windows.  The  decoration specification	is exactly the
		 same as for the clientDecoration (client specific)  resource.
		 Transient  windows  are  identified  by  the WM_TRANSIENT_FOR
		 property, which is added by the client	to  indicate  a	 rela-
		 tively	 temporary window. The default value for this resource
		 is menu title (that is, transient windows have	frame  borders
		 and a titlebar	with a window menu button).

		 An  application can also specify which	decorations mwm	should
		 apply to its windows. If it does so, mwm applies  only	 those
		 decorations  indicated	 by both the application and the tran-
		 sientDecoration resource. Otherwise, mwm applies the  decora-
		 tions indicated by the	transientDecoration resource. For more
		 information see the description of XmNmwmDecorations  on  the
		 VendorShell(3)	reference page.

       transientFunctions (class  TransientFunctions)
		 This  resource	 is  used  to indicate which window management
		 functions are applicable (or  not  applicable)	 to  transient
		 windows.  The	function  specification	is exactly the same as
		 for the clientFunctions (client specific) resource.  The  de-
		 fault value for this resource is -minimize -maximize.

		 An  application  can  also specify which functions mwm	should
		 apply to its windows. If it does so, mwm applies  only	 those
		 functions  indicated  by  both	 the application and the tran-
		 sientFunctions	resource. Otherwise, mwm applies the functions
		 indicated by the transientFunctions resource. For more	infor-
		 mation	see the	description of XmNmwmFunctions on the  Vendor-
		 Shell(3) reference page.

       useIconBox (class  UseIconBox)
		 If  this  resource is given a value of	True, icons are	placed
		 in an icon box. When an icon box is not used, the  icons  are
		 placed	on the root window (default value).

   Client Specific Resources
       The syntax for specifying client	specific resources is

       Mwm*client_name_or_class	*resource_id

       For example, Mwm*mterm*windowMenu is used to specify the	window menu to
       be used with mterm clients. The syntax for specifying  client  specific
       resources for all classes of clients is

       Mwm*resource_id

       Specific	 client	specifications take precedence over the	specifications
       for all clients.	For example, Mwm*windowMenu is	used  to  specify  the
       window  menu  to	 be  used for all classes of clients that don't	have a
       window menu specified.

       The syntax for specifying resource values for windows that have an  un-
       known  name  and	 class	(that  is, windows that	do not have a WM_CLASS
       property	associated with	them) is

       Mwm*defaults*resource_id

       For example, Mwm*defaults*iconImage is used to specify the  icon	 image
       to be used for windows that have	an unknown name	and class.

       The following client specific resources can be specified:

   Client Specific Resources
       Name			 Class		     Value Type		   Default
       clientDecoration		 ClientDecoration    string		   all.
       clientFunctions		 ClientFunctions     string		   all.
       focusAutoRaise		 FocusAutoRaise	     T/F		   varies
       iconImage		 IconImage	     pathname		   (image)
       iconImage-		 Background	     color		   icon	background
       Background
       iconImageBottom-		 Foreground	     color		   icon
       ShadowColor							   bottom shadow
       iconImageBottom-		 BottomShadow-	     color		   icon	bottom
       ShadowPixmap		 Pixmap					   shadow pixmap
       iconImageForeground	 Foreground	     color		   varies
       iconImageTopShadowColor	 Background	     color		   icon	top
									   shadow color
       iconImageTop-		 TopShadowPixmap     color		   icon	top
       ShadowPixmap							   shadow pixmap
       matteBackground		 Background	     color		   background
       matteBottom-		 Foreground	     color		   bottom
       ShadowColor							   shadow color
       matteBottom-		 BottomShadow-	     color		   bottom
       ShadowPixmap		 Pixmap					   shadow pixmap
       matteForeground		 Foreground	     color		   foreground
       matteTopShadowColor	 Background	     color		   top
									   shadow color
       matteTopShadowPixmap	 TopShadowPixmap     color		   top
									   shadow pixmap
       matteWidth		 MatteWidth	     pixels		   0
       maximumClientSize	 MaximumClientSize   wxh
						     vertical horizontal   fill	the screen
       useClientIcon		 UseClientIcon	     T/F		   T
       usePPosition		 UsePPosition	     string		   nonzero
       windowMenu		 WindowMenu	     string		   DefaultWindowMenu

       clientDecoration	(class	ClientDecoration)
		 This resource controls	the amount of window frame decoration.
		 The resource is specified as a	list of	decorations to specify
		 their inclusion in the	frame.	If a decoration	is preceded by
		 a minus sign, that decoration is excluded from	the frame. The
		 sign  of  the	first  item in the list	determines the initial
		 amount	of decoration. If the sign of the first	decoration  is
		 minus,	 mwm  assumes  all  decorations	are present and	starts
		 subtracting from that set. If the sign	of the	first  decora-
		 tion is plus (or not specified), then mwm starts with no dec-
		 oration and builds up a list from the resource.

		 An application	can also specify which decorations mwm	should
		 apply	to  its	windows. If it does so,	mwm applies only those
		 decorations indicated by both the application and the client-
		 Decoration  resource.	Otherwise, mwm applies the decorations
		 indicated by the clientDecoration resource.  For more	infor-
		 mation	 see  the description of XmNmwmDecorations on the Ven-
		 dorShell(3) reference page.

		 Name	      Description
		 all	      Include all decorations (default value).
		 border	      Window border.
		 maximize     Maximize button (includes	title bar).
		 minimize     Minimize button (includes	title bar).
		 none	      No decorations.
		 resizeh      Border resize handles (includes border).
		 menu	      Window menu button (includes title bar).
		 title	      Title bar	(includes border).

       Examples: Mwm*XClock.clientDecoration: -resizeh -maximize This  removes
       the   resize   handles	and   maximize	button	from  XClock  windows.
       Mwm*XClock.clientDecoration: menu minimize border This  does  the  same
       thing as	above. Note that either	menu or	minimize implies title.

       clientFunctions (class  ClientFunctions)
		 This resource is used to indicate which mwm functions are ap-
		 plicable (or not applicable) to the client window. The	 value
		 for  the  resource is a list of functions. If the first func-
		 tion in the list has a	minus sign in front of	it,  then  mwm
		 starts	with all functions and subtracts from that set.	If the
		 first function	in the list has	a plus sign in	front  of  it,
		 then  mwm starts with no functions and	builds up a list. Each
		 function in the list must be preceded by the appropriate plus
		 or  minus  sign  and  separated  from	the next function by a
		 space.

		 An application	can also specify which	functions  mwm	should
		 apply	to  its	windows. If it does so,	mwm applies only those
		 functions indicated by	both the application and  the  client-
		 Functions  resource. Otherwise, mwm applies the functions in-
		 dicated by the	clientFunctions	resource.  For	more  informa-
		 tion  see  the	 description of	XmNmwmFunctions	on the Vendor-
		 Shell(3) reference page.

       The following table lists the functions available for this resource:

       Name	   Description
       all	   Include all functions (default value).
       none	   No functions.
       resize	   f.resize<*>.
       move	   f.move<*>.
       minimize	   f.minimize<*>.
       maximize	   f.maximize<*>.
       close	   f.kill<*>.

       <*>See mwmrc(4).

       focusAutoRaise (class  FocusAutoRaise)
		 When the value	of this	resource is True, clients  are	raised
		 when  they  get  the  keyboard	 input	focus. If the value is
		 False,	the stacking of	windows	on the display is not  changed
		 when  a  window  gets	the keyboard input focus.  The default
		 value is True when the	keyboardFocusPolicy  is	 explicit  and
		 False when the	keyboardFocusPolicy is pointer.

       iconImage (class	 IconImage)
		 This  resource	 can  be  used	to specify an icon image for a
		 client	(for example, "Mwm*myclock*iconImage").	 The  resource
		 value is a pathname for a pixmap or bitmap file. The value of
		 the (client specific) useClientIcon resource is used  to  de-
		 termine whether or not	user supplied icon images are used in-
		 stead of client supplied icon images. The default value is to
		 display a built-in window manager icon	image.

       iconImageBackground (class  Background)
		 This  resource	specifies the background color of the icon im-
		 age that is displayed in the image part of an icon.  The  de-
		 fault	value  of  this	 resource is the icon background color
		 (that is,  specified  by  "Mwm*background  or	Mwm*icon*back-
		 ground).

       iconImageBottomShadowColor (class  Foreground)
		 This  resource	 specifies the bottom shadow color of the icon
		 image that is displayed in the	image part of an icon. The de-
		 fault	value of this resource is the icon bottom shadow color
		 (that is, specified by	Mwm*icon*bottomShadowColor).

       iconImageBottomShadowPixmap (class  BottomShadowPixmap)
		 This resource specifies the bottom shadow Pixmap of the  icon
		 image that is displayed in the	image part of an icon. The de-
		 fault value of	this resource is the icon bottom shadow	Pixmap
		 (that is, specified by	Mwm*icon*bottomShadowPixmap).

       iconImageForeground (class  Foreground)
		 This  resource	specifies the foreground color of the icon im-
		 age that is displayed in the image part of an icon.  The  de-
		 fault	value  of  this	 resource varies depending on the icon
		 background.

       iconImageTopShadowColor (class  Background)
		 This resource specifies the top shadow	color of the icon  im-
		 age  that  is displayed in the	image part of an icon. The de-
		 fault value of	this resource is the  icon  top	 shadow	 color
		 (that is, specified by	Mwm*icon*topShadowColor).

       iconImageTopShadowPixmap	(class	TopShadowPixmap)
		 This resource specifies the top shadow	Pixmap of the icon im-
		 age that is displayed in the image part of an icon.  The  de-
		 fault	value  of  this	resource is the	icon top shadow	pixmap
		 (that is, specified by	Mwm*icon*topShadowPixmap).

       matteBackground	(class	Background)
		 This resource specifies the background	color  of  the	matte,
		 when  matteWidth  is  positive. The default value of this re-
		 source	is the client background color (that is, specified  by
		 "Mwm*background or Mwm*client*background).

       matteBottomShadowColor (class  Foreground)
		 This resource specifies the bottom shadow color of the	matte,
		 when matteWidth is positive. The default value	 of  this  re-
		 source	 is the	client bottom shadow color (that is, specified
		 by Mwm*bottomShadowColor or Mwm*client*bottomShadowColor).

       matteBottomShadowPixmap (class  BottomShadowPixmap)
		 This resource specifies  the  bottom  shadow  Pixmap  of  the
		 matte,	when matteWidth	is positive. The default value of this
		 resource is the client	bottom shadow pixmap (that is,	speci-
		 fied  by  Mwm*bottomShadowPixmap  or Mwm*client*bottomShadow-
		 Pixmap).

       matteForeground (class  Foreground)
		 This resource specifies the foreground	color  of  the	matte,
		 when  matteWidth  is  positive. The default value of this re-
		 source	is the client foreground color (that is, specified  by
		 Mwm*foreground	or Mwm*client*foreground).

       matteTopShadowColor (class  Background)
		 This  resource	 specifies  the	top shadow color of the	matte,
		 when matteWidth is positive. The default value	 of  this  re-
		 source	 is the	client top shadow color	(that is, specified by
		 Mwm*topShadowColor or Mwm*client*topShadowColor).

       matteTopShadowPixmap (class  TopShadowPixmap)
		 This resource specifies the top shadow	pixmap of  the	matte,
		 when  matteWidth  is  positive. The default value of this re-
		 source	is the client top shadow pixmap	(that is, specified by
		 "Mwm*topShadowPixmap or Mwm*client*topShadowPixmap).

       matteWidth (class  MatteWidth)
		 This  resource	specifies the width of the optional matte. The
		 default value is 0, which effectively disables	the matte.

       maximumClientSize (class	 MaximumClientSize)
		 This resource is either a size	specification or  a  direction
		 that  indicates  how  a client	window is to be	maximized. The
		 resource value	can  be	 specified  as	a  size	 specification
		 widthxheight.	The  width  and	 height	are interpreted	in the
		 units that the	client uses (for example, for terminal	emula-
		 tors  this  is	generally characters). Alternately, "vertical"
		 or "horizontal" can be	specified to indicate the direction in
		 which the client maximizes.

		 If  this resource is not specified, the maximum size from the
		 WM_NORMAL_HINTS property is used if set.  Otherwise  the  de-
		 fault	value  is the size where the client window with	window
		 management borders fills the screen. When the maximum	client
		 size is not determined	by the maximumClientSize resource, the
		 maximumMaximumSize resource value is used as a	constraint  on
		 the maximum size.

       useClientIcon (class  UseClientIcon)
		 If  the  value	given for this resource	is True, a client-sup-
		 plied icon image takes	precedence over	a  user-supplied  icon
		 image.	 The default value is True, giving the client-supplied
		 icon image higher precedence than the user-supplied icon  im-
		 age.

       usePPosition (class  UsePPosition)
		 This  resource	specifies whether Mwm honors program specified
		 position PPosition specified in the WM_NORMAL_HINTS  property
		 in  the  absence  of an user specified	position. Setting this
		 resource to on, causes	mwm to always honor program  specified
		 position.  Setting this resource to off, causes mwm to	always
		 ignore	program	specified position. Setting this  resource  to
		 the default value of nonzero cause mwm	to honor program spec-
		 ified position	other than (0,0).

       windowMenu (class  WindowMenu)
		 This resource indicates the name of the  menu	pane  that  is
		 posted	when the window	menu is	popped up (usually by pressing
		 button	1 on the window	 menu  button  on  the	client	window
		 frame). Menu panes are	specified in the mwm resource descrip-
		 tion file. Window menus can be	customized on a	 client	 class
		 basis	by  creating  custom  menus  in	 your  mwmrc file (see
		 mwmrc(4) and specifying  resources  to	 activate  the	custom
		 menus.	    The	    resources	  have	   the	  form	  Mwm*
		 client_name_or_class*windowMenu. The default  value  of  this
		 resource is DefaultWindowMenu.

   Resource Description	File
       The mwm resource	description file is a supplementary resource file that
       contains	resource descriptions that are referred	to by entries  in  the
       resource	 manager  property  (see xrdb(1) and the defaults files	(.Xde-
       faults, app-defaults/Mwm	). It contains descriptions of resources  that
       are  to	be  used  by mwm, and that cannot be easily encoded in the de-
       faults files (a bitmap file is an analogous type	of  resource  descrip-
       tion  file). A particular mwm resource description file can be selected
       using the configFile resource.

       The following types of resources	can be described in the	 mwm  resource
       description file:

       Buttons	 Window	 manager functions can be bound	(associated) with but-
		 ton events.

       Keys	 Window	manager	functions can be bound (associated)  with  key
		 press events.

       Menus	 Menu  panes  can  be used for the window menu and other menus
		 posted	with key bindings and button bindings.

		 The mwm resource description file is described	in mwmrc(4).

   Environment
       The mwm window manager uses the environment  variable  HOME  specifying
       the user's home directory.

       The  mwm	 window	 manager uses the environment variable LANG specifying
       the user's choice of language for the mwm message catalog and  the  mwm
       resource	description file.

       The  mwm	 window	 uses the environment variable XFILESEARCHPATH,	XUSER-
       FILESEARCHPATH, XAPPLRESDIR, XENVIRONMENT, LANG,	and HOME in  determin-
       ing  search  paths for resource defaults	files.	The mwm	window manager
       may also	us XBMLANGPATH to search for bitmap files.

       The mwm window manager reads the	$HOME/.motifbind file if it exists  to
       install	a  virtual  key	bindings property on the root window. For more
       information on the content of the .motifbind file, see

       The mwm window manager  uses  the  environment  variable	 MWMSHELL  (or
       SHELL,  if  MWMSHELL is not set), specifying the	shell to use when exe-
       cuting commands via the f.exec function.

   Files
       /usr/X11R6/lib/X11/$LANG/system.mwmrc

       /usr/X11R6/lib/X11/system.mwmrc

       /usr/X11R6/lib/X11/app-defaults/Mwm

       $HOME/Mwm

       $HOME/$LANG/.mwmrc

       $HOME/.mwmrc

   RELATED INFORMATION
       VendorShell(3), VirtualBindings(3), X(1), XmInstallImage(3), xrdb(1).

									mwm(1)

NAME | SYNOPSIS | DESCRIPTION

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=mwm&sektion=1&manpath=FreeBSD+12.2-RELEASE+and+Ports>

home | help