


   mwm(1X)



   NAME
     mmwwmm-The Motif Window Manager

   AES SUPPORT LEVEL
     Full-use

   HISTORY/DIRECTION
     The ff..rreessttoorree function, which restores a window to its previous state,
     has been added (for Trial-use).

   SYNOPSIS
     mmwwmm [ _o_p_t_i_o_n_s ]

   DESCRIPTION
     mmwwmm is an X Window System client that provides window management func-
     tionality and some session management functionality.  It provides func-
     tions that facilitate control (by the user and the programmer) of ele-
     ments of window state such as placement, size, icon/normal display, and
     input-focus ownership.  It also provides session management functions
     such as stopping a client.

     Options


     --ddiissppllaayy _d_i_s_p_l_a_y
             This option specifies the display to use; see _X(_1).

     --xxrrmm _r_e_s_o_u_r_c_e_s_t_r_i_n_g
             This option specifies a resource string to use.

     --mmuullttiissccrreeeenn
             This option causes mmwwmm to manage all screens on the display.
             The default is to manage only a single screen.

     --nnaammee _n_a_m_e
             This option causes mmwwmm to retrieve its resources using the
             specified name, as in _n_a_m_e*_r_e_s_o_u_r_c_e.

     --ssccrreeeennss _n_a_m_e [_n_a_m_e [...]]
             This option specifies the resource names to use for the screens
             managed by mmwwmm.  If mmwwmm is managing a single screen, only the
             first name in the list is used.  If mmwwmm is managing multiple
             screens, the names are assigned to the screens in order, start-
             ing 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 confi-
     guration of specific resources.  Resources are defined under the heading
     "X DEFAULTS."


   2-2






                                                                      mwm(1X)



     Screens

     By default, mmwwmm manages only the single screen specified by the --ddiissppllaayy
     option or the DISPLAY environment variable (by default, screen 0).  If
     the --mmuullttiissccrreeeenn option is specified or if the mmuullttiiSSccrreeeenn resource is
     True, mmwwmm tries to manage all the screens on the display.

     When mmwwmm is managing multiple screens, the --ssccrreeeennss option can be used
     to give each screen a unique resource name.  The names are separated by
     blanks, for example, --ssccrreeeennss mwm0 mwm1.  If there are more screens than
     names, resources for the remaining screens will be retrieved using the
     first name.

     Windows

     Default mmwwmm window frames have distinct components with associated func-
     tions:

     TTiittllee AArreeaa       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.

     TTiittllee BBaarr        The title bar includes the title area, the minimize
                      button, the maximize button, and the window menu but-
                      ton.

     MMiinniimmiizzee BBuuttttoonn  To turn the window into an icon, click button 1 on the
                      minimize button (the frame box with a _s_m_a_l_l square in
                      it).

     MMaaxxiimmiizzee BBuuttttoonn  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
                      _l_a_r_g_e square in it).

     WWiinnddooww MMeennuu BBuuttttoonn
                      The window menu button is the frame box with a horizon-
                      tal 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.  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 <<SShhiifftt>> <<EEsscc>> or <<AAlltt>> <<SSppaaccee>>.
                      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.




   2-3






   mwm(1X)


                               DDeeffaauulltt WWiinnddooww MMeennuu
            SSeelleeccttiioonn   AAcccceelleerraattoorr   DDeessccrriippttiioonn
            __________________________________________________________
                        R e s t o r e           A l t + F 5         Restores the window to its size
                                      before minimizing or maximizing
                        M o v e                 A l t + F 7         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
                        L o w e r               A l t + F 3         Moves window to bottom of window
                                      stack
            Close       Alt+F4        Causes client to terminate

     RReessiizzee BBoorrddeerr HHaannddlleess
                      To change the size of a window, move the pointer over a
                      resize 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 rubber-band outline is displayed to indi-
                      cate the new window size.

     MMaattttee            An optional matte decoration can be added between the
                      client area and the window frame.  A matte is not actu-
                      ally part of the window frame.  There is no functional-
                      ity 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:
                                IIccoonn WWiinnddooww MMeennuu
         SSeelleeccttiioonn   AAcccceelleerraattoorr   DDeessccrriippttiioonn
         _______________________________________________________________
         Restore     Alt+F5        Opens the associated window
         Move        Alt+F7        Allows the icon to be moved with keys
         Size        Alt+F8        Inactive (not an option for icons)
         Minimize    Alt+F9        Inactive (not an option for icons)
                  M a x i m i z e         A l t + F 1 0        Opens the associated window and makes
                                   it fill the screen
         Lower       Alt+F3        Moves icon to bottom of icon stack
         Close       Alt+F4        Removes client from mmwwmm 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.




   2-4






                                                                      mwm(1X)


     Double-clicking button 1 on an icon invokes the ff..rreessttoorree function and
     restores the icon's associated window to its previous state.  Double-
     clicking button 1 on the icon box's icon opens the icon box and allows
     access to the contained icons.

     Icon Box

     When icons begin to clutter the screen, they can be packed into an icon
     box.  (To use an icon box, mmwwmm must be started with the icon box confi-
     guration already set.)  The icon box is a mmwwmm 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 invoking the
     ff..rraaiissee function on an icon in the icon box raises an already open win-
     dow to the top of the stack.
         BBuuttttoonn AAccttiioonn           DDeessccrriippttiioonn
         ______________________________________________________________________________________________________________________________
         Button 1 click          Selects the icon
         _______________________________________________________________
                  B u t t o n   1   d o u b l e - c l i c k    Restores (opens) the associated window
                                 or raises an already open window to the
                                 top of the stack
         _______________________________________________________________
         Button 1 drag           Moves the icon
         _______________________________________________________________
         Button 3 press          Causes the menu for that icon to pop up
         _______________________________________________________________
                  B u t t o n   3   d r a g            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.
                           IIccoonn MMeennuu ffoorr tthhee IIccoonn BBooxx
   SSeelleeccttiioonn   AAcccceelleerraattoorr   DDeessccrriippttiioonn
   ___________________________________________________________________________
   Restore     Alt+F5        Opens the associated window (if not already open)
   Move        Alt+F7        Allows the icon to be moved with keys
   Size        Alt+F8        Inactive
   Minimize    Alt+F9        Inactive
      M a x i m i z e         A l t + F 1 0        Opens the associated window (if not already open)
                             and maximizes its size
   Lower       Alt+F3        Inactive
   Close       Alt+F4        Removes client from mmwwmm 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.



   2-5






   mwm(1X)


     You can also post the window menu by pressing <<SShhiifftt>> <<EEsscc>> or <<AAlltt>>
     <<SSppaaccee>>.  Pressing <<MMeennuu>> (the pop-up menu key) causes the icon window
     menu of the currently selected icon to pop up.

     Input Focus

     mmwwmm 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 selected to get keyboard
     input, or the window is iconified.  Several resources 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
     behavior:
        BBuuttttoonn AAccttiioonn    OObbjjeecctt                  FFuunnccttiioonn DDeessccrriippttiioonn
        _________________________________________________________________
        Button 1 press   Window / window frame   Keyboard focus selection
        Button 1 press   Icon                    Keyboard focus selection
                   KKeeyy AAccttiioonn          FFuunnccttiioonn DDeessccrriippttiioonn
                   ____________________________________________
                                      [ A l t ] [ T a b ]           Move input focus to next
                                       window in window stack
                   ____________________________________________
                                      [ A l t ] [ S h i f t ] [ T a b ]    Move input focus to pre-
                                       vious window in window
                                       stack

     X Defaults

     mmwwmm is configured from its resource database.  This database is built
     from the following sources. They are listed in order of precedence, low
     to high: /usr/lib/X11/app-defaults/Mwm
     $HOME/Mwm
     RESOURCE_MANAGER root window property or $HOME/.Xdefaults
     XENVIRONMENT variable or $HOME/.Xdefaults-_h_o_s_t
     mmwwmm command line options The  file  names  /usr/lib/X11/app-defaults/Mwm
     and $HOME/Mwm represent customary locations for these files.  The actual
     location of the system-wide  class  resource  file  may  depend  on  the
     XFILESEARCHPATH  environment  variable and the current language environ-
     ment.  The actual location of the user-specific class resource file  may
     depend  on the XUSERFILESEARCHPATH 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 mmwwmm specific resources such as menus and behavior  specifica-
     tions (for example, button and key bindings).

     MMwwmm is the resource class name of mmwwmm and mmwwmm is the resource name  used
     by mmwwmm to look up resources.  the --ssccrreeeennss 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


   2-6






                                                                      mwm(1X)


     mmwwmm resource names) can be used interchangeably, but  "mwm"  takes  pre-
     cedence over "Mwm".

     mmwwmm uses 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 (for example, the window reconfiguration
     feedback window), client window frames, and icons.

     _G_e_n_e_r_a_l _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 mmwwmm appearance and behavior (for example, window
     management  policies).   They  are  not set separately for different mmwwmm
     user 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 mmwwmm 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 MMwwmm**_r_e_s_o_u_r_c_e__i_d
     For example, MMwwmm**ffoorreeggrroouunndd is used to specify the foreground color  for
     mmwwmm menus, icons, client window frames, and feedback dialogs.

     The syntax for specifying component appearance resources that apply to a
     particular mmwwmm component is MMwwmm**[mmeennuu|iiccoonn|cclliieenntt|ffeeeeddbbaacckk]**_r_e_s_o_u_r_c_e__i_d

     If _m_e_n_u is specified, the resource is applied only to mmwwmm menus; if _i_c_o_n
     is  specified, the resource is applied to icons; and if _c_l_i_e_n_t is speci-
     fied, the resource is applied to client  window  frames.   For  example,
     MMwwmm**iiccoonn**ffoorreeggrroouunndd  is  used  to  specify  the foreground color for mmwwmm
     icons, MMwwmm**mmeennuu**ffoorreeggrroouunndd specifies the foreground color for mmwwmm menus,
     and  MMwwmm**cclliieenntt**ffoorreeggrroouunndd  is  used to specify the foreground color for
     mmwwmm 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

     MMwwmm**cclliieenntt**ttiittllee**_r_e_s_o_u_r_c_e__i_d



   2-7






   mwm(1X)


     For example, MMwwmm**cclliieenntt**ttiittllee**ffoorreeggrroouunndd 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

     MMwwmm**mmeennuu**_m_e_n_u__n_a_m_e**_r_e_s_o_u_r_c_e__i_d

     For example, MMwwmm**mmeennuu**mmyy__mmeennuu**ffoorreeggrroouunndd specifies the foreground  color
     for the menu named mmyy__mmeennuu.

     The following component appearance resources that apply  to  all  window
     manager parts can be specified:
             CCoommppoonneenntt AAppppeeaarraannccee RReessoouurrcceess--AAllll WWiinnddooww MMaannaaggeerr PPaarrttss
          NNaammee                 CCllaassss                VVaalluuee TTyyppee   DDeeffaauulltt
          ______________________________________________________________
          background           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.
     |-|-Image name.  See XXmmIInnssttaallllIImmaaggee((33XX)).
     |-|-|-X11 R4 Font description.

     bbaacckkggrroouunndd (class BBaacckkggrroouunndd)
             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.

     bbaacckkggrroouunnddPPiixxmmaapp (class BBaacckkggrroouunnddPPiixxmmaapp)
             This resource specifies the background Pixmap of the mmwwmm decora-
             tion  when  the  window  is inactive (does not have the keyboard
             focus).  The default value is chosen based on the visual type of
             the screen.

     bboottttoommSShhaaddoowwCCoolloorr (class FFoorreeggrroouunndd)
             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.

     bboottttoommSShhaaddoowwPPiixxmmaapp (class BBoottttoommSShhaaddoowwPPiixxmmaapp)
             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.

     ffoonnttLLiisstt (class FFoonnttLLiisstt)


   2-8






                                                                      mwm(1X)


             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 default is
             "fixed."

     ffoorreeggrroouunndd (class FFoorreeggrroouunndd)
             This resource specifies the foreground color.   The  default  is
             chosen based on the visual type of the screen.

     ssaavveeUUnnddeerr (class SSaavveeUUnnddeerr)
             This is used to indicate whether "save unders" are used for  mmwwmm
             components.   For  this  to have any effect, save unders must be
             implemented by the X server.  If save  unders  are  implemented,
             the  X  server saves the contents of windows obscured by windows
             that have the  save  under  attribute  set.   If  the  saveUnder
             resource  is  True, mmwwmm will 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.

     ttooppSShhaaddoowwCCoolloorr (class BBaacckkggrroouunndd)
             This resource specifies the top shadow  color.   This  color  is
             used for the upper and left bevels of the window manager decora-
             tion.  The default is chosen based on the  visual  type  of  the
             screen.

     ttooppSShhaaddoowwPPiixxmmaapp (( class TTooppSShhaaddoowwPPiixxmmaapp))
             This resource specifies the top shadow Pixmap.  This  Pixmap  is
             used for the upper and left bevels of the window manager decora-
             tion.  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:
                            FFrraammee aanndd IIccoonn CCoommppoonneennttss
       NNaammee                       CCllaassss                VVaalluuee TTyyppee   DDeeffaauulltt
       ____________________________________________________________________
       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 XXmmIInnssttaallllIImmaaggee((33XX)).

     aaccttiivveeBBaacckkggrroouunndd (class BBaacckkggrroouunndd)
             This resource specifies the background color of the mmwwmm  decora-
             tion  when  the  window is active (has the keyboard focus).  The
             default is chosen based on the visual type of the screen.

     aaccttiivveeBBaacckkggrroouunnddPPiixxmmaapp (class AAccttiivveeBBaacckkggrroouunnddPPiixxmmaapp)
             This  resource  specifies  the  background  Pixmap  of  the  mmwwmm


   2-9






   mwm(1X)


             decoration  when  the window is active (has the keyboard focus).
             The default is chosen based on the visual type of the screen.

     aaccttiivveeBBoottttoommSShhaaddoowwCCoolloorr (class FFoorreeggrroouunndd)
             This resource specifies the  bottom  shadow  color  of  the  mmwwmm
             decoration  when  the window is active (has the keyboard focus).
             The default is chosen based on the visual type of the screen.

     aaccttiivveeBBoottttoommSShhaaddoowwPPiixxmmaapp (class BBoottttoommSShhaaddoowwPPiixxmmaapp)
             This resource specifies the bottom  shadow  Pixmap  of  the  mmwwmm
             decoration  when  the window is active (has the keyboard focus).
             The default is chosen based on the visual type of the screen.

     aaccttiivveeFFoorreeggrroouunndd (class FFoorreeggrroouunndd)
             This resource specifies the foreground color of the mmwwmm  decora-
             tion  when  the  window is active (has the keyboard focus).  The
             default is chosen based on the visual type of the screen.

     aaccttiivveeTTooppSShhaaddoowwCCoolloorr (class BBaacckkggrroouunndd)
             This resource specifies the top shadow color of the mmwwmm  decora-
             tion  when  the  window is active (has the keyboard focus).  The
             default is chosen based on the visual type of the screen.

     aaccttiivveeTTooppSShhaaddoowwPPiixxmmaapp (class TTooppSShhaaddoowwPPiixxmmaapp)
             This resource specifies the top shadow Pixmap of the mmwwmm decora-
             tion  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
     MMwwmm**_r_e_s_o_u_r_c_e__i_d

     For example, MMwwmm**kkeeyybbooaarrddFFooccuussPPoolliiccyy specifies the window manager policy
     for setting the keyboard focus to a particular client window.

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

                      GGeenneerraall AAppppeeaarraannccee aanndd BBeehhaavviioorr RReessoouurrcceess
   NNaammee                     CCllaassss                    VVaalluuee TTyyppee     DDeeffaauulltt
   _______________________________________________________________________________
   autoKeyFocus             AutoKeyFocus             T/F            T
   autoRaiseDelay           AutoRaiseDelay           millisec       500
      b i t m a p D i r e c t o r y                     B i t m a p D i r e c t o r y                     d i r e c t o r y       /usr/include/\
                                                                    X11/bitmaps
      b u t t o n B i n d i n g s                       B u t t o n B i n d i n g s                       s t r i n g          "DefaultBut\
                                                                    tonBindings"
   cleanText                CleanText                T/F            T
   clientAutoPlace          ClientAutoPlace          T/F            T
   colormapFocusPolicy      ColormapFocusPolicy      string         keyboard
   configFile               ConfigFile               file           .mwmrc
   deiconifyKeyFocus        DeiconifyKeyFocus        T/F            T



   2-10






                                                                      mwm(1X)


      d o u b l e C l i c k T i m e                     D o u b l e C l i c k T i m e                     m i l l i s e c .       multi-click
                                                                    time
   enableWarp               enableWarp               T/F            T
   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
   iconBoxSBDisplayPolicy   IconBoxSBDisplayPolicy   string         all
   iconBoxTitle             IconBoxTitle             XmString       Icons
   iconClick                IconClick                T/F            T
   iconDecoration           IconDecoration           string         varies
   iconImageMaximum         IconImageMaximum         wxh            50x50
   iconImageMinimum         IconImageMinimum         wxh            16x16
   iconPlacement            IconPlacement            string         left bottom
   iconPlacementMargin      IconPlacementMargin      pixels         varies
   interactivePlacement     InteractivePlacement     T/F            F
      k e y B i n d i n g s                             K e y B i n d i n g s                             s t r i n g          "DefaultKey\
                                                                    Bindings"
   keyboardFocusPolicy      KeyboardFocusPolicy      string         explicit
   limitResize              LimitResize              T/F            T
   lowerOnIconify           LowerOnIconify           T/F            T
      m a x i m u m M a x i m u m S i z e               M a x i m u m M a x i m u m S i z e               w x h   ( p i x e l s )    2X screen
                                                                    w&h
   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
   resizeBorderWidth        ResizeBorderWidth        pixels         10
   resizeCursors            ResizeCursors            T/F            T
   screens                  Screens                  string         varies
   showFeedback             ShowFeedback             string         all
   startupKeyFocus          StartupKeyFocus          T/F            T
      t r a n s i e n t D e c o r a t i o n             T r a n s i e n t D e c o r a t i o n             s t r i n g          menu
                                                                    title
      t r a n s i e n t F u n c t i o n s               T r a n s i e n t F u n c t i o n s               s t r i n g          -minimize
                                                                    -maximize
   useIconBox               UseIconBox               T/F            F
   wMenuButtonClick         WMenuButtonClick         T/F            T
   wMenuButtonClick2        WMenuButtonClick2        T/F            T

     aauuttooKKeeyyFFooccuuss (class AAuuttooKKeeyyFFooccuuss)
             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.  The default value is True.


   2-11






   mwm(1X)



     aauuttooRRaaiisseeDDeellaayy (class AAuuttooRRaaiisseeDDeellaayy)
             This resource is available only when the focusAutoRaise resource
             is   True  and  the  keyboard  focus  policy  is  pointer.   The
             autoRaiseDelay resource specifies the amount of  time  (in  mil-
             liseconds)  that  mmwwmm will wait before raising a window after it
             gets the keyboard focus.  The default value of this resource  is
             500 (ms).

     bbiittmmaappDDiirreeccttoorryy (class BBiittmmaappDDiirreeccttoorryy)
             This resource identifies a directory to be searched for  bitmaps
             referenced  by  mmwwmm  resources.  This directory is searched if a
             bitmap is specified without an absolute pathname.   The  default
             value for this resource is /usr/include/X11/bitmaps.  The direc-
             tory /usr/include/X11/bitmaps represents the customary locations
             for  this  directory.  The actual location of this directory may
             vary on some systems.

     bbuuttttoonnBBiinnddiinnggss (class BBuuttttoonnBBiinnddiinnggss)
             This resource identifies the set of button bindings  for  window
             management  functions.   The  named  set  of  button bindings is
             specified in the mmwwmm resource description  file.   These  button
             bindings  are  _m_e_r_g_e_d  with  the built-in default bindings.  The
             default value for this resource is "DefaultButtonBindings".

     cclleeaannTTeexxtt (class CClleeaannTTeexxtt)
             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 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.

     cclliieennttAAuuttooPPllaaccee (class CClliieennttAAuuttooPPllaaccee)
             This resource determines the position of a window when the  win-
             dow  has not been given a user-specified position.  With a value
             of True, windows are positioned 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,  mmwwmm will attempt to place the windows
             totally on-screen.  The default value is True.

     ccoolloorrmmaappFFooccuussPPoolliiccyy (class CCoolloorrmmaappFFooccuussPPoolliiccyy)
             This resource indicates the colormap focus policy that is to  be
             used.   If  the resource value is explicit, a colormap selection
             action is done on a client window to set the colormap  focus  to
             that  window.   If  the value is pointer, the client window con-
             taining 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.

     ccoonnffiiggFFiillee (class CCoonnffiiggFFiillee)


   2-12






                                                                      mwm(1X)


             The resource value is the pathname for an mmwwmm resource  descrip-
             tion file.
             If the pathname begins with "~/", mmwwmm considers it to  be  rela-
             tive  to  the  user's  home  directory (as specified by the HOME
             environment variable).  If the LANG environment variable is set,
             mmwwmm  looks  for  $HOME/$LANG/_c_o_n_f_i_g_F_i_l_e.   If that file does not
             exist or if LANG is not set, mmwwmm looks for $HOME/_c_o_n_f_i_g_F_i_l_e.
             If the ccoonnffiiggFFiillee pathname does not begin with ~/, mmwwmm considers
             it to be relative to the current working directory.
             If the ccoonnffiiggFFiillee resource is not specified or if that file does
             not  exist,  mmwwmm uses several default paths to find a configura-
             tion file.  If the LANG environment variable is set,  mmwwmm  looks
             for the configuration file first in $HOME/$LANG/.mwmrc.  If that
             file does not exist or  if  LANG  is  not  set,  mmwwmm  looks  for
             $HOME/.mwmrc.   If  that file does not exist and if LANG is set,
             mmwwmm next looks for the file system.mwmrc in the $LANG  subdirec-
             tory  of  an  implementation-dependent  directory.  If that file
             does not exist or if LANG is not set, mmwwmm  looks  for  the  file
             system.mwmrc in the same implementation-dependent directory.

     ddeeiiccoonniiffyyKKeeyyFFooccuuss (class DDeeiiccoonniiffyyKKeeyyFFooccuuss)
             This resource applies only when the keyboard input focus  policy
             is  explicit.  If a value of True is used, a window receives the
             keyboard input focus when it is normalized (deiconified).   True
             is the default value.

     ddoouubblleeCClliicckkTTiimmee (class DDoouubblleeCClliicckkTTiimmee)
             This 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  the  display's  multi-click
             time.

     eennaabblleeWWaarrpp (class EEnnaabblleeWWaarrpp)
             The default value of this resource, True, causes mmwwmm to warp the
             pointer  to  the  center of the selected window during keyboard-
             controlled resize and move operations.   Setting  the  value  to
             False  causes  mmwwmm to leave the pointer at its original place on
             the screen, unless the user explicitly moves it with the  cursor
             keys or pointing device.

     eennffoorrcceeKKeeyyFFooccuuss (class EEnnffoorrcceeKKeeyyFFooccuuss)
             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.

     ffaaddeeNNoorrmmaallIIccoonn (class FFaaddeeNNoorrmmaallIIccoonn)
             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.



   2-13






   mwm(1X)


     ffrraammeeBBoorrddeerrWWiiddtthh (class FFrraammeeBBoorrddeerrWWiiddtthh)
             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 5 pixels.

     iiccoonnAAuuttooPPllaaccee (class IIccoonnAAuuttooPPllaaccee)
             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.

     iiccoonnBBooxxGGeeoommeettrryy (class IIccoonnBBooxxGGeeoommeettrryy)
             This 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:
                [==][_w_i_d_t_hxx_h_e_i_g_h_t][{++--}_x_o_f_f_s_e_t{++--}_y_o_f_f_s_e_t]
             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 depends on the iconImageMaximum (size) and icon-
             Decoration 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.

     iiccoonnBBooxxNNaammee (class IIccoonnBBooxxNNaammee)
             This resource specifies the name that is used to  look  up  icon
             box resources.  The default name is "iconbox".

     iiccoonnBBooxxSSBBDDiissppllaayyPPoolliiccyy (class IIccoonnBBooxxSSBBDDiissppllaayyPPoolliiccyy)
             This resource specifies the scroll bar  display  policy  of  the
             window manager in the icon box.  The resource has three possible
             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  iconBoxGeometry
             specification).  The value "horizontal" causes a single horizon-
             tal scroll bar to appear in the icon box and sets  the  orienta-
             tion  of  the  icon  box to vertical (regardless of the iconBox-
             Geometry specification).

     iiccoonnBBooxxTTiittllee (class IIccoonnBBooxxTTiittllee)
             This resource specifies the name that is used in the title  area
             of the icon box frame.  The default value is "Icons".

     iiccoonnCClliicckk (class IIccoonnCClliicckk)
             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.

     iiccoonnDDeeccoorraattiioonn (class IIccoonnDDeeccoorraattiioonn)


   2-14






                                                                      mwm(1X)


             This  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 activela-
             bel 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).

     iiccoonnIImmaaggeeMMaaxxiimmuumm (class IIccoonnIImmaaggeeMMaaxxiimmuumm)
             This resource specifies the maximum size of the icon _i_m_a_g_e.  The
             resource  value  is _w_i_d_t_hxx_h_e_i_g_h_t (for example, 64x64).  The max-
             imum supported size is  128x128.   The  default  value  of  this
             resource is 50x50.

     iiccoonnIImmaaggeeMMiinniimmuumm (class IIccoonnIImmaaggeeMMiinniimmuumm)
             This resource specifies the minimum size of the icon _i_m_a_g_e.  The
             resource  value  is  _w_i_d_t_hxx_h_e_i_g_h_t  (for  example,  32x50).   The
             minimum supported size is 16x16.   The  default  value  of  this
             resource is 16x16.

     iiccoonnPPllaacceemmeenntt (class IIccoonnPPllaacceemmeenntt)
             This resource specifies the icon placement scheme  to  be  used.
             The resource value has the following syntax: _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:
                        VVaalluuee    DDeessccrriippttiioonn
                        _________________________________________
                        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  _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 (for example, 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 indicates 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).

     iiccoonnPPllaacceemmeennttMMaarrggiinn (class IIccoonnPPllaacceemmeennttMMaarrggiinn)
             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  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


   2-15






   mwm(1X)


             maximizing the number of icons in each row and column).

     iinntteerraaccttiivveePPllaacceemmeenntt (class IInntteerraaccttiivveePPllaacceemmeenntt)
             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 indicate  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 configuration attributes.  The
             default value of this resource is False.

     kkeeyyBBiinnddiinnggss (class KKeeyyBBiinnddiinnggss)
             This 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  mmwwmm resource description file.  The default value
             for this resource is "DefaultKeyBindings".

     kkeeyybbooaarrddFFooccuussPPoolliiccyy (class KKeeyybbooaarrddFFooccuussPPoolliiccyy)
             If set to pointer, the keyboard focus policy is to have the key-
             board  focus  set to the client window that contains the pointer
             (the pointer could also be in the client window decoration  that
             mmwwmm  adds).   If set to explicit, the policy is to have the key-
             board focus set to a client window when the user presses  button
             1 with the pointer on the client window or any part of the asso-
             ciated mmwwmm decoration.  The default value for this  resource  is
             explicit.

     lliimmiittRReessiizzee (class LLiimmiittRReessiizzee)
             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.

     lloowweerrOOnnIIccoonniiffyy (class LLoowweerrOOnnIIccoonniiffyy)
             If 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.
             The default value of this resource is True.

     mmaaxxiimmuummMMaaxxiimmuummSSiizzee (class MMaaxxiimmuummMMaaxxiimmuummSSiizzee)
             This resource is used to limit the maximum size of a client win-
             dow  as  set  by  the  user  or  client.   The resource value is
             _w_i_d_t_hxx_h_e_i_g_h_t (for example, 1024x1024) where the width and height
             are  in pixels.  The default value of this resource is twice the
             screen width and height.

     mmoovveeTThhrreesshhoolldd (class MMoovveeTThhrreesshhoolldd)
             This 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 is moved  with
             a  button  down before the move operation is initiated.  This is




   2-16






                                                                      mwm(1X)


             used to prevent window/icon movement when you click  or  double-
             click  and there is unintentional pointer movement with the but-
             ton down.  The default value of this resource is 4 (pixels).

     mmuullttiiSSccrreeeenn (class MMuullttiiSSccrreeeenn)
             This resource, if True, causes mmwwmm to manage all the screens  on
             the  display.   If False, mmwwmm manages only a single screen.  The
             default value is False.

     ppaassssBBuuttttoonnss (class PPaassssBBuuttttoonnss)
             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,
             the  button  press is not passed to the client.  If the value is
             True, the button press is passed to the client window.  The win-
             dow  manager function is done in either case.  The default value
             for this resource is False.

     ppaassssSSeelleeccttBBuuttttoonn (class PPaassssSSeelleeccttBBuuttttoonn)
             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  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 True.

     ppoossiittiioonnIIssFFrraammee (class PPoossiittiioonnIIssFFrraammee)
             This 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,
             the information is interpreted as the position of the MWM client
             window frame.  If the value is False, it is interpreted as being
             the  position  of  the  client  area of the window.  The default
             value of this resource is True.

     ppoossiittiioonnOOnnSSccrreeeenn (class PPoossiittiioonnOOnnSSccrreeeenn)
             This 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  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 resource is True.

     qquuiittTTiimmeeoouutt (class QQuuiittTTiimmeeoouutt)
             This resource specifies the amount  of  time  (in  milliseconds)
             that  mmwwmm  will  wait for a client to update the WM_COMMAND pro-
             perty after mmwwmm 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.)

     rraaiisseeKKeeyyFFooccuuss (class RRaaiisseeKKeeyyFFooccuuss)
             This resource is available only when the  keyboard  input  focus


   2-17






   mwm(1X)


             policy  is  explicit.  When set to True, this resource specifies
             that a window raised by means of the f.normalize_and_raise func-
             tion  also  receives the input focus.  The default value of this
             resource is False.

     rreessiizzeeBBoorrddeerrWWiiddtthh (class RReessiizzeeBBoorrddeerrWWiiddtthh)
             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 is 10 (pixels).

     rreessiizzeeCCuurrssoorrss (class RReessiizzeeCCuurrssoorrss)
             This is used to indicate whether the resize cursors  are  always
             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.

     ssccrreeeennss (class SSccrreeeennss)
             This resource specifies  the  resource  names  to  use  for  the
             screens  managed  by  mmwwmm.   If mmwwmm is managing a single screen,
             only the first name in the list is used.   If  mmwwmm  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.

     sshhoowwFFeeeeddbbaacckk (class SShhoowwFFeeeeddbbaacckk)
             This 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  con-
             trols window manager message and dialog boxes.
             The value for this resource is a list of names of  the  feedback
             options  to  be enabled or disabled; the names must be separated
             by a space.  If an option is preceded  by  a  minus  sign,  that
             option is excluded from the list.  The _s_i_g_n of the first item in
             the list determines the initial set of options.  If the sign  of
             the  first  option is minus, mmwwmm assumes all options are present
             and starts subtracting from that set.  If the sign of the  first
             decoration  is  plus  (or  not  specified),  mmwwmm  starts with no
             options and builds up a list from the resource.
             The names of the feedback options are shown below:
               NNaammee        DDeessccrriippttiioonn
               ___________________________________________________________
               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 placement
               quit        Confirm quitting mmwwmm
               resize      Show size during resize
               restart     Confirm mmwwmm restart
             The following command line illustrates the syntax for  showFeed-
             back:
                MMwwmm**sshhoowwFFeeeeddbbaacckk:: ppllaacceemmeenntt rreessiizzee bbeehhaavviioorr rreessttaarrtt


   2-18






                                                                      mwm(1X)


             This 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.  The default value for this resource is
             all.

     ssttaarrttuuppKKeeyyFFooccuuss (class SSttaarrttuuppKKeeyyFFooccuuss)
             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).

     ttrraannssiieennttDDeeccoorraattiioonn (class TTrraannssiieennttDDeeccoorraattiioonn)
             This controls the amount of decoration that mmwwmm  puts  on  tran-
             sient windows.  The decoration specification is exactly the same
             as for the cclliieennttDDeeccoorraattiioonn (client specific)  resource.   Tran-
             sient  windows  are identified by the WM_TRANSIENT_FOR property,
             which is added by the client to indicate a relatively  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  mmwwmm  should
             apply  to  its  windows.   If it does so, mmwwmm applies only those
             decorations indicated by both  the  application  and  the  ttrraann--
             ssiieennttDDeeccoorraattiioonn  resource.   Otherwise,  mmwwmm applies the decora-
             tions indicated by the ttrraannssiieennttDDeeccoorraattiioonn resource.   For  more
             information  see  the  description  of  XXmmNNmmwwmmDDeeccoorraattiioonnss on the
             VVeennddoorrSShheellll((33XX)) reference page.

     ttrraannssiieennttFFuunnccttiioonnss (class TTrraannssiieennttFFuunnccttiioonnss)
             This resource is used to indicate which window management  func-
             tions  are  applicable (or not applicable) to transient windows.
             The function specification  is  exactly  the  same  as  for  the
             cclliieennttFFuunnccttiioonnss  (client  specific) resource.  The default value
             for this resource is -minimize -maximize.
             An application can also specify which functions mmwwmm should apply
             to its windows.  If it does so, mmwwmm applies only those functions
             indicated by both the  application  and  the  ttrraannssiieennttFFuunnccttiioonnss
             resource.  Otherwise, mmwwmm applies the functions indicated by the
             ttrraannssiieennttFFuunnccttiioonnss  resource.   For  more  information  see  the
             description  of XXmmNNmmwwmmFFuunnccttiioonnss on the VVeennddoorrSShheellll((33XX)) reference
             page.

     uusseeIIccoonnBBooxx (class UUsseeIIccoonnBBooxx)
             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).

     wwMMeennuuBBuuttttoonnCClliicckk (class WWMMeennuuBBuuttttoonnCClliicckk)
             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.


   2-19






   mwm(1X)



     wwMMeennuuBBuuttttoonnCClliicckk22 (class WWMMeennuuBBuuttttoonnCClliicckk22)
             When this resource  is  given  the  default  value  of  True,  a
             double-click  action  on  the  window menu button does an f.kill
             function.

     Client Specific Resources

     The syntax for specifying client specific resources is
     MMwwmm**_c_l_i_e_n_t__n_a_m_e__o_r__c_l_a_s_s**_r_e_s_o_u_r_c_e__i_d  For  example, MMwwmm**mmtteerrmm**wwiinnddoowwMMeennuu
     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 MMwwmm**_r_e_s_o_u_r_c_e__i_d  Specific  client  specifications  take  pre-
     cedence   over   the  specifications  for  all  clients.   For  example,
     MMwwmm**wwiinnddoowwMMeennuu 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 unknown name and
     class  (that is, windows that do not have a WM_CLASS property associated
     with them) is MMwwmm**ddeeffaauullttss**_r_e_s_o_u_r_c_e__i_d

     For example, MMwwmm**ddeeffaauullttss**iiccoonnIImmaaggee 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:

                            CClliieenntt SSppeecciiffiicc RReessoouurrcceess
    NNaammee                          CCllaassss               VVaalluuee TTyyppee   DDeeffaauulltt
    __________________________________________________________________________
    clientDecoration              ClientDecoration    string       all
    clientFunctions               ClientFunctions     string       all
    focusAutoRaise                FocusAutoRaise      T/F          varies
    iconImage                     IconImage           pathname     (image)
        i c o n I m a g e B a c k g r o u n d                       B a c k g r o u n d                     c o l o r         icon
                                                                   background
        i c o n I m a g e B o t t o m S h a d o w C o l o r         F o r e g r o u n d                     c o l o r         icon bottom
                                                                   shadow
            i  c  o  n  I  m  a  g  e  B  o  t  t  o  m  S  h  a  d  o  w  P  i  x  m  a  p            B  o  t  t  o  m  S  h  a  d  o  w  -               c o l o r         icon bottom
                                                                    P i x m a p                            shadow
                                                                   pixmap
    iconImageForeground           Foreground          color        varies
        i c o n I m a g e T o p S h a d o w C o l o r               B a c k g r o u n d                     c o l o r         icon top
                                                                   shadow
                                                                   color
            i  c  o  n  I  m  a  g  e  T  o  p  S  h  a  d  o  w  P  i  x  m  a  p                     T  o  p  S  h  a  d  o  w  -                     c o l o r         icon top
                                                                    P i x m a p                            shadow
                                                                   pixmap
    matteBackground               Background          color        background
        m a t t e B o t t o m S h a d o w C o l o r                 F o r e g r o u n d                     c o l o r         bottom
                                                                   shadow
                                                                   color
            m  a  t  t  e  B  o  t  t  o  m  S  h  a  d  o  w  P  i  x  m  a  p                        B  o  t  t  o  m  S  h  a  d  o  w  -               c o l o r         bottom
                                                                    P i x m a p                            shadow
                                                                   pixmap
    matteForeground               Foreground          color        foreground


   2-20






                                                                      mwm(1X)


        m a t t e T o p S h a d o w C o l o r                       B a c k g r o u n d                     c o l o r         top shadow
                                                                   color
            m  a  t  t  e  T  o  p  S  h  a  d  o  w  P  i  x  m  a  p                                 T  o  p  S  h  a  d  o  w  -                     c o l o r         top shadow
                                                                    P i x m a p                            pixmap
    matteWidth                    MatteWidth          pixels       0
            m  a  x  i  m  u  m  C  l  i  e  n  t  S  i  z  e                                         M  a  x  i  m  u  m  C  l  i  e  n  t  S  i  z  e        w x h           fill the
                                                                   screen
    useClientIcon                 UseClientIcon       T/F          F
        w i n d o w M e n u                                         W i n d o w M e n u                     s t r i n g        "Default-
                                                                   Window-
                                                                   Menu"

     cclliieennttDDeeccoorraattiioonn (class CClliieennttDDeeccoorraattiioonn)
             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
             _s_i_g_n of the first item in the list determines the initial amount
             of  decoration.   If  the sign of the first decoration is minus,
             mmwwmm assumes all decorations are present and  starts  subtracting
             from  that set.  If the sign of the first decoration is plus (or
             not specified), then mmwwmm starts with no decoration and builds up
             a list from the resource.
             An application can also specify  which  decorations  mmwwmm  should
             apply  to  its  windows.   If it does so, mmwwmm applies only those
             decorations  indicated  by  both   the   application   and   the
             cclliieennttDDeeccoorraattiioonn  resource.   Otherwise, mmwwmm applies the decora-
             tions indicated by  the  cclliieennttDDeeccoorraattiioonn  resource.   For  more
             information  see  the  description  of  XXmmNNmmwwmmDDeeccoorraattiioonnss on the
             VVeennddoorrSShheellll((33XX)) reference page.


























   2-21






   mwm(1X)


                    NNaammee       DDeessccrriippttiioonn
                    __________________________________________________
                    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)

     cclliieennttFFuunnccttiioonnss (class CClliieennttFFuunnccttiioonnss)
             This resource is used to indicate which mmwwmm functions are appli-
             cable  (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 mmwwmm starts with
             all functions and subtracts from that set.  If the  first  func-
             tion in the list has a plus sign in front of it, then mmwwmm 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 mmwwmm should apply
             to its windows.  If it does so, mmwwmm applies only those functions
             indicated  by  both  the  application  and  the  cclliieennttFFuunnccttiioonnss
             resource.  Otherwise, mmwwmm applies the functions indicated by the
             cclliieennttFFuunnccttiioonnss resource.  For more information see the descrip-
             tion of XXmmNNmmwwmmFFuunnccttiioonnss on the VVeennddoorrSShheellll((33XX)) reference page.

     The table below lists the functions available for this resource:
                 NNaammee       DDeessccrriippttiioonn
                 ________________________________________________
                 all        Include all functions (default value)
                 none       No functions
                 resize     f.resize
                 move       f.move
                 minimize   f.minimize
                 maximize   f.maximize
                 close      f.kill


















   2-22






                                                                      mwm(1X)



     ffooccuussAAuuttooRRaaiissee (class FFooccuussAAuuttooRRaaiissee)
             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 keyboard-
             FocusPolicy is pointer.

     iiccoonnIImmaaggee (class IIccoonnIImmaaggee)
             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 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  supplied  icon
             images.   The  default  value  is  to  display a built-in window
             manager icon image.

     iiccoonnIImmaaggeeBBaacckkggrroouunndd (class BBaacckkggrroouunndd)
             This 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  (that  is,
             specified by "Mwm*background or Mwm*icon*background).

     iiccoonnIImmaaggeeBBoottttoommSShhaaddoowwCCoolloorr (class FFoorreeggrroouunndd)
             This 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
             (that is, specified by Mwm*icon*bottomShadowColor).

     iiccoonnIImmaaggeeBBoottttoommSShhaaddoowwPPiixxmmaapp (class BBoottttoommSShhaaddoowwPPiixxmmaapp)
             This 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
             (that is, specified by Mwm*icon*bottomShadowPixmap).

     iiccoonnIImmaaggeeFFoorreeggrroouunndd (class FFoorreeggrroouunndd)
             This 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 varies depending on the icon background.
















   2-23






   mwm(1X)



     iiccoonnIImmaaggeeTTooppSShhaaddoowwCCoolloorr (class BBaacckkggrroouunndd)
             This 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 icon top shadow  color  (that  is,
             specified by Mwm*icon*topShadowColor).

     iiccoonnIImmaaggeeTTooppSShhaaddoowwPPiixxmmaapp (class TTooppSShhaaddoowwPPiixxmmaapp)
             This 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  (that  is,
             specified by Mwm*icon*topShadowPixmap).

     mmaatttteeBBaacckkggrroouunndd  (class BBaacckkggrroouunndd)
             This resource specifies the background color of the matte,  when
             mmaatttteeWWiiddtthh  is  positive.  The default value of this resource is
             the   client   background   color   (that   is,   specified   by
             "Mwm*background or Mwm*client*background).

     mmaatttteeBBoottttoommSShhaaddoowwCCoolloorr (class FFoorreeggrroouunndd)
             This resource specifies the bottom shadow color  of  the  matte,
             when mmaatttteeWWiiddtthh is positive.  The default value of this resource
             is the  client  bottom  shadow  color  (that  is,  specified  by
             "Mwm*bottomShadowColor or Mwm*client*bottomShadowColor).

     mmaatttteeBBoottttoommSShhaaddoowwPPiixxmmaapp (class BBoottttoommSShhaaddoowwPPiixxmmaapp)
             This resource specifies the bottom shadow Pixmap of  the  matte,
             when mmaatttteeWWiiddtthh is positive.  The default value of this resource
             is the client bottom shadow pixmap (that is, specified by
             "Mwm*bottomShadowPixmap or Mwm*client*bottomShadowPixmap).

     mmaatttteeFFoorreeggrroouunndd (class FFoorreeggrroouunndd)
             This resource specifies the foreground color of the matte,  when
             mmaatttteeWWiiddtthh  is  positive.  The default value of this resource is
             the   client   foreground   color   (that   is,   specified   by
             "Mwm*foreground or Mwm*client*foreground).

     mmaatttteeTTooppSShhaaddoowwCCoolloorr (class BBaacckkggrroouunndd)
             This resource specifies the top shadow color of the matte,  when
             mmaatttteeWWiiddtthh  is  positive.  The default value of this resource is
             the  client  top   shadow   color   (that   is,   specified   by
             "Mwm*topShadowColor or Mwm*client*topShadowColor).

     mmaatttteeTTooppSShhaaddoowwPPiixxmmaapp (class TTooppSShhaaddoowwPPiixxmmaapp)
             This resource specifies the top shadow pixmap of the matte, when
             mmaatttteeWWiiddtthh  is  positive.  The default value of this resource is
             the  client  top  shadow   pixmap   (that   is,   specified   by
             "Mwm*topShadowPixmap or Mwm*client*topShadowPixmap).

     mmaatttteeWWiiddtthh (class MMaatttteeWWiiddtthh)
             This resource specifies the width of the  optional  matte.   The
             default value is 0, which effectively disables the matte.

     mmaaxxiimmuummCClliieennttSSiizzee (class MMaaxxiimmuummCClliieennttSSiizzee)


   2-24






                                                                      mwm(1X)


             This is a size specification that indicates the client  size  to
             be used when an application is maximized.  The resource value is
             specified as _w_i_d_t_hxx_h_e_i_g_h_t.  The width and height are interpreted
             in  the  units  that  the client uses (for example, for terminal
             emulators this is generally characters).  If  this  resource  is
             not  specified,  the  maximum size from the WM_NORMAL_HINTS pro-
             perty is used if set.  Otherwise the default 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.

     uusseeCClliieennttIIccoonn (class UUsseeCClliieennttIIccoonn)
             If the value given for this resource is True, a  client-supplied
             icon  image  takes  precedence  over a user-supplied icon image.
             The default value is False, giving the user-supplied icon  image
             higher precedence than the client-supplied icon image.

     wwiinnddoowwMMeennuu (class WWiinnddoowwMMeennuu)
             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 description file.  Win-
             dow menus can be customized on a client class basis by  specify-
             ing  resources  of  the form MMwwmm**_c_l_i_e_n_t__n_a_m_e__o_r__c_l_a_s_s**wwiinnddoowwMMeennuu
             (see "Mwm Resource Description File Syntax").  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
     defaults files (.Xdefaults, app-defaults/Mwm).  It contains descriptions
     of  resources  that  are  to  be  used by mmwwmm, and that cannot be easily
     encoded in the defaults files (a bitmap file is  an  analogous  type  of
     resource  description  file).  A particular mmwwmm rreessoouurrccee ddeessccrriippttiioonnffiillee
     can be selected using the ccoonnffiiggFFiillee resource.  The following  types  of
     resources can be described in the mmwwmm resource description file:

     BBuuttttoonnss        Window manager functions can be bound  (associated)  with
                    button events.

     KKeeyyss           Window manager functions can be bound  (associated)  with
                    key press events.

     MMeennuuss          Menu panes can be used for  the  window  menu  and  other
                    menus posted with key bindings and button bindings.

     mwm Resource Description File Syntax

     The mmwwmm resource description file is a standard text file that  contains
     items  of information separated by blanks, tabs, and newline characters.
     Blank lines are ignored.  Items or characters can  be  quoted  to  avoid


   2-25






   mwm(1X)


     special interpretation (for example, 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 ().  Single characters can
     be quoted by preceding them by the backslash character  (\\).   All  text
     from  an  unquoted ## to the end of the line is regarded as a comment and
     is not interpreted as part of a resource description.  If !! is the first
     character  in a line, the line is regarded as a comment.  Window manager
     functions can be accessed with button and key bindings, and with  window
     manager  menus.   Functions  are indicated as part of the specifications
     for button and key binding sets, and menu panes.  The function  specifi-
     cation 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 || _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 mmwwmm as
     _f._n_o_p.

     ff..bbeeeepp    This function causes a beep.

     ff..cciirrccllee__ddoowwnn [iiccoonn | wwiinnddooww]
               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 no longer obscures  any  other  window  or  icon).
               This  function  affects  only  those  windows  and  icons that
               obscure other windows and icons, or that are obscured by other
               windows and icons.  Secondary windows (that is, transient win-
               dows) 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 windows  between  the
               secondary  windows and their primary window.  If an iiccoonn func-
               tion argument is  specified,  the  function  applies  only  to
               icons.   If a wwiinnddooww function argument is specified, the func-
               tion applies only to windows.

     ff..cciirrccllee__uupp [iiccoonn | wwiinnddooww]
               This function raises the window or icon on the bottom  of  the
               window  stack  (so  that  it is not obscured by any other win-
               dows).  This function affects only  those  windows  and  icons
               that  obscure other windows and icons, or that are obscured by
               other windows and icons.  Secondary windows  (that  is,  tran-
               sient  windows)  are  restacked  with their associated primary
               window.  If an _i_c_o_n function argument is specified, the  func-
               tion  applies only to icons.  If a _w_i_n_d_o_w function argument is
               specified, the function applies only to windows.











   2-26






                                                                      mwm(1X)



     ff..eexxeecc or !!
               This function causes _c_o_m_m_a_n_d to be executed (using  the  value
               of  the  MWMSHELL environment variable if it is set, otherwise
               the value of the SHELL environment variable if it is set, oth-
               erwise  /_b_i_n/_s_h).   The !! notation can be used in place of the
               ff..eexxeecc function name.

     ff..ffooccuuss__ccoolloorr
               This function sets the colormap focus to a client window.   If
               this  function is done in a root context, the default colormap
               (set up by the _X _W_i_n_d_o_w _S_y_s_t_e_m for the  screen  where  MWM  is
               running)  is  installed and there is no specific client window
               colormap focus.  This function is treated as _f._n_o_p  if  color-
               mapFocusPolicy is not explicit.

     ff..ffooccuuss__kkeeyy
               This function sets the keyboard input focus to a client window
               or  icon.   This  function  is  treated  as _f._n_o_p if keyboard-
               FocusPolicy is not explicit or the function is executed  in  a
               root context.

     ff..kkiillll    This  function  is  used  to  terminate  a  client.   If   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, 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 protocol set
               up,  this  function  causes a client's X connection to be ter-
               minated (usually resulting  in  termination  of  the  client).
               Refer  to  the description of the quitTimeout resource and the
               WM_PROTOCOLS property.

     ff..lloowweerr [--_c_l_i_e_n_t]
               This function lowers a client window to the bottom of the win-
               dow stack (where it obscures no other window).  Secondary win-
               dows (that is, transient windows)  are  restacked  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,  the  context that the function was invoked in
               indicates the window or icon to lower.

     ff..mmaaxxiimmiizzee
               This function causes a client window to be displayed with  its
               maximum size.

     ff..mmeennuu    This 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.

     ff..mmiinniimmiizzee
               This function causes a client window to be  minimized  (iconi-
               fied).   When  a window is minimized when no icon box is used,


   2-27






   mwm(1X)


               its icon is placed on the bottom of the window stack (so  that
               it  obscures  no  other  window).  If an icon box is used, the
               client's icon changes to its iconified form  inside  the  icon
               box.   Secondary  windows  (that  is,  transient  windows) are
               minimized with their associated primary window.  There is only
               one icon for a primary window and all its secondary windows.

     ff..mmoovvee    This function causes  a  client  window  to  be  interactively
               moved.

     ff..nneexxtt__ccmmaapp
               This function installs the next colormap in the list of color-
               maps for the window with the colormap focus.

     ff..nneexxtt__kkeeyy [iiccoonn | wwiinnddooww | ttrraannssiieenntt]
               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
               keyboardFocusPolicy is not explicit.  The keyboard input focus
               is moved only to windows that do not have an associated secon-
               dary window that is application modal.  If the ttrraannssiieenntt argu-
               ment is specified, transient (secondary) windows are traversed
               (otherwise, if only wwiinnddooww is  specified,  traversal  is  done
               only  to the last focused window in a transient group).  If an
               iiccoonn function argument is specified, the function applies only
               to  icons.   If  a  wwiinnddooww function argument is specified, the
               function applies only to windows.

     ff..nnoopp     This function does nothing.

     ff..nnoorrmmaalliizzee
               This function causes a client window to be displayed with  its
               normal  size.   Secondary windows (that is, transient windows)
               are placed in their normal state along with  their  associated
               primary window.

     ff..nnoorrmmaalliizzee__aanndd__rraaiissee
               This function causes the corresponding  client  window  to  be
               displayed  with  its  normal size and raised to the top of the
               window stack.  Secondary windows (that is, transient  windows)
               are  placed  in their normal state along with their associated
               primary window.

     ff..ppaacckk__iiccoonnss
               This 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.








   2-28






                                                                      mwm(1X)



     ff..ppaassss__kkeeyyss
               This function is used to enable/disable (toggle) processing 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.

     ff..ppoosstt__wwmmeennuu
               This 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.

     ff..pprreevv__ccmmaapp
               This function installs the previous colormap in  the  list  of
               colormaps for the window with the colormap focus.

     ff..pprreevv__kkeeyy [iiccoonn | wwiinnddooww | ttrraannssiieenntt]
               This function sets the keyboard input focus  to  the  previous
               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
               keyboardFocusPolicy is not explicit.  The keyboard input focus
               is moved only to windows that do not have an associated secon-
               dary window that is application modal.  If the _t_r_a_n_s_i_e_n_t argu-
               ment is specified, transient (secondary) windows are traversed
               (otherwise, if only _w_i_n_d_o_w is  specified,  traversal  is  done
               only  to the last focused window in a transient group).  If an
               _i_c_o_n function argument is specified, the function applies only
               to  icons.   If  an _w_i_n_d_o_w function argument is specified, the
               function applies only to windows.

     ff..qquuiitt__mmwwmm
               This function terminates mmwwmm (but NOT the X window system).

     ff..rraaiissee [--_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 (that is, transient windows) are restacked 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,  the  context that the function was invoked in
               indicates the window or icon to raise.

     ff..rraaiissee__lloowweerr
               This 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.


   2-29






   mwm(1X)


               Secondary  windows  (that is, transient windows) are restacked
               with their associated primary window.

     ff..rreeffrreesshh This function causes all windows to be redrawn.

     ff..rreeffrreesshh__wwiinn
               This function causes a client window to be redrawn.

     ff..rreessiizzee  This function causes  a  client  window  to  be  interactively
               resized.

     ff..rreessttoorree This function restores the previous state of an icon's associ-
               ated  window.   If  a  maximized  window  is  iconified,  then
               ff..rreessttoorree restores it to its maximized  state.   If  a  normal
               window is iconified, then ff..rreessttoorree restores it to its normal-
               ized state.

     ff..rreessttaarrtt This function causes mmwwmm to  be  restarted  (effectively  ter-
               minated and re-executed).

     ff..sseenndd__mmssgg _m_e_s_s_a_g_e__n_u_m_b_e_r
               This  function  sends   a   client   message   of   the   type
               _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 message is  sent
               only   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.

     ff..sseeppaarraattoorr
               This function causes a menu separator to be put  in  the  menu
               pane at the specified location (the label is ignored).

     ff..sseett__bbeehhaavviioorr
               This function causes the window manager to  restart  with  the
               default  behavior  (if  a  custom  behavior  is configured) or
               revert to the custom behavior.  By default this  is  bound  to
               SShhiifftt CCttrrll MMeettaa <<KKeeyy>>!!.

     ff..ttiittllee   This function inserts a title in the menu pane at  the  speci-
               fied location.

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

     rroooott           No client window or icon has been selected as  an  object
                    for the function.

     wwiinnddooww         A 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 (for example, _f._m_a_x_i_m_i_z_e) or


   2-30






                                                                      mwm(1X)


                    its maximized state (for example, _f._n_o_r_m_a_l_i_z_e).

     iiccoonn           An icon has been selected as an object for the function.

     If a function's context has been specified as iiccoonn||wwiinnddooww and the  func-
     tion  is  invoked  in an icon box, the function applies to the icon box,
     not to the icons inside.

     If a function is specified in a type of resource where it  is  not  sup-
     ported  or  is invoked in a context that does not apply, 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.
   FFuunnccttiioonn                CCoonntteexxttss                  RReessoouurrcceess
   _______________________________________________________________________________
   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
   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                 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.normalize_and_raise   icon, window              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, icon, window        button, key, menu (root only)
   f.raise                 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.restore               icon, window              button, key, menu
   f.restart               root, icon, window        button, key, menu (root only)
   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

     Window Manager Event Specification

     Events are indicated as part of the specifications for button  and  key-
     binding sets, and menu panes.



   2-31






   mwm(1X)


     Button events have the following syntax:

     _b_u_t_t_o_n =          [_m_o_d_i_f_i_e_r__l_i_s_t]<<_b_u_t_t_o_n__e_v_e_n_t__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 button event
     occurs).  The following table indicates 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Mooddiiffiieerr   DDeessccrriippttiioonn
                             _______________________
                             Ctrl       Control Key
                             Shift      Shift Key
                             Alt        Alt/Meta Key
                             Meta       Meta/Alt Key
                             Lock       Lock Key
                             Mod1       Modifier1
                             Mod2       Modifier2
                              MMooddiiffiieerr   DDeessccrriippttiioonn
                              ______________________
                              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Buuttttoonn       DDeessccrriippttiioon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







   2-32






                                                                      mwm(1X)


     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]<<KKeeyy>>_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  but-
     tons.  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).

     Button Bindings

     The bbuuttttoonnBBiinnddiinnggss resource value is the name of a set of  button  bind-
     ings  that  are  used  to  configure  window manager behavior.  A window
     manager function can be done  when  a  button  press   occurs  with  the
     pointer  over  a framed client window, an icon, or the root window.  The
     context for indicating where the button press applies is also  the  con-
     text  for  invoking the window manager function when the button press is
     done (significant for functions that are context sensitive).

     The button binding syntax is BBuuttttoonnss _b_i_n_d_i_n_g_s__s_e_t__n_a_m_e
     {{
         _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
     }}

     The 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[ || _c_o_n_t_e_x_t]
         _o_b_j_e_c_t =    rroooott || iiccoonn || wwiinnddooww || ttiittllee || ffrraammee || bboorrddeerr || aapppp
     The context specification indicates where the pointer must  be  for  the
     button  binding to be effective.  For example, a context of wwiinnddooww indi-
     cates that the pointer must be over a client window or window management
     frame  for the button binding to be effective.  The ffrraammee context is for
     the window management frame around a client window (including the border
     and  titlebar),  the bboorrddeerr context is for the border part of the window
     management frame (not including the titlebar), the ttiittllee context is  for
     the  title  area  of the window management frame, and the aapppp context 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 bind-
     ing is not done.

     Key Bindings

     The kkeeyyBBiinnddiinnggss resource value is the name of a set of key bindings that
     are  used  to configure window manager behavior.  A window manager func-
     tion 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 contexts are the same as those that apply to button  bindings.


   2-33






   mwm(1X)


     The key binding syntax is KKeeyyss _b_i_n_d_i_n_g_s__s_e_t__n_a_m_e
     {{
         _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
                     .
                     .
         _k_e_y    _c_o_n_t_e_x_t    _f_u_n_c_t_i_o_n
     }}

     If an _f._n_o_p function is specified for a key binding, the key binding  is
     not  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, mmwwmm
     will 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  ffrraammee,  ttiittllee,  bboorrddeerr,  and  aapppp contexts are
     equivalent to the wwiinnddooww context.  The context for a key  event  is  the
     window  or  icon that has the keyboard input focus (rroooott if no window or
     icon has the keyboard input focus).

     Menu Panes

     Menus 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 location of the keyboard input focus  indicates  the  context.   For
     menus  popped up using a button binding, the context of the button bind-
     ing is the context of the menu.  The menu pane specification syntax is
     MMeennuu _m_e_n_u__n_a_m_e
     {{
         _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
     }}

     Each 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  button  keyboard  accelerator  may  be
     specified.   Mnemonics  are  functional only when the menu is posted and
     keyboard traversal 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 || _b_i_t_m_a_p__f_i_l_e
                   _b_i_t_m_a_p__f_i_l_e =   @@_f_i_l_e__n_a_m_e
                   _t_e_x_t =          _q_u_o_t_e_d__i_t_e_m || _u_n_q_u_o_t_e_d__i_t_e_m
     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 =   ___c_h_a_r_a_c_t_e_r


   2-34






                                                                      mwm(1X)



     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 win-
     dow 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 does 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.

     Environment

     mmwwmm uses the environment variable HOME specifying the user's home direc-
     tory.

     mmwwmm uses the environment variable LANG specifying the user's  choice  of
     language  for  the  mmwwmm message catalog and the mmwwmm resource description
     file.

     mmwwmm uses the environment variables XFILESEARCHPATH, XUSERFILESEARCHPATH,
     XAPPLRESDIR,  XENVIRONMENT,  LANG,  and HOME in determining search paths
     for resource defaults files.

     mmwwmm reads the $HOME/.motifbind file if it exists to  install  a  virtual
     key bindings property on the root window.

     mmwwmm uses the environment variable MWMSHELL (or SHELL, if MWMSHELL is not
     set), specifying the shell to use when executing commands via the _f._e_x_e_c
     function.

   Files
     $$HHOOMMEE//MMwwmm
     $$HHOOMMEE//..XXddeeffaauullttss
     $$HHOOMMEE//$$LLAANNGG//..mmwwmmrrcc
     $$HHOOMMEE//..mmwwmmrrcc
     $$HHOOMMEE//..mmoottiiffbbiinndd

   RELATED INFORMATION
     VVeennddoorrSShheellll((33XX)), XX((11)), and XXmmIInnssttaallllIImmaaggee((33XX)).

















   2-35



 m
