[0m


mwm(1X)             UNIX Programmer's Manual		  mwm(1X)



[1mNAME
     mwm [0m- A Window Manager

[1mSYNOPSIS
     mwm [0m[_o_p_t_i_o_n_s]

[1mDESCRIPTION
     mwm [0mis an X11 client that provides window management func-
     tionality and some session management functionality.  It
     provides functions that facilitate control (by the user and
     the programmer) of elements of window states such as place-
     ment, size, icon/normal display, input focus ownership, etc.
     It also provides session management functions such as stop-
     ping a client.

[1mOPTIONS
     -display [0m_d_i_s_p_l_a_y
	     This option specifies the display to use; see _X(_1).

     [1m-xrm [0m_r_e_s_o_u_r_c_e_s_t_r_i_n_g
	     This option specifies a resource string to use.

[1mAppearance
     [0mThe 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 configuration of specific
     resources.  Resources are defined under the heading "X
     DEFAULTS."

[1mWindows
     [0mDefault [1mmwm [0mwindow 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 window to a new location.  A
		      wire frame is moved during 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.

     Minimize Button  To turn the window back into its icon, do a
		      button 1 click on the minimize button (the
		      frame box with a _s_m_a_l_l square in it).




Printed 25/11/91						1






mwm(1X)             UNIX Programmer's Manual		  mwm(1X)



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

     Window Menu Button
		      The window menu button is the frame box
		      with a horizontal bar in it.  To pop up the
		      window menu, press button 1.  While press-
		      ing, drag the pointer on the menu to your
		      selection, then release the button when
		      your selection is highlighted.  Alter-
		      nately, you can click button 1 to pop up
		      the menu and keep it posted; then position
		      the pointer and select.

				  [1mDefault Window Menu
	   Selection   Accelerator		   Description
	   [0m_R_e_s_t_o_r_e     Alt+F5	     Inactive (not an option for windows).
	   Move        Alt+F7	     Allows the window to be moved with keys
				     or mouse.
	   Size        Alt+F8	     Allows the window to be resized.
	   Minimize    Alt+F9	     Turns the window into an icon.
	   Maximize    Alt+F10	     Makes the window fill the screen.
	   Lower       Alt+F11	     Moves window to bottom of window stack.
	   Close       Alt+F4	     Removes client from [1mmwm [0mmanagement.

     Resize Border Handles
		      To change the size of a window, move the
		      pointer over a resize border handle (the
		      cursor will change), 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 rubber-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.  A matte is not actually part of the
		      window frame.  There is no functionality
		      associated with a matte.

[1mIcons
     [0mIcons are small graphic representations of windows.  A win-
     dow 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
     will cause the icon's window menu to pop up.  Releasing the



Printed 25/11/91						2






mwm(1X)             UNIX Programmer's Manual		  mwm(1X)



     button (press + release without moving mouse = click) will
     cause the menu to stay posted.  The menu contains the fol-
     lowing selections:

			  [1mIcon Window Menu
  Selection   Accelerator		  Description
  [0mRestore     Alt+F5	    Opens the associated window.
  Move	      Alt+F7	    Allows the icon to be moved with keys.
  _S_i_z_e	      Alt+F8	    Inactive (not an option for icons).
  _M_i_n_i_m_i_z_e    Alt+F9	    Inactive (not an option for icons).
  Maximize    Alt+F10	    Opens the associated window and makes
			    it fill the screen.
  Lower       Alt+F11	    Moves icon to bottom of icon stack.
  Close       Alt+F4	    Removes client from [1mmwm [0mmanagement.

     Double-clicking button 1 on an icon normalizes the icon into
     its associated window.  Double-clicking button 1 on the icon
     box's icon opens the icon box and allow access to the con-
     tained icons.  (In general, double-clicking a mouse button
     offers a quick way to have a function performed.  Another
     example is double-clicking button 1 with the pointer on the
     window menu button.  This closes the window.)

[1mIcon Box
     [0mWhen icons begin to clutter the screen, they can be packed
     into an "icon box."  (To use an icon box, [1mmwm [0mmust be
     started with the icon box configuration already set.) The
     icon box is a window manager window that holds client icons.
     Icons in the icon box can be manipulated with the mouse.
     The following table summarizes the behavior of this inter-
     face.  Button actions apply whenever the pointer is on any
     part of the icon.

      [1mButton Action			 Description
  [0mButton 1 click	  Selects the icon.
  Button 1 double click   Normalizes (opens) the associated window.
  Button 1 double click   Raises an already _o_p_e_n window
			  to the top of the stack.
  Button 1 drag           Moves the icon.

     The window menu of the icon box differs from the window menu
     of a client window: The "Close" selection is replaced with
     the "PackIcons Alt+F12" selection.  When selected, PackIcons
     packs the icons in the box to achieve neat rows with no
     empty slots.

[1mInput Focus
     mwm [0msupports (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 win-
     dow is explicitly selected to get keyboard input, or the



Printed 25/11/91						3






mwm(1X)             UNIX Programmer's Manual		  mwm(1X)



     window is iconified.  There are numerous resources that con-
     trol the input focus.  The client window with the keyboard
     input focus has the active window appearance with a visually
     distinctive window frame.

     The following tables summarize the keyboard input focus
     selection behavior:

  [1mButton Action           Object	     Function Description
  [0mButton 1 press   Window / window frame   Keyboard focus selection
  Button 1 press   Icon                    Keyboard focus selection

   [1mKey Action			    Function Description
[0m[Alt][Tab]	    Move input focus to next window in window stack.
[Alt][Shift][Tab]   Move input focus to previous window in window stack.

[1mWindow stacking
     [0mThe stacking order of windows may be changed as a result of
     setting the keyboard input focus, iconifying a window, or by
     doing a window manager window stacking function.

     When a window is iconified, the window's icon is placed on
     the bottom of the stack.

     The following table summarizes the default window stacking
     behavior of the window manager:

	   [1mKey Action		   Function Description
	[0m[Alt][ESC]	    Put bottom window on top of stack.
	[Alt][Shift][ESC]   Put top window on bottom of stack.

     A window can also be raised to the top when it gets the key-
     board input focus (e.g., by doing a button 1 press on the
     window or by using [Alt][Tab]) if this auto-raise feature is
     enabled with the [1mfocusAutoRaise [0mresource.



[1mX DEFAULTS
     mwm [0mis configured from its resource database.  This database
     is built from the following sources. They are listed in
     order of precedence, low to high:

	    app-defaults/Mwm
	    RESOURCE_MANAGER root window property or $HOME/.Xdefaults
	    XENVIRONMENT variable or $HOME/.Xdefaults-host
	    [1mmwm [0mcommand line options

     Entries in the resource database may refer to other resource
     files for specific types of resources.  These include files
     that contain bitmaps, fonts, and [1mmwm [0mspecific resources such
     as menus and behavior specifications (i.e., button and key



Printed 25/11/91						4






mwm(1X)             UNIX Programmer's Manual		  mwm(1X)



     bindings).

     [1mMwm [0mis the resource class name of [1mmwm [0mand [1mmwm [0mis the
     resource name used by [1mmwm [0mto look up resources.  In the fol-
     lowing discussion of resource specification "Mwm" and "mwm"
     can be used interchangeably.

     [1mmwm [0muses the following types of resources:

     _C_o_m_p_o_n_e_n_t _A_p_p_e_a_r_a_n_c_e _R_e_s_o_u_r_c_e_s:

     These resources specify appearance attributes of window
     manager user interface components.  They can be applied to
     the appearance of window manager menus, feedback windows
     (e.g., the window reconfiguration feedback window), client
     window frames, and icons.

     _S_p_e_c_i_f_i_c _A_p_p_e_a_r_a_n_c_e _a_n_d _B_e_h_a_v_i_o_r _R_e_s_o_u_r_c_e_s:

     These resources specify [1mmwm [0mappearance and behavior (e.g.,
     window management policies).  They are not set separately
     for different [1mmwm [0muser interface components.

     _C_l_i_e_n_t _S_p_e_c_i_f_i_c _R_e_s_o_u_r_c_e_s:

     These [1mmwm [0mresources can be set for a particular client win-
     dow 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 (e.g.,
     foreground) or a resource class (e.g., 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 $_H_O_M_E environment variable (generally the user's home
     directory). This is the only environment variable [1mmwm [0muses
     directly ($XENVIRONMENT is used by the resource manager).

[1mComponent Appearance Resources
     [0mThe syntax for specifying _c_o_m_p_o_n_e_n_t _a_p_p_e_a_r_a_n_c_e _r_e_s_o_u_r_c_e_s
     that apply to window manager icons, menus, and client window
     frames is

	    [1mMwm*[0m_r_e_s_o_u_r_c_e__i_d

     For example, [1mMwm*foreground [0mis used to specify the fore-
     ground color for [1mmwm [0mmenus, icons, and client window frames.

     The syntax for specifying _c_o_m_p_o_n_e_n_t _a_p_p_e_a_r_a_n_c_e _r_e_s_o_u_r_c_e_s
     that apply to a particular [1mmwm [0mcomponent is

	    [1mMwm*[0m[[1mmenu[0m|[1micon[0m|[1mclient[0m|[1mfeedback[0m][1m*[0m_r_e_s_o_u_r_c_e__i_d



Printed 25/11/91						5






mwm(1X)             UNIX Programmer's Manual		  mwm(1X)



     If _m_e_n_u is specified, the resource is applied only to [1mmwm
     [0mmenus; if _i_c_o_n is specified, the resource is applied to
     icons; and if _c_l_i_e_n_t is specified, the resource is applied
     to client window frames.  For example, [1mMwm*icon*foreground
     [0mis used to specify the foreground color for [1mmwm [0micons,
     [1mMwm*menu*foreground [0mspecifies the foreground color for [1mmwm
     [0mmenus, and [1mMwm*client*foreground [0mis used to specify the
     foreground color for [1mmwm [0mclient window frames.

     The appearance of the title area of a client window frame
     (including window management buttons) can be separately con-
     figured.  The syntax for configuring the title area of a
     client window frame is:

	 [1mMwm*client*title*[0m_r_e_s_o_u_r_c_e__i_d

     For example, [1mMwm*client*title*foreground [0mspecifies the fore-
     ground 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:

	 [1mMwm*menu*[0m_m_e_n_u__n_a_m_e[1m*[0m_r_e_s_o_u_r_c_e__i_d

     For example, [1mMwm*menu*my_menu*foreground [0mspecifies the fore-
     ground color for the menu named [1mmy_menu[0m.

     The following _c_o_m_p_o_n_e_n_t _a_p_p_e_a_r_a_n_c_e _r_e_s_o_u_r_c_e_s that apply to
     all window manager parts can be specified:

	 [1mComponent Appearance Resources - All Window Manager Parts
     Name		  Class                 Value Type    Default
     [0mbackground           Background		color	      varies*
     backgroundPixmap	  BackgroundPixmap	string**      varies*
     bottomShadowColor	  Foreground		color	      varies*
     bottomShadowPixmap   BottomShadowPixmap	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.
     **Pixmap image name. See XmInstallImage(3X).
     ***X11 R3 Font description.


     [1mbackground [0m(class [1mBackground)
	     [0mThis resource specifies the background color. Any



Printed 25/11/91						6






mwm(1X)             UNIX Programmer's Manual		  mwm(1X)



	     legal X color may be specified.  The default value
	     is chosen based on the visual type of the screen.

     [1mbackgroundPixmap ([0mclass [1mBackgroundPixmap)
	     [0mThis resource specifies the background Pixmap of the
	     [1mmwm [0mdecoration when the window is inactive (does not
	     have the keyboard focus). The default value is
	     chosen based on the visual type of the screen.

     [1mbottomShadowColor ([0mclass [1mForeground)
	     [0mThis 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.

     [1mbottomShadowPixmap ([0mclass [1mBottomShadowPixmap)
	     [0mThis 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.

     [1mfontList ([0mclass [1mFont)
	     [0mThis 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 default is "fixed."

     [1mforeground ([0mclass [1mForeground)
	     [0mThis resource specifies the foreground color.  The
	     default is chosen based on the visual type of the
	     screen.

     [1msaveUnder ([0mclass [1mSaveUnder)
	     [0mThis is used to indicate whether "save unders" are
	     used for [1mmwm [0mcomponents.  For this to have any
	     effect, save unders must be implemented by the X
	     server.  If save unders are implemented, the X
	     server will save the contents of windows obscured by
	     windows that have the save under attribute set.  If
	     the saveUnder resource is True, [1mmwm [0mwill set the
	     save under attribute 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.

     [1mtopShadowColor ([0mclass [1mBackground)
	     [0mThis resource specifies the top shadow color. This
	     color is used for the upper and left bevels of the
	     window manager decoration. The default is chosen
	     based on the visual type of the screen.




Printed 25/11/91						7






mwm(1X)             UNIX Programmer's Manual		  mwm(1X)



     [1mtopShadowPixmap ([0mclass [1mTopShadowPixmap)
	     [0mThis resource specifies the top shadow Pixmap. This
	     Pixmap is used for the upper and left bevels of the
	     window manager decoration. The default is chosen
	     based on the visual type of the screen.

     The following _c_o_m_p_o_n_e_n_t _a_p_p_e_a_r_a_n_c_e _r_e_s_o_u_r_c_e_s that apply to
     frame and icons can be specified:

			 [1mFrame and Icon Components
     Name		       Class		   Value Type  Default
     [0mactiveBackground	       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(3X).


     [1mactiveBackground ([0mclass [1mBackground)
	     [0mThis resource specifies the background color of the
	     [1mmwm [0mdecoration when the window is active (has the
	     keyboard focus).  The default is chosen based on the
	     visual type of the screen.

     [1mactiveBackgroundPixmap ([0mclass [1mActiveBackgroundPixmap)
	     [0mThis resource specifies the background Pixmap of the
	     [1mmwm [0mdecoration when the window is active (has the
	     keyboard focus).  The default is chosen based on the
	     visual type of the screen.

     [1mactiveBottomShadowColor ([0mclass [1mForeground)
	     [0mThis resource specifies the bottom shadow color of
	     the [1mmwm [0mdecoration when the window is active (has
	     the keyboard focus).  The default is chosen based on
	     the visual type of the screen.

     [1mactiveBottomShadowPixmap ([0mclass [1mBottomShadowPixmap)
	     [0mThis resource specifies the bottom shadow Pixmap of
	     the mwm decoration when the window is active (has
	     the keyboard focus).  The default is chosen based on
	     the visual type of the screen.

     [1mactiveForeground ([0mclass [1mForeground)
	     [0mThis resource specifies the foreground color of the
	     [1mmwm [0mdecoration when the window is active (has the
	     keyboard focus).  The default is chosen based on the
	     visual type of the screen.



Printed 25/11/91						8






mwm(1X)             UNIX Programmer's Manual		  mwm(1X)



     [1mactiveTopShadowColor ([0mclass [1mBackground)
	     [0mThis resource specifies the top shadow color of the
	     [1mmwm [0mdecoration when the window is active (has the
	     keyboard focus).  The default is chosen based on the
	     visual type of the screen.

     [1mactiveTopShadowPixmap ([0mclass [1mTopShadowPixmap)
	     [0mThis resource specifies the top shadow Pixmap of the
	     [1mmwm [0mdecoration when the window is active (has the
	     keyboard focus).  The default is chosen based on the
	     visual type of the screen.

[1mSpecific Appearance And Behavior Resources
     [0mThe syntax for specifying _s_p_e_c_i_f_i_c _a_p_p_e_a_r_a_n_c_e _a_n_d _b_e_h_a_v_i_o_r
     _r_e_s_o_u_r_c_e_s is

	      [1mMwm*[0m_r_e_s_o_u_r_c_e__i_d

     For example, [1mMwm*keyboardFocusPolicy [0mspecifies the window
     manager policy for setting the keyboard focus to a particu-
     lar client window.

     The following _s_p_e_c_i_f_i_c _a_p_p_e_a_r_a_n_c_e _a_n_d _b_e_h_a_v_i_o_r _r_e_s_o_u_r_c_e_s can
     be specified:

		      [1mSpecific Appearance and Behavior Resources
     Name		 Class		     Value Type  Default
     [0mautoKeyFocus	 AutoKeyFocus	     T/F	 T
     autoRaiseDelay	 AutoRaiseDelay      millisec	 500
     bitmapDirectory	 BitmapDirectory     directory	 /usr/include/X11/bitmaps
     buttonBindings	 ButtonBindings      string	 NULL
     cleanText		 CleanText	     T/F	 T
     clientAutoPlace	 ClientAutoPlace     T/F	 T
     colormapFocusPolicy ColormapFocusPolicy string	 keyboard
     configFile          ConfigFile	     file	 .mwmrc
     deiconifyKeyFocus	 DeiconifyKeyFocus   T/F	 T
     doubleClickTime	 DoubleClickTime     millisec.	 500
     enforceKeyFocus	 EnforceKeyFocus     T/F	 T
     fadeNormalIcon	 FadeNormalIcon      T/F	 F
     frameBorderWidth	 FrameBorderWidth    pixels	 5
     iconAutoPlace	 IconAutoPlace	     T/F	 T
     iconBoxGeometry	 IconBoxGeometry     string	 6x1+0-0
     iconBoxName	 IconBoxName	     string	 iconbox
     iconBoxTitle	 IconBoxTitle	     string	 Icons
     iconClick		 IconClick	     T/F	 T
     iconDecoration	 IconDecoration      string	 varies
     iconImageMaximum	 IconImageMaximum    wxh	 50x50
     iconImageMinimum	 IconImageMinimum    wxh	 32x32
     iconPlacement	 IconPlacement	     string	 left bottom
     iconPlacementMargin IconPlacementMargin pixels	 varies
     interactivePlacementInteractivePlacementT/F	 F
     keyBindings	 KeyBindings	     string	 system



Printed 25/11/91						9






mwm(1X)             UNIX Programmer's Manual		  mwm(1X)



     keyboardFocusPolicy KeyboardFocusPolicy string	 explicit
     limitResize	 LimitResize	     T/F	 T
     lowerOnIconify	 LowerOnIconify      T/F	 T
     maximumMaximumSize  MaximumMaximumSize  wxh (pixels)2X screen w&h
     moveThreshold	 MoveThreshold	     pixels	 4
     passButtons	 PassButtons	     T/F	 F
     passSelectButton	 PassSelectButton    T/F	 T
     positionIsFrame	 PositionIsFrame     T/F	 T
     positionOnScreen	 PositionOnScreen    T/F	 T
     quitTimeout	 QuitTimeout	     millisec.	 1000
     resizeBorderWidth	 ResizeBorderWidth   pixels	 10
     resizeCursors	 ResizeCursors	     T/F	 T
     showFeedback	 ShowFeedback	     string	 all
     startupKeyFocus	 StartupKeyFocus     T/F	 T
     transientDecoration TransientDecoration string	 system title
     transientFunctions  TransientFunctions  string	 -minimize -maximize
     useIconBox          UseIconBox	     T/F	 F
     wMenuButtonClick	 WMenuButtonClick    T/F	 T
     wMenuButtonClick2	 WMenuButtonClick2   T/F	 T


     [1mautoKeyFocus ([0mclass [1mAutoKeyFocus)
	     [0mThis resource is only available 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.  The default value is True.

     [1mautoRaiseDelay ([0mclass [1mAutoRaiseDelay)
	     [0mThis resource is only available when the focusAu-
	     toRaise resource is True and the keyboard focus pol-
	     icy is pointer. The autoRaiseDelay resource speci-
	     fies the amount of time (in milliseconds) that [1mmwm
	     [0mwill wait before raising a window after it gets the
	     keyboard focus. The default value of this resource
	     is 500 (ms).

     [1mbitmapDirectory ([0mclass [1mBitmapDirectory)
	     [0mThis resource identifies a directory to be searched
	     for bitmaps referenced by [1mmwm [0mresources.  This
	     directory is searched if a bitmap is specified
	     without an absolute pathname.  The default value for
	     this resource is "/usr/include/X11/bitmaps".

     [1mbuttonBindings ([0mclass [1mButtonBindings)
	     [0mThis resource identifies the set of button bindings
	     for window management functions.  The named set of
	     button bindings is specified in the [1mmwm resource
	     description file[0m.	These button bindings are _m_e_r_g_e_d



Printed 25/11/91					       10






mwm(1X)             UNIX Programmer's Manual		  mwm(1X)



	     with the built-in default bindings.  The default
	     value for this resource is NULL (i.e., no button
	     bindings are added to the built-in button bindings).

     [1mcleanText ([0mclass[1mCleanText)
	     [0mThis 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 systems where a
	     backgroundPixmap is specified. Only the stippling in
	     the area immediately around the text is cleared.  If
	     False, the text is drawn directly on top of the
	     existing background.

     [1mclientAutoPlace ([0mclass [1mClientAutoPlace)
	     [0mThis resource determines the position of a window
	     when the window has not been given a user specified
	     position.	With a value of True, windows are posi-
	     tioned with the top left corners of the frames
	     offset horizontally and vertically.  A value of
	     False causes the currently configured position of
	     the window to be used.  In either case, [1mmwm [0mwill
	     attempt to place the windows totally on-screen.  The
	     default value is True.

     [1mcolormapFocusPolicy ([0mclass [1mColormapFocusPolicy)
	     [0mThis resource indicates the colormap focus policy
	     that is to be used.  If the resource value is expli-
	     cit then a colormap selection action is done on a
	     client window to set the colormap focus to that win-
	     dow.  If the value is pointer then the client window
	     containing the pointer has the colormap focus.  If
	     the value is keyboard then the client window that
	     has the keyboard input focus will have the colormap
	     focus.  The default value for this resource is key-
	     board.

     [1mconfigFile ([0mclass [1mConfigFile)
	     [0mThe resource value is the pathname for an [1mmwm
	     resource description file[0m.  The default is [1m.mwmrc [0min
	     the user's home directory (based on the $HOME
	     environment variable) if this file exists, otherwise
	     [1m/usr/lib/X11/system.mwmrc[0m.

     [1mdeiconifyKeyFocus ([0mclass [1mDeiconifyKeyFocus)
	     [0mThis resource only applies when the keyboard input
	     focus policy is explicit.	If a value of True is
	     used, a window will receive the keyboard input focus
	     when it is normalized (deiconified).  True is the
	     default value.




Printed 25/11/91					       11






mwm(1X)             UNIX Programmer's Manual		  mwm(1X)



     [1mdoubleClickTime ([0mclass [1mDoubleClickTime)
	     [0mThis resource is used to set the maximum time (in
	     ms) between the clicks (button presses) that make up
	     a double-click.  The default value of this resource
	     is 500 (ms).

     [1menforceKeyFocus ([0mclass [1mEnforceKeyFocus)
	     [0mIf this resource is given a value of True, then 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 exam-
	     ple 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.

     [1mfadeNormalIcon ([0mclass [1mFadeNormalIcon)
	     [0mIf 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.

     [1mframeBorderWidth ([0mclass [1mFrameBorderWidth)
	     [0mThis 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 5 pixels.

     [1miconAutoPlace ([0mclass [1mIconAutoPlace)
	     [0mThis resource indicates whether icons are automati-
	     cally placed on the screen by [1mmwm[0m, or are placed by
	     the user. Users may specify an initial icon position
	     and may move icons after initial placement; however,
	     [1mmwm [0mwill adjust the user-specified position to fit
	     into an invisible grid.  When icons are automati-
	     cally placed, [1mmwm [0mplaces them into the grid using a
	     scheme set with the iconPlacement resource. If the
	     iconAutoPlace resource has a value of True, then [1mmwm
	     [0mdoes automatic icon placement.  A value of False
	     allows user placement. The default value of this
	     resource is True.

     [1miconBoxGeometry ([0mclass [1mIconBoxGeometry)
	     [0mThis resource indicates the initial position and
	     size of the icon box.  The value of the resource is
	     a standard window geometry string with the following
	     syntax:

	  [[1m=[0m][_w_i_d_t_h[1mx[0m_h_e_i_g_h_t][{[1m+-[0m}_x_o_f_f_s_e_t{[1m+-[0m}_y_o_f_f_s_e_t]





Printed 25/11/91					       12






mwm(1X)             UNIX Programmer's Manual		  mwm(1X)



     If the offsets are not provided, the iconPlacement policy is
     used to determine the initial placement.  The units for
     width and height are columns and rows.

     The actual screen size of the icon box window will depend on
     the iconImageMaximum (size) and iconDecoration resources.
     The default value for size is (6 * iconWidth + padding) wide
     by (1 * iconHeight + padding) high.  The default value of
     the location is +0 -0.

     [1miconBoxName ([0mclass [1mIconBoxName)
	     [0mThis resource specifies the name that is used to
	     look up icon box resources.  The default name is
	     iconbox.

     [1miconBoxTitle ([0mclass [1mIconBoxTitle)
	     [0mThis resource specifies the name that is used in the
	     title area of the icon box frame.	The default value
	     is Icons.

     [1miconClick ([0mclass [1mIconClick)
	     [0mWhen 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.

     [1miconDecoration ([0mclass [1mIconDecoration)
	     [0mThis resource specifies the general icon decoration.
	     The resource 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 activelabel 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 active
	     label part, a label part and an image part
	     (activelabel label image).

     [1miconImageMaximum ([0mclass [1mIconImageMaximum)
	     [0mThis resource specifies the maximum size of the icon
	     _i_m_a_g_e.  The resource value is _w_i_d_t_h[1mx[0m_h_e_i_g_h_t (e.g.,
	     64x64).  The maximum supported size is 128x128.  The
	     default value of this resource is 50x50.

     [1miconImageMinimum ([0mclass [1mIconImageMinimum)
	     [0mThis resource specifies the minimum size of the icon
	     _i_m_a_g_e.  The resource value is _w_i_d_t_h[1mx[0m_h_e_i_g_h_t (e.g.,
	     32x50).  The minimum supported size is 16x16.  The
	     default value of this resource is 32x32.




Printed 25/11/91					       13






mwm(1X)             UNIX Programmer's Manual		  mwm(1X)



     [1miconPlacement ([0mclass [1mIconPlacement)
	     [0mThis resource specifies the icon placement scheme to
	     be used.  The resource value has the following syn-
	     tax:

		   _p_r_i_m_a_r_y__l_a_y_o_u_t  _s_e_c_o_n_d_a_r_y__l_a_y_o_u_t

     The layout values are one of the following:

	      [1mtop      [0mLay the icons out top to bottom.
	      [1mbottom   [0mLay the icons out bottom to top.
	      [1mleft     [0mLay the icons out left to right.
	      [1mright    [0mLay the icons out right to left.

	  A horizontal (vertical) layout value should not be used
	  for both the _p_r_i_m_a_r_y__l_a_y_o_u_t and the _s_e_c_o_n_d_a_r_y__l_a_y_o_u_t
	  (e.g., don't use top for the _p_r_i_m_a_r_y__l_a_y_o_u_t and bottom
	  for the _s_e_c_o_n_d_a_r_y__l_a_y_o_u_t).  The _p_r_i_m_a_r_y__l_a_y_o_u_t indi-
	  cates whether, when an icon placement is done, the icon
	  is placed in a row or a column and the direction of
	  placement.  The _s_e_c_o_n_d_a_r_y__l_a_y_o_u_t 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).

     [1miconPlacementMargin ([0mclass [1mIconPlacementMargin)
	     [0mThis 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 default value (see below) is
	     used if the value specified is invalid.  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).

     [1minteractivePlacement ([0mclass [1mInteractivePlacement)
	     [0mThis resource controls the initial placement of new
	     windows on the screen. If the value is True, then
	     the pointer shape changes before a new window is
	     placed on the screen to indicate to the user that a
	     position should be selected for the upper-left hand
	     corner of the window.  If the value is False, then
	     windows are placed according to the initial window
	     configuration attributes.	The default value of this
	     resource is False.




Printed 25/11/91					       14






mwm(1X)             UNIX Programmer's Manual		  mwm(1X)



     [1mkeyBindings ([0mclass [1mKeyBindings)
	     [0mThis resource identifies the set of key bindings for
	     window management functions.  If specified these key
	     bindings _r_e_p_l_a_c_e the built-in default bindings. The
	     named set of key bindings is specified in [1mmwm
	     resource description file[0m.  The default value for
	     this resource is the set of system-compatible key
	     bindings.

     [1mkeyboardFocusPolicy ([0mclass [1mKeyboardFocusPolicy)
	     [0mIf 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 decoration that [1mmwm [0madds).  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 [1mmwm [0mdecoration.  The
	     default value for this resource is explicit.

     [1mlimitResize ([0mclass [1mLimitResize)
	     [0mIf 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.

     [1mlowerOnIconify ([0mclass [1mLowerOnIconify)
	     [0mIf this resource is given the default value of True,
	     a window'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 associated window.

     [1mmaximumMaximumSize ([0mclass [1mMaximumMaximumSize)
	     [0mThis resource is used to limit the maximum size of a
	     client window as set by the user or client.  The
	     resource value is _w_i_d_t_h[1mx[0m_h_e_i_g_h_t (e.g., 1024x1024)
	     where the width and height are in pixels.	The
	     default value of this resource is twice the screen
	     width and height.

     [1mmoveThreshold ([0mclass [1mMoveThreshold)
	     [0mThis resource is used to control the sensitivity of
	     dragging operations that move windows and icons.
	     The value of this resource is the number of pixels
	     that the locator will be moved with a button down
	     before the move operation is initiated.  This is
	     used to prevent window/icon movement when a click or
	     double-click is done and there is unintentional
	     pointer movement with the button down.  The default
	     value of this resource is 4 (pixels).

     [1mpassButtons ([0mclass [1mPassButtons)



[0mPrinted 25/11/91					       15






mwm(1X)             UNIX Programmer's Manual		  mwm(1X)



	     This resource indicates whether or not button press
	     events are passed to clients after they are used to
	     do a window manager function in the client context.
	     If the resource 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 False.

     [1mpassSelectButton ([0mclass [1mPassSelectButton)
	     [0mThis resource indicates whether or not the keyboard
	     input focus selection button press (if keyboard-
	     FocusPolicy is explicit) is passed on to the client
	     window or used to do a window management action
	     associated with the window decorations.  If the
	     resource value is False then the button press will
	     not be used for any operation other than selecting
	     the window to be the keyboard input focus; if the
	     value is True, the button press is passed to the
	     client window or used to do a window management
	     operation, if appropriate.  The keyboard input focus
	     selection is done in either case.	The default value
	     for this resource is True.

     [1mpositionIsFrame ([0mclass [1mPositionIsFrame)
	     [0mThis resource indicates how client window position
	     information (from the WM_NORMAL_HINTS property and
	     from configuration requests) is to be interpreted.
	     If the resource value is True then the information
	     is interpreted as the position of the [1mmwm [0mclient
	     window frame.  If the value is False then it is
	     interpreted as being the position of the client area
	     of the window.  The default value of this resource
	     is True.

     [1mpositionOnScreen ([0mclass [1mPositionOnScreen)
	     [0mThis resource is used to indicate that windows
	     should initially 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
	     then the size of the screen then at least the upper
	     left corner of the window will be on-screen.  If the
	     resource value is False, then windows are placed in
	     the requested position even if totally off-screen.
	     The default value of this resource is True.

     [1mquitTimeout ([0mclass [1mQuitTimeout)
	     [0mThis resource specifies the amount of time (in mil-
	     liseconds) that [1mmwm [0mwill wait for a client to update
	     the WM_COMMAND property after [1mmwm [0mhas sent the
	     WM_SAVE_YOURSELF message.	This protocol will only



Printed 25/11/91					       16






mwm(1X)             UNIX Programmer's Manual		  mwm(1X)



	     be used for those clients that have a
	     WM_SAVE_YOURSELF atom and no WM_DELETE_WINDOW atom
	     in the WM_PROTOCOLS client window property.  The
	     default value of this resource is 1000 (ms). (Refer
	     to the f.kill function for additional information.)

     [1mresizeBorderWidth ([0mclass [1mResizeBorderWidth)
	     [0mThis 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 is 10 (pixels).

     [1mresizeCursors ([0mclass [1mResizeCursors)
	     [0mThis is used to indicate whether the resize cursors
	     are always displayed when the pointer is in the win-
	     dow size border.  If True the cursors are shown,
	     otherwise the window manager cursor is shown.  The
	     default value is True.

     [1mshowFeedback ([0mclass [1mShowFeedback)
	     [0mThis resource controls when feedback information is
	     displayed.  It controls both window position and
	     size feedback during move or resize operations and
	     initial client placement.	It also controls window
	     manager message and dialog boxes.	The value for
	     this resource is a list of names of the feedback
	     options to be enabled; the names must be separated
	     by a space.  The names of the feedback options are
	     shown below:

       [1mName			   Description
     [0mall	 Show all feedback. (Default value.)
     behavior	 Confirm behavior switch.
     move	 Show position during move.
     none	 Show no feedback.
     placement	 Show position and size during initial placement.
     resize	 Show size during resize.
     restart	 Confirm [1mmwm [0mrestart.

     The following command line illustrates the syntax for
     showFeedback:

	  [1mMwm*showFeedback: placement resize behavior restart

     [0mThis resource specification provides feedback for initial
     client placement and resize, and enables the dialog boxes to
     confirm the restart and set behavior functions.  It disables
     feedback for the move function.

     [1mstartupKeyFocus ([0mclass [1mStartupKeyFocus)
	     [0mThis resource is only available when the keyboard
	     input focus policy is explicit.  When given the



Printed 25/11/91					       17






mwm(1X)             UNIX Programmer's Manual		  mwm(1X)



	     default value of True, a window gets the keyboard
	     input focus when the window is mapped (i.e., ini-
	     tially managed by the window manager).

     [1mtransientDecoration ([0mclass [1mTransientDecoration)
	     [0mThis controls the amount of decoration that Mwm puts
	     on transient windows.  The decoration specification
	     is exactly the same as for the [1mclientDecoration
	     [0m(client specific) resource.  Transient windows are
	     identified by the WM_TRANSIENT_FOR property which is
	     added by the client to indicate a relatively tem-
	     porary window.  The default value for this resource
	     is menu title (i.e., transient windows will have
	     resize borders and a titlebar with a window menu
	     button).

     [1mtransientFunctions ([0mclass [1mTransientFunctions)
	     [0mThis resource is used to indicate which window
	     management functions are applicable (or not applica-
	     ble) to transient windows.  The function specifica-
	     tion is exactly the same as for the [1mclientFunctions
	     [0m(client specific) resource.  The default value for
	     this resource is -minimize -maximize.

     [1museIconBox ([0mclass [1mUseIconBox)
	     [0mIf 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).

     [1mwMenuButtonClick ([0mclass [1mWMenuButtonClick)
	     [0mThis resource indicates whether a click of the mouse
	     when the pointer is over the window menu button will
	     post and leave posted the system menu.  If the value
	     given this resource is True, then the menu will
	     remain posted.  True is the default value for this
	     resource.

     [1mwMenuButtonClick2 ([0mclass [1mWMenuButtonClick2)
	     [0mWhen this resource is given the default value of
	     True, a double-click action on the window menu but-
	     ton will do an f.kill function.

[1mClient Specific Resources
     [0mThe syntax for specifying _c_l_i_e_n_t _s_p_e_c_i_f_i_c _r_e_s_o_u_r_c_e_s is

	      [1mMwm*[0m_c_l_i_e_n_t__n_a_m_e__o_r__c_l_a_s_s[1m*[0m_r_e_s_o_u_r_c_e__i_d

     For example, [1mMwm*mterm*windowMenu [0mis used to specify the
     window menu to be used with mterm clients.

     The syntax for specifying _c_l_i_e_n_t _s_p_e_c_i_f_i_c _r_e_s_o_u_r_c_e_s for all



Printed 25/11/91					       18






mwm(1X)             UNIX Programmer's Manual		  mwm(1X)



     classes of clients is

	      [1mMwm*[0m_r_e_s_o_u_r_c_e__i_d

     Specific client specifications take precedence over the
     specifications for all clients.  For example, [1mMwm*windowMenu
     [0mis 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 unknown name and class (i.e. the window does not
     have a WM_CLASS property associated with it) is

	      [1mMwm*defaults*[0m_r_e_s_o_u_r_c_e__i_d

     For example, [1mMwm*defaults*iconImage [0mis used to specify the
     icon image to be used for windows that have an unknown name
     and class.

     The following _c_l_i_e_n_t _s_p_e_c_i_f_i_c _r_e_s_o_u_r_c_e_s can be specified:

				[1mClient Specific Resources
     Name			Class		  Value TypeDefault
     [0mclientDecoration		ClientDecoration  string    all
     clientFunctions		ClientFunctions   string    all
     focusAutoRaise		FocusAutoRaise	  T/F	    T
     iconImage			IconImage	  pathname  (image)
     iconImageBackground	Background	  color     icon background
     iconImageBottomShadowColor Foreground	  color     icon bottom shadow
     iconImageBottomShadowPixmapBottomShadowPixmapcolor     icon bottom shadow pixmap
     iconImageForeground	Foreground	  color     icon foreground
     iconImageTopShadowColor	Background	  color     icon top shadow color
     iconImageTopShadowPixmap	TopShadowPixmap   color     icon top shadow pixmap
     matteBackground		Background	  color     background
     matteBottomShadowColor	Foreground	  color     bottom shadow color
     matteBottomShadowPixmap	BottomShadowPixmapcolor     bottom 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	    fill the screen
     useClientIcon		UseClientIcon	  T/F	    F
     windowMenu                 WindowMenu	  string    string


     [1mclientDecoration ([0mclass [1mClientDecoration)
	     [0mThis 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, then
	     that decoration is excluded from the frame.  The
	     _s_i_g_n of the first item in the list determines the



Printed 25/11/91					       19






mwm(1X)             UNIX Programmer's Manual		  mwm(1X)



	     initial amount of decoration.  If the sign of the
	     first decoration is minus, then [1mmwm [0massumes all
	     decorations are present and starts subtracting from
	     that set.	If the sign of the first decoration is
	     plus (or not specified), then [1mmwm [0mstarts with no
	     decoration and builds up a list from the resource.

	       [1mName		      Description
	     [0mall	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:

		 [1mMwm*XClock.clientDecoration: -resizeh -maximize

	     [0mThis removes the resize handles and maximize button
	     from XClock windows.

		 [1mMwm*XClock.clientDecoration: menu minimize
	     border

	     [0mThis does the same thing as above. Note that either
	     [1mmenu [0mor [1mminimize [0mimplies [1mtitle[0m.

     [1mclientFunctions ([0mclass [1mClientFunctions )
	     [0mThis resource is used to indicate which [1mmwm [0mfunc-
	     tions are applicable (or not applicable) to the
	     client window.  The value for the resource is a list
	     of functions.  If the first function in the list has
	     a minus sign in front of it, then [1mmwm [0mstarts with
	     all functions and subtracts from that set.  If the
	     first function in the list has a plus sign in front
	     of it, then [1mmwm [0mstarts with no functions and builds
	     up a list.  Each function in the list must be pre-
	     ceded by the appropriate plus or minus sign and be
	     separated from the next function by a space.

     The table below lists the functions available for this
     resource:

	     [1mName		   Description
	   [0mall	      Include all functions (default value)
	   none       No functions
	   resize     f.resize
	   move       f.move
	   minimize   f.minimize
	   maximize   f.maximize



Printed 25/11/91					       20






mwm(1X)             UNIX Programmer's Manual		  mwm(1X)



	   close      f.kill

     [1mfocusAutoRaise ([0mclass [1mFocusAutoRaise)
	     [0mWhen the value of this resource is True, clients are
	     made completely unobscured when they get the key-
	     board 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.

     [1miconImage ([0mclass [1mIconImage)
	     [0mThis resource can be used to specify an icon image
	     for a client (e.g., "Mwm*myclock*iconImage").  The
	     resource value is a pathname for a bitmap file.  The
	     value of the (client specific) useClientIcon
	     resource is used to determine whether or not user
	     supplied icon images are used instead of client sup-
	     plied icon images. The default value is to display a
	     built-in window manager icon image.

     [1miconImageBackground ([0mclass [1mBackground)
	     [0mThis resource specifies the background color of the
	     icon image that is displayed in the image part of an
	     icon.  The default value of this resource is the
	     icon background color (i.e., specified by
	     "Mwm*background or Mwm*icon*background).

     [1miconImageBottomShadowColor ([0mclass [1mForeground)
	     [0mThis resource specifies the bottom shadow color of
	     the icon image that is displayed in the image part
	     of an icon.  The default value of this resource is
	     the icon bottom shadow color (i.e., specified by
	     Mwm*icon*bottomShadowColor).

     [1miconImageBottomShadowPixmap ([0mclass [1mBottomShadowPixmap)
	     [0mThis resource specifies the bottom shadow Pixmap of
	     the icon image that is displayed in the image part
	     of an icon.  The default value of this resource is
	     the icon bottom shadow Pixmap (i.e., specified by
	     Mwm*icon*bottomShadowPixmap).

     [1miconImageForeground ([0mclass [1mForeground)
	     [0mThis resource specifies the foreground color of the
	     icon image that is displayed in the image part of an
	     icon.  The default value of this resource is the
	     icon foreground color (i.e., specified by
	     "Mwm*foreground or Mwm*icon*foreground).

     [1miconImageTopShadowColor ([0mclass [1mBackground)
	     [0mThis resource specifies the top shadow color of the
	     icon image that is displayed in the image part of an
	     icon.  The default value of this resource is the



Printed 25/11/91					       21






mwm(1X)             UNIX Programmer's Manual		  mwm(1X)



	     icon top shadow color (i.e., specified by
	     Mwm*icon*topShadowColor).

     [1miconImageTopShadowPixmap ([0mclass [1mTopShadowPixmap)
	     [0mThis resource specifies the top shadow Pixmap of the
	     icon image that is displayed in the image part of an
	     icon.  The default value of this resource is the
	     icon top shadow Pixmap (i.e., specified by
	     Mwm*icon*topShadowPixmap).

     [1mmatteBackground ([0mclass [1mBackground)
	     [0mThis resource specifies the background color of the
	     matte, when [1mmatteWidth [0mis positive.  The default
	     value of this resource is the client background
	     color (i.e., specified by "Mwm*background or
	     Mwm*client*background).

     [1mmatteBottomShadowColor ([0mclass [1mForeground)
	     [0mThis resource specifies the bottom shadow color of
	     the matte, when [1mmatteWidth [0mis positive.  The default
	     value of this resource is the client bottom shadow
	     color (i.e., specified by "Mwm*bottomShadowColor or
	     Mwm*client*bottomShadowColor).

     [1mmatteBottomShadowPixmap ([0mclass [1mBottomShadowPixmap)
	     [0mThis resource specifies the bottom shadow Pixmap of
	     the matte, when [1mmatteWidth [0mis positive.  The default
	     value of this resource is the client bottom shadow
	     Pixmap (i.e., specified by "Mwm*bottomShadowPixmap
	     or Mwm*client*bottomShadowPixmap).

     [1mmatteForeground ([0mclass [1mForeground)
	     [0mThis resource specifies the foreground color of the
	     matte, when [1mmatteWidth [0mis positive.  The default
	     value of this resource is the client foreground
	     color (i.e., specified by "Mwm*foreground or
	     Mwm*client*foreground).

     [1mmatteTopShadowColor ([0mclass [1mBackground)
	     [0mThis resource specifies the top shadow color of the
	     matte, when [1mmatteWidth [0mis positive.  The default
	     value of this resource is the client top shadow
	     color (i.e., specified by "Mwm*topShadowColor or
	     Mwm*client*topShadowColor).

     [1mmatteTopShadowPixmap ([0mclass [1mTopShadowPixmap)
	     [0mThis resource specifies the top shadow Pixmap of the
	     matte, when [1mmatteWidth [0mis positive.  The default
	     value of this resource is the client top shadow Pix-
	     map (i.e., specified by "Mwm*topShadowPixmap or
	     Mwm*client*topShadowPixmap).




Printed 25/11/91					       22






mwm(1X)             UNIX Programmer's Manual		  mwm(1X)



     [1mmatteWidth ([0mclass [1mMatteWidth)
	     [0mThis resource specifies the width of the optional
	     matte. The default value is 0, which effectively
	     disables the matte.

     [1mmaximumClientSize ([0mclass [1mMaximumClientSize)
	     [0mThis is a size specification that indicates the
	     client size to be used when an application is maxim-
	     ized.  The resource value is specified as _w_i_d_t_h[1mx-
	     [0m_h_e_i_g_h_t.  The width and height are interpreted in the
	     units that the client uses (e.g., for terminal emu-
	     lators this is generally characters).  If this
	     resource is not specified then the maximum size from
	     the WM_NORMAL_HINTS property is used if set.  Other-
	     wise the default value is the size where the client
	     window with window management borders fills the
	     screen.  When the maximum client size is not deter-
	     mined by the maximumClientSize resource, the max-
	     imumMaximumSize resource value is used as a con-
	     straint on the maximum size.

     [1museClientIcon ([0mclass [1mUseClientIcon)
	     [0mIf the value given for this resource is True, then a
	     client supplied icon image will take precedence over
	     a user supplied icon image.  The default value is
	     False, making the user supplied icon image have
	     higher precedence than the client supplied icon
	     image.

     [1mwindowMenu ([0mclass [1mWindowMenu)
	     [0mThis 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 [1mmwm resource description file [0mfile.
	     Window menus can be customized on a client class
	     basis by specifying resources of the form
	     [1mMwm*[0m_c_l_i_e_n_t__n_a_m_e__o_r__c_l_a_s_s[1m*windowMenu [0m(See "Mwm
	     Resource Description File Syntax").  The default
	     value of this resource is the name of the built-in
	     window menu specification.

[1mRESOURCE DESCRIPTION FILE
     [0mThe [1mmwm resource description file [0mis a supplementary
     resource file that contains resource descriptions that are
     referred to by entries in the defaults files (.Xdefaults,
     app-defaults/Mwm).  It contains descriptions of resources
     that are to be used by [1mmwm[0m, and that cannot be easily
     encoded in the defaults files (a bitmap file is an analogous
     type of resource description file).  A particular [1mmwm
     resource description file [0mcan be selected using the [1mconfig-
     File [0mresource.



Printed 25/11/91					       23






mwm(1X)             UNIX Programmer's Manual		  mwm(1X)



     The following types of resources can be described in the [1mmwm
     resource description file[0m:


     [1mButtons	    [0mWindow manager functions can be bound (asso-
		    ciated) with button events.

     [1mKeys	    [0mWindow manager functions can be bound (asso-
		    ciated) with key press events.

     [1mMenus	    [0mMenu panes can be used for the window menu
		    and other menus posted with key bindings and
		    button bindings.


[1mmwm Resource Description File Syntax
     [0mThe [1mmwm resource description file [0mis a standard text file
     that contains items of information separated by blanks,
     tabs, and new lines characters.  Blank lines are ignored.
     Items or characters can be quoted to avoid special interpre-
     tation (e.g., the comment character can be quoted to prevent
     it from being interpreted as the comment character).  A
     quoted item can be contained in double quotes ([1m"[0m).  Single
     characters can be quoted by preceding them by the back-slash
     character ([1m\[0m).  All text from an unquoted [1m# [0mto the end of
     the line is regarded as a comment and is not interpreted as
     part of a resource description.  If [1m! [0mis the first character
     in a line, the line is regarded as a comment.  Window
     manager functions can be accessed with button and key bind-
     ings, and with window manager menus.  Functions are indi-
     cated as part of the specifications for button and key bind-
     ing sets, and menu panes.	The function specification has
     the following syntax:

	   _f_u_n_c_t_i_o_n =	     _f_u_n_c_t_i_o_n__n_a_m_e [_f_u_n_c_t_i_o_n__a_r_g_s]
	   _f_u_n_c_t_i_o_n__n_a_m_e =   _w_i_n_d_o_w _m_a_n_a_g_e_r _f_u_n_c_t_i_o_n
	   _f_u_n_c_t_i_o_n__a_r_g_s =   {_q_u_o_t_e_d__i_t_e_m [1m| [0m_u_n_q_u_o_t_e_d__i_t_e_m}

     The following functions are supported.  If a function is
     specified that isn't one of the supported functions then it
     is interpreted by [1mmwm [0mas _f._n_o_p.

     [1mf.beep
	  [0mThis function causes a beep.

     [1mf.circle_down [0m[[1micon | window[0m]
	  This function causes the window or icon that is on the
	  top of the window stack to be put on the bottom of the
	  window stack (so that it is no longer obscuring any
	  other window or icon).  This function affects only
	  those windows and icons that are obscuring other win-
	  dows and icons, or that are obscured by other windows



Printed 25/11/91					       24






mwm(1X)             UNIX Programmer's Manual		  mwm(1X)



	  and icons.  Secondary windows (i.e. transient windows)
	  are restacked with their associated primary window.
	  Secondary windows always stay on top of the associated
	  primary window and there can be no other primary win-
	  dows between the secondary windows and their primary
	  window.  If an [1micon [0mfunction argument is specified,
	  then the function applies only to icons.  If a [1mwindow
	  [0mfunction argument is specified then the function
	  applies only to windows.

     [1mf.circle_up [0m[[1micon | window[0m]
	  This function raises the window or icon on the bottom
	  of the window stack (so that it is not obscured by any
	  other windows).  This function affects only those win-
	  dows and icons that are obscuring other windows and
	  icons, or that are obscured by other windows and icons.
	  Secondary windows (i.e. transient windows) are res-
	  tacked with their associated primary window.	If an
	  _i_c_o_n function argument is specified then the function
	  applies only to icons.  If an _w_i_n_d_o_w function argument
	  is specified then the function applies only to windows.

     [1mf.exec [0mor [1m!
	  [0mThis function causes _c_o_m_m_a_n_d to be executed (using the
	  value of the $_S_H_E_L_L environment variable if it is set,
	  otherwise /_b_i_n/_s_h).  The [1m! [0mnotation can be used in
	  place of the [1mf.exec [0mfunction name.

     [1mf.focus_color
	  [0mThis function sets the colormap focus to a client win-
	  dow.	If this function is done in a root context, then
	  the default colormap (setup by the _X _W_i_n_d_o_w _S_y_s_t_e_m for
	  the screen where [1mmwm [0mis running) is installed and there
	  is no specific client window colormap focus.	This
	  function is treated as _f._n_o_p if _c_o_l_o_r_m_a_p_F_o_c_u_s_P_o_l_i_c_y is
	  not explicit.

     [1mf.focus_key
	  [0mThis function sets the keyboard input focus to a client
	  window or icon.  This function is treated as _f._n_o_p if
	  _k_e_y_b_o_a_r_d_F_o_c_u_s_P_o_l_i_c_y is not explicit or the function is
	  executed in a root context.

     [1mf.kill
	  [0mIf the WM_DELETE_WINDOW protocol is set up, the client
	  is sent a client message event indicating that the
	  client window should be deleted.  If the
	  WM_SAVE_YOURSELF protocol is set up and the
	  WM_DELETE_WINDOW protocol is not set up, the client is
	  sent a client message event indicating that the client
	  needs to prepare to be terminated.  If the client does
	  not have the WM_DELETE_WINDOW or WM_SAVE_YOURSELF



Printed 25/11/91					       25






mwm(1X)             UNIX Programmer's Manual		  mwm(1X)



	  protocol set up, this function causes a client's X con-
	  nection to be terminated (usually resulting in termina-
	  tion of the client).	Refer to the description of the
	  _q_u_i_t_T_i_m_e_o_u_t resource and the _W_M__P_R_O_T_O_C_O_L_S property.

     [1mf.lower [0m[[1m-[0m_c_l_i_e_n_t]
	  This function lowers a client window to the bottom of
	  the window stack (where it obscures no other window).
	  Secondary windows (i.e. transient windows) are res-
	  tacked with their associated primary window.	The
	  _c_l_i_e_n_t argument indicates the name or class of a client
	  to lower.  If the _c_l_i_e_n_t argument is not specified then
	  the context that the function was invoked in indicates
	  the window or icon to lower.

     [1mf.maximize
	  [0mThis function causes a client window to be displayed
	  with its maximum size.

     [1mf.menu
	  [0mThis function associates a cascading (pull-right) menu
	  with a menu pane entry or a menu with a button or key
	  binding.  The _m_e_n_u__n_a_m_e function argument identifies
	  the menu to be used.

     [1mf.minimize
	  [0mThis function causes a client window to be minimized
	  (iconified).	When a window is minimized when no icon
	  box is used, its icon is placed on the bottom of the
	  window stack (such that it obscures no other window).
	  If an icon box is used, then the client's icon changes
	  to its iconified form inside the icon box.  Secondary
	  windows (i.e. transient windows) are minimized with
	  their associated primary window.  There is only one
	  icon for a primary window and all its secondary win-
	  dows.

     [1mf.move
	  [0mThis function allows a client window to be interac-
	  tively moved.

     [1mf.next_cmap
	  [0mThis function installs the next colormap in the list of
	  colormaps for the window with the colormap focus.

     [1mf.next_key [0m[[1micon | window | transient[0m]
	  This function sets the keyboard input focus to the next
	  window/icon in the set of windows/icons managed by the
	  window manager (the ordering of this set is based on
	  the stacking of windows on the screen).  This function
	  is treated as _f._n_o_p if _k_e_y_b_o_a_r_d_F_o_c_u_s_P_o_l_i_c_y is not
	  explicit.  The keyboard input focus is only moved to



Printed 25/11/91					       26






mwm(1X)             UNIX Programmer's Manual		  mwm(1X)



	  windows that do not have an associated secondary window
	  that is application modal.  If the [1mtransient [0margument
	  is specified, then transient (secondary) windows are
	  traversed (otherwise, if only [1mwindow [0mis specified,
	  traversal is done only to the last focused window in a
	  transient group).  If an [1micon [0mfunction argument is
	  specified, then the function applies only to icons.  If
	  a [1mwindow [0mfunction argument is specified, then the func-
	  tion applies only to windows.

     [1mf.nop
	  [0mThis function does nothing.

     [1mf.normalize
	  [0mThis function causes a client window to be displayed
	  with its normal size.  Secondary windows (i.e. tran-
	  sient windows) are placed in their normal state along
	  with their associated primary window.

     [1mf.pack_icons
	  [0mThis function is used to relayout icons (based on the
	  layout policy being used) on the root window or in the
	  icon box.  In general this causes icons to be "packed"
	  into the icon grid.

     [1mf.pass_keys
	  [0mThis function is used to enable/disable (toggle) pro-
	  cessing of key bindings for window manager functions.
	  When it disables key binding processing all keys are
	  passed on to the window with the keyboard input focus
	  and no window manager functions are invoked.	If the
	  _f._p_a_s_s__k_e_y_s function is invoked with a key binding to
	  disable key binding processing the same key binding can
	  be used to enable key binding processing.

     [1mf.post_wmenu
	  [0mThis function is used to post the window menu.  If a
	  key is used to post the window menu and a window menu
	  button is present, the window menu is automatically
	  placed with its top-left corner at the bottom-left
	  corner of the window menu button for the client window.
	  If no window menu button is present,	the window menu
	  is placed at the top-left corner of the client window.

     [1mf.prev_cmap
	  [0mThis function installs the previous colormap in the
	  list of colormaps for the window with the colormap
	  focus.

     [1mf.prev_key [0m[[1micon | window | transient[0m]
	  This function sets the keyboard input focus to the pre-
	  vious window/icon in the set of windows/icons managed



Printed 25/11/91					       27






mwm(1X)             UNIX Programmer's Manual		  mwm(1X)



	  by the window manager (the ordering of this set is
	  based on the stacking of windows on the screen).  This
	  function is treated as _f._n_o_p if _k_e_y_b_o_a_r_d_F_o_c_u_s_P_o_l_i_c_y is
	  not explicit.  The keyboard input focus is only moved
	  to windows that do not have an associated secondary
	  window that is application modal.  If the _t_r_a_n_s_i_e_n_t
	  argument is specified, then transient (secondary) win-
	  dows are traversed (otherwise, if only _w_i_n_d_o_w is speci-
	  fied, traversal is done only to the last focused window
	  in a transient group).  If an _i_c_o_n function argument is
	  specified then the function applies only to icons.  If
	  an _w_i_n_d_o_w function argument is specified then the func-
	  tion applies only to windows.

     [1mf.quit_mwm
	  [0mThis function terminates [1mmwm [0m(but NOT the X window sys-
	  tem).

     [1mf.raise [0m[[1m-[0m_c_l_i_e_n_t]
	  This function raises a client window to the top of the
	  window stack (where it is obscured by no other window).
	  Secondary windows (i.e.  transient windows) are res-
	  tacked with their associated primary window.	The
	  _c_l_i_e_n_t argument indicates the name or class of a client
	  to raise.  If the _c_l_i_e_n_t argument is not specified then
	  the context that the function was invoked in indicates
	  the window or icon to raise.

     [1mf.raise_lower
	  [0mThis function raises a client window to the top of the
	  window stack if it is partially obscured by another
	  window, otherwise it lowers the window to the bottom of
	  the window stack.  Secondary windows (i.e. transient
	  windows) are restacked with their associated primary
	  window.

     [1mf.refresh
	  [0mThis function causes all windows to be redrawn.

     [1mf.refresh_win
	  [0mThis function causes a client window to be redrawn.

     [1mf.resize
	  [0mThis function allows a client window to be interac-
	  tively resized.

     [1mf.restart
	  [0mThis function causes [1mmwm [0mto be restarted (effectively
	  terminated and re-executed).

     [1mf.send_msg [0m_m_e_s_s_a_g_e__n_u_m_b_e_r
	  This function sends a client message of the type



Printed 25/11/91					       28






mwm(1X)             UNIX Programmer's Manual		  mwm(1X)



	  _MOTIF_WM_MESSAGES with the _m_e_s_s_a_g_e__t_y_p_e indicated by
	  the _m_e_s_s_a_g_e__n_u_m_b_e_r function argument.  The client mes-
	  sage will only be sent if _m_e_s_s_a_g_e__n_u_m_b_e_r is included in
	  the client's _MOTIF_WM_MESSAGES property.  A menu item
	  label is grayed out if the menu item is used to do
	  _f._s_e_n_d__m_s_g of a message that is not included in the
	  client's _MOTIF_WM_MESSAGES property.

     [1mf.separator
	  [0mThis function causes a menu separator to be put in the
	  menu pane at the specified location (the label is
	  ignored).

     [1mf.set_behavior
	  [0mThis function causes the window manager to restart with
	  the default OSF behavior (if a custom behavior is con-
	  figured) or a custom behavior (if an OSF default
	  behavior is configured).

     [1mf.title
	  [0mThis function inserts a title in the menu pane at the
	  specified location.

     Each function may be constrained as to which resource types
     can specify the function (e.g., menu pane) and also what
     context the function can be used in (e.g., the function is
     done to the selected client window).  Function contexts are

     [1mroot	    [0mNo client window or icon has been selected as
		    an object for the function.

     [1mwindow	    [0mA client window has been selected as an
		    object for the function.  This includes the
		    window's title bar and frame.  Some functions
		    are applied only when the window is in its
		    normalized state (e.g., f.maximize) or its
		    maximized state (e.g., f.normalize).

     [1micon	    [0mAn icon has been selected as an object for
		    the function.

     If a function is specified in a type of resource where it is
     not supported or is invoked in a context that does not apply
     then the function is treated as _f._n_o_p.  The following table
     indicates the resource types and function contexts in which
     window manager functions apply.

      Function	       Contexts                 Resources

      f.beep	       root,icon,window         button,key,menu
      f.circle_down    root,icon,window         button,key,menu
      f.circle_up      root,icon,window         button,key,menu



Printed 25/11/91					       29






mwm(1X)             UNIX Programmer's Manual		  mwm(1X)



      f.exec	       root,icon,window         button,key,menu
      f.focus_color    root,icon,window         button,key,menu
      f.focus_key      root,icon,window         button,key,menu
      f.kill	       icon,window		button,key,menu
      f.lower	       root,icon,window         button,key,menu
      f.maximize       icon,window(normal)	button,key,menu
      f.menu	       root,icon,window         button,key,menu
      f.minimize       window			button,key,menu
      f.move	       icon,window		button,key,menu
      f.next_cmap      root,icon,window         button,key,menu
      f.next_key       root,icon,window         button,key,menu
      f.nop	       root,icon,window         button,key,menu
      f.normalize      icon,window(maximized)	button,key,menu
      f.pack_icons     root,icon,window         button,key,menu
      f.pass_keys      root,icon,window         button,key,menu
      f.post_wmenu     root,icon,window         button,key
      f.prev_cmap      root,icon,window         button,key,menu
      f.prev_key       root,icon,window         button,key,menu
      f.quit_mwm       root			button,key,menu
      f.raise	       root,icon,window         button,key,menu
      f.raise_lower    icon,window		button,key,menu
      f.refresh        root,icon,window         button,key,menu
      f.refresh_win    window			button,key,menu
      f.resize	       window			button,key,menu
      f.restart        root			button,key,menu
      f.send_msg       icon,window		button,key,menu
      f.separator      root,icon,window         menu
      f.set_behavior   root,icon,window         button,key,menu
      f.title	       root,icon,window         menu


[1mWindow Manager Event Specification
     [0mEvents are indicated as part of the specifications for but-
     ton and key binding sets, and menu panes.

     Button events have the following syntax:

	 _b_u_t_t_o_n =	   [_m_o_d_i_f_i_e_r__l_i_s_t][1m<[0m_b_u_t_t_o_n__e_v_e_n_t__n_a_m_e[1m>
	 [0m_m_o_d_i_f_i_e_r__l_i_s_t =   _m_o_d_i_f_i_e_r__n_a_m_e {_m_o_d_i_f_i_e_r__n_a_m_e}

     All modifiers specified are interpreted as being exclusive
     (this means that only the specified modifiers can be present
     when the button event occurs).  The following table indi-
     cates the values that can be used for _m_o_d_i_f_i_e_r__n_a_m_e.  The
     [Alt] key is frequently labeled [Extend] or [Meta].  Alt and
     Meta can be used interchangeably in event specification.

		       _M_o_d_i_f_i_e_r   _D_e_s_c_r_i_p_t_i_o_n
		       Ctrl	  Control Key
		       Shift	  Shift Key
		       Alt	  Alt/Meta Key
		       Meta	  Meta/Alt Key



Printed 25/11/91					       30






mwm(1X)             UNIX Programmer's Manual		  mwm(1X)



		       Lock	  Lock Key
		       Mod1	  Modifier1
		       Mod2	  Modifier2
		       Mod3	  Modifier3
		       Mod4	  Modifier4
		       Mod5	  Modifier5

     The following table indicates the values that can be used
     for _b_u_t_t_o_n__e_v_e_n_t__n_a_m_e.

	       _B_u_t_t_o_n	    _D_e_s_c_r_i_p_t_i_o_n
	       Btn1Down     Button 1 Press
	       Btn1Up	    Button 1 Release
	       Btn1Click    Button 1 Press and Release
	       Btn1Click2   Button 1 Double Click
	       Btn2Down     Button 2 Press
	       Btn2Up	    Button 2 Release
	       Btn2Click    Button 2 Press and Release
	       Btn2Click2   Button 2 Double Click
	       Btn3Down     Button 3 Press
	       Btn3Up	    Button 3 Release
	       Btn3Click    Button 3 Press and Release
	       Btn3Click2   Button 3 Double Click
	       Btn4Down     Button 4 Press
	       Btn4Up	    Button 4 Release
	       Btn4Click    Button 4 Press and Release
	       Btn4Click2   Button 4 Double Click
	       Btn5Down     Button 5 Press
	       Btn5Up	    Button 5 Release
	       Btn5Click    Button 5 Press and Release
	       Btn5Click2   Button 5 Double Click

     Key events that are used by the window manager for menu
     mnemonics and for binding to window manager functions are
     single key presses; key releases are ignored.  Key events
     have the following syntax:

	 _k_e_y =		   [_m_o_d_i_f_i_e_r__l_i_s_t][1m<Key>[0m_k_e_y__n_a_m_e
	 _m_o_d_i_f_i_e_r__l_i_s_t =   _m_o_d_i_f_i_e_r__n_a_m_e {_m_o_d_i_f_i_e_r__n_a_m_e}

     All modifiers specified are interpreted as being exclusive
     (this means that only the specified modifiers can be present
     when the key event occurs).  Modifiers for keys are the same
     as those that apply to buttons.  The _k_e_y__n_a_m_e is an X11
     keysym name.  Keysym names can be found in the keysymdef.h
     file (remove the _X_K_ prefix).

[1mButton Bindings
     [0mThe [1mbuttonBindings [0mresource value is the name of a set of
     button bindings that are used to configure window manager
     behavior.	A window manager function can be done when a but-
     ton press	occurs with the pointer over a framed client



Printed 25/11/91					       31






mwm(1X)             UNIX Programmer's Manual		  mwm(1X)



     window, an icon or the root window.  The context for indi-
     cating where the button press applies is also the context
     for invoking the window manager function when the button
     press is done (significant for functions that are context
     sensitive).

     The button binding syntax is

	  [1mButtons [0m_b_i_n_d_i_n_g_s__s_e_t__n_a_m_e
	  [1m{
	      [0m_b_u_t_t_o_n	_c_o_n_t_e_x_t    _f_u_n_c_t_i_o_n
	      _b_u_t_t_o_n	_c_o_n_t_e_x_t    _f_u_n_c_t_i_o_n
				   .
				   .
	      _b_u_t_t_o_n	_c_o_n_t_e_x_t    _f_u_n_c_t_i_o_n
	  [1m}

     [0mThe syntax for the _c_o_n_t_e_x_t specification is

   _c_o_n_t_e_x_t =   _o_b_j_e_c_t[[1m|[0m_c_o_n_t_e_x_t]
   _o_b_j_e_c_t =    [1mroot | icon | window | title | frame | border | app

     [0mThe context specification indicates where the pointer must
     be for the button binding to be effective.  For example, a
     context of [1mwindow [0mindicates that the pointer must be over a
     client window or window management frame for the button
     binding to be effective.  The [1mframe [0mcontext is for the win-
     dow management frame around a client window (including the
     border and titlebar), the [1mborder [0mcontext is for the border
     part of the window management frame (not including the
     titlebar), the [1mtitle [0mcontext is for the title area of the
     window management frame, and the [1mapp [0mcontext is for the
     application window (not including the window management
     frame).

     If an _f._n_o_p function is specified for a button binding, the
     button binding will not be done.

[1mKey Bindings
     [0mThe [1mkeyBindings [0mresource value is the name of a set of key
     bindings that are used to configure window manager behavior.
     A window manager function can be done when a particular key
     is pressed. The context in which the key binding applies is
     indicated in the key binding specification.  The valid con-
     texts are the same as those that apply to button bindings.

     The key binding syntax is

	  [1mKeys [0m_b_i_n_d_i_n_g_s__s_e_t__n_a_m_e
	  [1m{
	      [0m_k_e_y    _c_o_n_t_e_x_t	_f_u_n_c_t_i_o_n
	      _k_e_y    _c_o_n_t_e_x_t	_f_u_n_c_t_i_o_n



Printed 25/11/91					       32






mwm(1X)             UNIX Programmer's Manual		  mwm(1X)



			  .
			  .
	      _k_e_y    _c_o_n_t_e_x_t	_f_u_n_c_t_i_o_n
	  [1m}

     [0mIf an _f._n_o_p function is specified for a key binding, the key
     binding will not be done.	If an _f._p_o_s_t__w_m_e_n_u or _f._m_e_n_u
     function is bound to a key, [1mmwm [0mwill automatically use the
     same key for removing the menu from the screen after it has
     been popped up.

     The _c_o_n_t_e_x_t specification syntax is the same as for button
     bindings.	For key bindings, the [1mframe[0m, [1mtitle[0m, [1mborder[0m, and
     [1mapp [0mcontexts are equivalent to the [1mwindow [0mcontext.  The con-
     text for a key event is the window or icon that has the key-
     board input focus ([1mroot [0mif no window or icon has the key-
     board input focus).

[1mMenu Panes
     [0mMenus can be popped up using the _f._p_o_s_t__w_m_e_n_u and _f._m_e_n_u
     window manager functions.	The context for window manager
     functions that are done from a menu is _r_o_o_t, _i_c_o_n or _w_i_n_d_o_w
     depending on how the menu was popped up.  In the case of the
     _w_i_n_d_o_w menu or menus popped up with a key binding, the loca-
     tion of the keyboard input focus indicates the context.  For
     menus popped up using a button binding, the context of the
     button binding is the context of the menu.

     The menu pane specification syntax is

	  [1mMenu [0m_m_e_n_u__n_a_m_e
	  [1m{
	      [0m_l_a_b_e_l  [_m_n_e_m_o_n_i_c]  [_a_c_c_e_l_e_r_a_t_o_r]	 _f_u_n_c_t_i_o_n
	      _l_a_b_e_l  [_m_n_e_m_o_n_i_c]  [_a_c_c_e_l_e_r_a_t_o_r]	 _f_u_n_c_t_i_o_n
			  .
			  .
	      _l_a_b_e_l  [_m_n_e_m_o_n_i_c]  [_a_c_c_e_l_e_r_a_t_o_r]	 _f_u_n_c_t_i_o_n
	  [1m}

     [0mEach line in the _M_e_n_u specification identifies the label for
     a menu item and the function to be done if the menu item is
     selected.	Optionally a menu button mnemonic and a menu but-
     ton keyboard accelerator may be specified.  Mnemonics are
     functional only when the menu is posted and keyboard traver-
     sal applies.

     The _l_a_b_e_l may be a string or a bitmap file.  The label
     specification has the following syntax:

	     _l_a_b_e_l =	     _t_e_x_t [1m| [0m_b_i_t_m_a_p__f_i_l_e
	     _b_i_t_m_a_p__f_i_l_e =   [1m@[0m_f_i_l_e__n_a_m_e
	     _t_e_x_t =	     _q_u_o_t_e_d__i_t_e_m [1m| [0m_u_n_q_u_o_t_e_d__i_t_e_m



Printed 25/11/91					       33






mwm(1X)             UNIX Programmer's Manual		  mwm(1X)



     The string encoding for labels must be compatible with the
     menu font that is used.  Labels are greyed out for menu
     items that do the _f._n_o_p function or an invalid function or a
     function that doesn't apply in the current context.

     A _m_n_e_m_o_n_i_c specification has the following syntax

	 _m_n_e_m_o_n_i_c =   [1m_[0m_c_h_a_r_a_c_t_e_r

     The first matching _c_h_a_r_a_c_t_e_r in the label is underlined.  If
     there is no matching _c_h_a_r_a_c_t_e_r in the label, no mnemonic is
     registered with the window manager for that label.  Although
     the _c_h_a_r_a_c_t_e_r must exactly match a character in the label,
     the mnemonic will not execute if any modifier (such as
     Shift) is pressed with the character key.

     The _a_c_c_e_l_e_r_a_t_o_r specification is a key event specification
     with the same syntax as is used for key bindings to window
     manager functions.

[1mENVIRONMENT
     mwm [0muses the environment variable [1m$HOME [0mspecifying the
     user's home directory.

[1mFILES
      [0m/usr/lib/X11/system.mwmrc
      /usr/lib/X11/app-defaults/Mwm
      $HOME/.Xdefaults
      $HOME/.mwmrc

[1mWARNINGS
     [0mWhen other applications are started from [1mmwm [0musing the
     [1mf.exec [0mfunction these applications belong to the same pro-
     cess group as [1mmwm[0m.  In general killing [1mmwm [0mwill also kill
     the client applications started from it; in particular if
     [1mmwm [0mis started from [1mxsm[0m(1) changing window managers from the
     [1mxsm [0mclient window will cause all the clients started from
     [1mmwm [0mto terminate.

[1mCOPYRIGHT
     [0m(c) Copyright 1989 by Open Software Foundation, Inc.
     (c) Copyright 1987, 1988, 1989 by Hewlett-Packard Company
     All rights reserved.

[1mORIGIN
     [0mHP

[1mRELATED INFORMATION
     [0mX(1)
     VendorShell(3X)
     XmInstallImage(3X)




Printed 25/11/91					       34



[0m