MAN page from Fedora 23 motif-2.3.4-10.fc23.x86_64.rpm

mwm

Section: Misc. Reference Manual Pages (user cmd)
Index 

NAME

mwm --- The MotifWindow Manager 

SYNOPSIS

mwm [options]  

DESCRIPTION

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

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

Options

-display display

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

-xrm resourcestring

This option specifies a resource string to use.

-multiscreen

This option causes mwm to manage all screens onthe display. The default is to manage only a single screen.

-name name

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

-screens name [name [...]]

This option specifies the resource names to use for the screens managedby mwm. If mwm is managing a singlescreen, only the first name in the list is used. If mwmis 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 secondname, 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 andbehavior of the window manager can be altered by changing the configurationof specific resources. Resources are defined under the heading "X DEFAULTS." 

Screens

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

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

Windows

Default mwm window frames have distinct componentswith associated functions:

Title Area

In addition to displaying the client's title, the title area is usedto 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. By default, a wireframe is moved during the drag to indicate the new location. When the buttonis released, the window is moved to the new location.

Title Bar

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

Minimize Button

To turn the window into an icon, click button 1 on the minimize button(the frame box with a small square in it).

Maximize Button

To make the window fill the screen (or enlarge to the largest size allowedby the configuration files), click button 1 on the maximize button (the framebox with a large square in it).

Window Menu Button

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

The following table lists the contents of the window menu. 

Default Window Menu

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

Resize Border Handles

To change the size of a window, move the pointer over a resize borderhandle (the cursor changes), press button 1, and drag the window to a newsize. When the button is released, the window is resized. While dragging isbeing done, a rubber-band outline is displayed to indicate the new windowsize.

Matte

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

 

Icons

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

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

Icon Window Menu

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

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

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

Icon Box

When icons begin to clutter the screen, they can be packed into an iconbox. (To use an icon box, mwm must be started with theicon box configuration already set.) The icon box is a mwmwindow that holds client icons. It includes one or more scroll bars when thereare 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 followingtable summarizes the behavior of this interface. Button actions apply wheneverthe pointer is on any part of the icon. Note that double-clicking an iconin the icon box invokes the f.restore_and_raise function.

Button	Action	Description
Button 1	click	Selects the icon.
Button 1	double-click	Normalizes (opens) the associated window.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.
Button 3	drag	Highlights items as the pointer moves acrossthe menu.

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

Icon Menu for the Icon Box

Selection	Accelerator	Description
Restore		Opens the associated window (if not alreadyopen).
Move		Allows the icon to be moved with keys.
Size		Inactive.
Minimize		Inactive.
Maximize		Opens the associated window (if not alreadyopen) and maximizes its size.
Lower		Inactive.
Close	Alt+F4	Removes client from mwmmanagement.

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

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

Input Focus

The mwm window manager supports (by default) a keyboardinput focus policy of explicit selection. This means when a window is selectedto get keyboard input, it continues to get keyboard input until the windowis withdrawn from window management, another window is explicitly selectedto get keyboard input, or the window is iconified. Several resources controlthe input focus. The client window with the keyboard input focus has the activewindow appearance with a visually distinct window frame.

The following tables summarize the keyboard input focus selection behavior:

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

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

 

Window Stacking

There are two types of window stacks: global window stacks and an application'slocal family window stack.

The global stacking order of windows may be changed as a result of settingthe keyboard input focus, iconifying a window, or performing a window managerwindow stacking function. When keyboard focus policy is explicit the defaultvalue of the focusAutoRaise resource is True. This causesa window to be raised to the top of the stack when it receives input focus,for example, by pressing button 1 on the title bar. The key actions definedin the previous table will thus raise the window receiving focus to the topof the stack.

In pointer mode, the default value of focusAutoRaiseis False, that is, the window stacking order is not changed when a windowreceives keyboard input focus. The following key actions can be used to cyclethrough the global window stack.

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

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

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

f.lower

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

f.lower [ within]

Lowers the transient window within the family (staying above the parent)but does not lower the family in the global window stack.

f.lower [freeFamily ]

Lowers the window free from its family stack (below the parent), butdoes not lower the family in the global window stack.

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

Session Management

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

X Resources

The mwm command is configured from its resourcedatabase. This database is built from the following sources. They are listedin order of precedence, low to high:

/usr/share/X11/app-defaults/Mwm

$HOME/Mwm

RESOURCE_MANAGER root window property or $HOME/.Xdefaults

XENVIRONMENT variable or $HOME/.Xdefaults-host

mwm command line options

The file names /usr/share/X11/app-defaults/Mwm and $HOME/Mwm represent customary locations for these files. The actuallocation of the system-wide class resource file may depend on the XFILESEARCHPATH environment variable and thecurrent language environment. The actual location of the user-specific classresource file may depend on the XUSERFILESEARCHPATH and XAPPLRESDIRenvironment variables and the current language environment.

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

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

The mwm command uses the following types of resources:

Component Appearance Resources:

These resources specify appearance attributes of window manager userinterface components. They can be applied to the appearance of window managermenus, feedback windows (for example, the window reconfiguration feedbackwindow), client window frames, and icons.

General Appearance and Behavior Resources:

These resources specify mwm appearance and behavior(for example, window management policies). They are not set separately fordifferent mwm user interface components. They apply toall screens and workspaces.

Screen Specific Appearance and Behavior Resources:

These resources specify the appearance and behavior of mwm elements that are settable on a per-screen basis.

Client Specific Resources:

These mwm resources can be set for a particularclient window or class of client windows. They specify client-specific iconand client window frame appearance and behavior.

Resource identifiers can be either a resource name (for example, foreground)or a resource class (for example, Foreground). If the value of a resourceis a filename and if the filename is prefixed by "~/", then it is relativeto the path contained in the HOMEenvironment variable (generally the user's home directory). 

Component Appearance Resources

The syntax for specifying component appearance resources that applyto window manager icons, menus, and client window frames is Mwm* resource_id

For example, Mwm*foreground is used to specifythe foreground color for mwm menus, icons, client windowframes, and feedback dialogs.

The syntax for specifying component appearance resources that applyto a particular mwm component is Mwm*[menu|icon|client|feedback] *resource_id

If menu is specified, the resource is applied onlyto mwm menus; if icon is specified,the resource is applied to icons; and if client is specified,the resource is applied to client window frames. For example, Mwm*icon*foreground is used to specify the foreground color for mwmicons, Mwm*menu*foreground specifies the foregroundcolor for mwm menus, and Mwm*client*foreground is used to specify the foreground color for mwmclient window frames.

The appearance of the title area of a client window frame (includingwindow management buttons) can be separately configured. The syntax for configuringthe title area of a client window frame is Mwm*client*title* resource_id

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

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

For example, Mwm*menu*my_menu*foreground specifiesthe foreground color for the menu named my_menu. Theuser can also specify resources for window manager menu components, that is,the gadgets that comprise the menu. These may include for example, a menutitle, title separator, one or more buttons, and separators. If a menu containsmore than one instance of a class, such as multiple PushButtonGadgets, thename of the first instance is "PushButtonGadget1", the second is "PushButtonGadget2",and so on. The following list identifies the naming convention used for windowmanager menu components:

*

Menu Title LabelGadget - "TitleName"

*

Menu Title SeparatorGadget - "TitleSeparator"

*

CascadeButtonGadget - "CascadeButtonGadget<n>"

*

PushButtonGadget - "PushButtonGadget<n>"

*

SeparatorGadget - "SeparatorGadget<n>"

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

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

Component Appearance Resources - All Window Manager Parts

Name	Class	Value Type	Default
background	Background	color	varies+
backgroundPixmap	BackgroundPixmap	string++	varies+
bottomShadowColor	Foreground	color	varies+
bottomShadowPixmap	Foreground	string++	varies+
fontList	FontList	string+++	"fixed"
foreground	Foreground	color	varies+
saveUnder	SaveUnder	T/F	F
topShadowColor	Background	color	varies+
topShadowPixmap	TopShadowPixmap	string++	varies+

+The default is chosen based on the visual type of the screen.++Image name. See XmInstallImage(3). +++X11X Logical Font Description

background (class  Background)

This resource specifies the background color. Any legal X color maybe specified. The default value is chosen based on the visual type of thescreen.

backgroundPixmap (class  BackgroundPixmap)

This resource specifies the background Pixmap of the mwmdecoration when the window is inactive (does not have the keyboard focus).The default value is chosen based on the visual type of the screen.

bottomShadowColor (class  Foreground)

This resource specifies the bottom shadow color. This color is usedfor the lower and right bevels of the window manager decoration. Any legalX color may be specified. The default value is chosen based on the visualtype of the screen.

bottomShadowPixmap (class  BottomShadowPixmap)

This resource specifies the bottom shadow Pixmap. This Pixmap is usedfor the lower and right bevels of the window manager decoration. The defaultis chosen based on the visual type of the screen.

fontList (class  FontList)

This resource specifies the font used in the window manager decoration.The character encoding of the font should match the character encoding ofthe strings that are used. The default is "fixed."

foreground (class  Foreground)

This resource specifies the foreground color. The default is chosenbased on the visual type of the screen.

saveUnder (class  SaveUnder)

This is used to indicate whether "save unders" are used for mwm components. For this to have any effect, save unders must beimplemented by the X server. If save unders are implemented, the X serversaves the contents of windows obscured by windows that have the save underattribute set. If the saveUnder resource is True, mwm will set the save under attribute on the window manager frameof any client that has it set. If saveUnder is False,save unders will not be used on any window manager frames. The default valueis False.

topShadowColor (class  Background)

This resource specifies the top shadow color. This color is used forthe upper and left bevels of the window manager decoration. The default ischosen based on the visual type of the screen.

topShadowPixmap ( class  TopShadowPixmap)

This resource specifies the top shadow Pixmap. This Pixmap is used forthe upper and left bevels of the window manager decoration. The default ischosen based on the visual type of the screen.

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

Frame and Icon Components

Name	Class	Value Type	Default
activeBackground	Background	color	varies+
activeBackgroundPixmap	BackgroundPixmap	string++	varies+
activeBottomShadowColor	Foreground	color	varies+
activeBottomShadowPixmap	BottomShadowPixmap	string++	varies+
activeForeground	Foreground	color	varies+
activeTopShadowColor	Background	color	varies+
activeTopShadowPixmap	TopShadowPixmap	string++	varies+

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

activeBackground (class  Background)

This resource specifies the background color of the mwmdecoration when the window is active (has the keyboard focus). The defaultis chosen based on the visual type of the screen.

activeBackgroundPixmap (class  ActiveBackgroundPixmap)

This resource specifies the background Pixmap of the mwmdecoration when the window is active (has the keyboard focus). The defaultis chosen based on the visual type of the screen.

activeBottomShadowColor (class  Foreground)

This resource specifies the bottom shadow color of the mwm decoration when the window is active (has the keyboard focus).The default is chosen based on the visual type of the screen.

activeBottomShadowPixmap (class  BottomShadowPixmap)

This resource specifies the bottom shadow Pixmap of the mwm decoration when the window is active (has the keyboard focus).The default is chosen based on the visual type of the screen.

activeForeground (class  Foreground)

This resource specifies the foreground color of the mwmdecoration when the window is active (has the keyboard focus). The defaultis chosen based on the visual type of the screen.

activeTopShadowColor (class  Background)

This resource specifies the top shadow color of the mwmdecoration when the window is active (has the keyboard focus). The defaultis chosen based on the visual type of the screen.

activeTopShadowPixmap (class  TopShadowPixmap)

This resource specifies the top shadow Pixmap of the mwmdecoration when the window is active (has the keyboard focus). The defaultis chosen based on the visual type of the screen.

 

General Appearance and Behavior Resources

The syntax for specifying general appearance and behavior resourcesis Mwm*resource_id

For example, Mwm*keyboardFocusPolicy specifiesthe window manager policy for setting the keyboard focus to a particular clientwindow.

The following general appearance and behavior resources can be specified: 

General Appearance and Behavior Resources

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

+The resource doubleClickTime is included for backward compatibility.Use of the Xt resource multiClickTime is preferred.

autoKeyFocus (class  AutoKeyFocus)

This resource is available only when the keyboard input focus policyis explicit. If autoKeyFocus is given a value of True,then when a window with the keyboard input focus is withdrawn from windowmanagement or is iconified, the focus is set to the previous window that hadthe focus. If the value given is False, there is no automatic setting of thekeyboard input focus. It is recommended that both autoKeyFocus and startupKeyFocus be True to work withtear off menus. The default value is True.

autoRaiseDelay (class  AutoRaiseDelay)

This resource is available only when the focusAutoRaiseresource is True and the keyboard focus policy is pointer. The autoRaiseDelay resource specifies the amount of time (in milliseconds)that mwm will wait before raising a window after it getsthe keyboard focus. The default value of this resource is 500 (ms).

bitmapDirectory (class  BitmapDirectory)

This resource identifies a directory to be searched for bitmaps referencedby mwm resources. This directory is searched if a bitmapis specified without an absolute pathname. The default value for this resourceis /usr/include/X11/bitmaps. The directory /usr/include/X11/bitmapsrepresents the customary locations for this directory. The actuallocation of this directory may vary on some systems. If the bitmap is notfound in the specified directory, XBMLANGPATH is searched.

clientAutoPlace (class  ClientAutoPlace)

This resource determines the position of a window when the window hasnot been given a program- or user-specified position. With a value of True,windows are positioned with the top left corners of the frames offset horizontallyand vertically. A value of False causes the currently configured positionof the window to be used. In either case, mwm will attemptto place the windows totally on-screen. The default value is True.

colormapFocusPolicy (class  ColormapFocusPolicy)

This resource indicates the colormap focus policy that is to be used.If the resource value is explicit, a colormap selection action is done ona client window to set the colormap focus to that window. If the value ispointer, the client window containing the pointer has the colormap focus.If the value is keyboard, the client window that has the keyboard input focushas the colormap focus. The default value for this resource is keyboard.

configFile (class  ConfigFile)

The resource value is the pathname for a mwm resourcedescription file. If the pathname begins with "~/", mwmconsiders it to be relative to the user's home directory (as specified bythe HOME environment variable).If the LANG environment variableis set, mwm looks for $HOME/$LANG/ configFile. If that file does not exist or if LANG is not set, mwm looks for$HOME/configFile. If the configFile pathname does not begin with "~/" or "/", mwm considers it to be relative to the current working directory. Ifthe configFile resource is not specifiedor if that file does not exist, mwm uses several defaultpaths to find a configuration file. The order of the search is shown below: /etc/X11/mwm/$LANG/system.mwmrc+/etc/X11/mwm/system.mwmrc+ Paths marked with '+' areimplementation dependent.

deiconifyKeyFocus (class  DeiconifyKeyFocus)

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 whenit is normalized (deiconified). True is the default value.

doubleClickTime (class  DoubleClickTime)

This resource is used to set the maximum time (in ms) between the clicks(button presses) that make up a double-click. The use of this resource isdeprecated. Use the Xt resource multiClickTime instead.The value of doubleClickTime dynamically defaults tothe value of multiClickTime.

enableWarp (class  EnableWarp)

The default value of this resource, True, causes mwmto warp the pointer to the center of the selected window during keyboard-controlledresize and move operations. Setting the value to False causes mwm to leave the pointer at its original place on the screen, unlessthe user explicitly moves it with the cursor keys or pointing device.

enforceKeyFocus (class  EnforceKeyFocus)

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

frameStyle (class  frameStyle)

If this resource is given a value of "slab", the the window managerframe is drawn such that the client area appears to be at the same heightas the top of the window frame. If the resource is set to "recessed", thewindow frame is drawn such that the client area appears lower than the topof the window frame. The default value is "recessed".

iconAutoPlace (class  IconAutoPlace)

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

iconClick (class  IconClick)

When this resource is given the value of True, the system menu is postedand left posted when an icon is clicked. The default value is True.

interactivePlacement (class  InteractivePlacement)

This resource controls the initial placement of new windows on the screen.If the value is True, the pointer shape changes before a new window is placedon the screen to indicate to the user that a position should be selected forthe upper-left hand corner of the window. If the value is False, windows areplaced according to the initial window configuration attributes. The defaultvalue of this resource is False.

keyboardFocusPolicy (class  KeyboardFocusPolicy)

If set to pointer, the keyboard focus policy is to have the keyboardfocus set to the client window that contains the pointer (the pointer couldalso be in the client window decoration that mwm adds).If set to explicit, the policy is to have the keyboard focus set to a clientwindow when the user presses button 1 with the pointer on the client windowor any part of the associated mwm decoration. The defaultvalue for this resource is explicit.

lowerOnIconify (class  LowerOnIconify)

If this resource is given the default value of True, a window's iconappears 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 asits associated window. The default value of this resource is True.

moveThreshold (class  MoveThreshold)

This resource is used to control the sensitivity of dragging operationsthat move windows and icons. The value of this resource is the number of pixelsthat the locator is moved with a button down before the move operation isinitiated. This is used to prevent window/icon movement when you click ordouble-click and there is unintentional pointer movement with the button down.The default value of this resource is 4 (pixels).

multiScreen (class  MultiScreen)

This resource, if True, causes mwm to manage allthe screens on the display. If False, mwm manages onlya single screen. The default value is False.

passButtons (class  PassButtons)

This resource indicates whether or not button press events are passedto clients after they are used to do a window manager function in the clientcontext. If the resource value is False, the button press is not passed tothe client. If the value is True, the button press is passed to the clientwindow. The window manager function is done in either case. The default valuefor this resource is False.

passSelectButton (class  PassSelectButton)

This resource indicates whether or not to pass the select button pressevents to clients after they are used to do a window manager function in theclient context. If the resource value is False, then the button press willnot be passed to the client. If the value is True, the button press is passedto the client window. The window manager function is done in either case.The default value for this resource is True.

positionIsFrame (class  PositionIsFrame)

This resource indicates how client window position information (fromthe WM_NORMAL_HINTS property and from configuration requests)is to be interpreted. If the resource value is True, the information is interpretedas the position of the mwm client window frame. If thevalue is False, it is interpreted as being the position of the client areaof the window. The default value of this resource is True.

positionOnScreen (class  PositionOnScreen)

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 theresource 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 resourcevalue is False, windows are placed in the requested position even if totallyoff-screen. The default value of this resource is True.

quitTimeout (class  QuitTimeout)

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

raiseKeyFocus (class  RaiseKeyFocus)

This resource is available only when the keyboard input focus policyis explicit. When set to True, this resource specifies that a window raisedby means of the f.normalize_and_raise function also receivesthe input focus. The default value of this resource is False.

refreshByClearing (class  RefreshByClearing)

This resource determines the mechanism used to refresh a window (orthe screen) when the f.refresh_win (f.refresh) function is executed. When set to True, an XClearArea is performedover the window for f.refresh_win. When set to False,a covering window is created and destroyed over the top of the window to berefreshed. If the function is f.refresh and this resourceis set to True, then an XClearArea is performed over every window on the screen.If the resource is set to False, then one large window covering the entirescreen is created and destroyed. The default value of this resource is True.

rootButtonClick (class  RootButtonClick)

The rootButtonClick resource controls whether thea click on the root window will post the root menu in a "sticky" mode. Ifthis resource is set to True, a button click on the root window will postthe menu bound to the button down event for that button in a "sticky" fashion.If this resource is set to False, then the same button click would only causethe menu to flash as it would be unposted once the button up event is seen.The criterion used to determine if it is a button click is if the pointerdoesn't move between the button down and button up events. The default valuefor this resource is True.

screens (class  Screens)

This resource specifies the resource names to use for the screens managedby mwm. If mwm is managing a singlescreen, only the first name in the list is used. If mwmis 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 secondname, and so on. The default screen names are 0, 1, and so on.

sessionClientDB (class  SessionClientDB)

This resource identifies a file name to use as a root when saving stateat the request of an XSMP session manager. When the session is saved, the window manager will then reusethe file name by automatically incrementing a suffix.

showFeedback (class  ShowFeedback)

This resource controls whether or not feedback windows or confirmationdialogs are displayed. A feedback window shows a client window's initialplacement and shows position and size during move and resize operations.Confirmation dialogs can be displayed for certain operations. The value forthis resource is a list of names of the feedback options to be enabled ordisabled; the names must be separated by a space. If an option is precededby a minus sign, that option is excluded from the list. The sign of the first item in the list determines the initial set of options.If the sign of the first option is minus, mwm assumesall options are present and starts subtracting from that set. If the signof the first decoration is plus (or not specified), mwmstarts with no options and builds up a list from the resource.

The names of the feedback options are shown below:

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

The following command line illustrates the syntax for showFeedback:

Mwm*showFeedback: placement resize behavior restart

This resource specification provides feedback for initial client placementand resize, and enables the dialog boxes to confirm the restart and set behaviorfunctions. It disables feedback for the move function. The default value forthis resource is all.

startupKeyFocus (class  StartupKeyFocus)

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

wMenuButtonClick (class  WMenuButtonClick)

This resource indicates whether a click of the mouse when the pointeris over the window menu button posts and leaves posted the window menu. Ifthe value given this resource is True, the menu remains posted. True is thedefault value for this resource.

wMenuButtonClick2 (class  WMenuButtonClick2)

When this resource is given the default value of True, a double-clickaction on the window menu button does an f.kill function.

 

Screen Specific Appearance and Behavior Resources

The syntax for specifying screen specific resources is Mwm* screen_name*resource_id For example, Mwm*1*keyBindings specifiesthe key bindings to use for screen "1". 

Screen Specific Resources

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

buttonBindings (class  ButtonBindings)

This resource identifies the set of button bindings for window managementfunctions. The named set of button bindings is specified in the mwm resource description file. These button bindings are merged with the built-in default bindings. The default value forthis resource is "DefaultButtonBindings".

cleanText (class  CleanText)

This resource controls the display of window manager text in the clienttitle and feedback windows. If the default value of True is used, the textis drawn with a clear (no stipple) background. This makes text easier to readon monochrome systems where a backgroundPixmap is specified. Only the stipplingin the area immediately around the text is cleared. If False, the text isdrawn directly on top of the existing background.

fadeNormalIcon (class  FadeNormalIcon)

If this resource is given a value of True, an icon is grayed out wheneverit has been normalized (its window has been opened). The default value isFalse.

feedbackGeometry (class  FeedbackGeometry)

This resource sets the position of the move and resize feedback window.If this resource is not specified, the default is to place the feedback windowat the center of the screen. The value of the resource is a standard windowgeometry string with the following syntax: [=]{ +-}xoffset{+-} yoffset]

frameBorderWidth (class  FrameBorderWidth)

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

iconBoxGeometry (class  IconBoxGeometry)

This resource indicates the initial position and size of the icon box.The value of the resource is a standard window geometry string with the followingsyntax: [=][width xheight][{+-}xoffset {+-}yoffset] If the offsetsare not provided, the iconPlacement policy is used to determine the initialplacement. The units for width and height are columns and rows. The actualscreen size of the icon box window depends on the iconImageMaximum (size)and iconDecoration resources. The default value for sizeis (6 * iconWidth + padding) wide by (1 * iconHeight + padding) high. Thedefault value of the location is +0 -0.

iconBoxName (class  IconBoxName)

This resource specifies the name that is used to look up icon box resources.The default name is iconbox.

iconBoxSBDisplayPolicy (class  IconBoxSBDisplayPolicy)

This resource specifies the scroll bar display policy of the windowmanager in the icon box. The resource has three possible values: all, vertical,and horizontal. The default value, "all", causes both vertical and horizontalscroll bars always to appear. The value "vertical" causes a single verticalscroll bar to appear in the icon box and sets the orientation of the iconbox to horizontal (regardless of the iconBoxGeometry specification). The value"horizontal" causes a single horizontal scroll bar to appear in the icon boxand sets the orientation of the icon box to vertical (regardless of the iconBoxGeometryspecification).

iconBoxTitle (class  IconBoxTitle)

This resource specifies the name that is used in the title area of theicon box frame. The default value is Icons.

iconDecoration (class  IconDecoration)

This resource specifies the general icon decoration. The resource valueis label (only the label part is displayed) or image (only the image partis displayed) or label image (both the label and image parts are displayed).A value of activelabel can also be specified to get a label (not truncatedto the width of the icon) when the icon is selected. The default icon decorationfor icon box icons is that each icon has a label part and an image part (labelimage). The default icon decoration for stand alone icons is that each iconhas an active label part, a label part, and an image part (activelabel labelimage).

iconImageMaximum (class  IconImageMaximum)

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

iconImageMinimum (class  IconImageMinimum)

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

iconPlacement (class  IconPlacement)

This resource specifies the icon placement scheme to be used. The resourcevalue has the following syntax:

primary_layout secondary_layout [tight]

The layout values are one of the following:

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

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

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

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

iconPlacementMargin (class  IconPlacementMargin)

This resource sets the distance between the edge of the screen and theicons that are placed along the edge of the screen. The value should be greaterthan or equal to 0. A default value (see below) is used if the value specifiedis invalid. The default value for this resource is equal to the space betweenicons as they are placed on the screen (this space is based on maximizingthe number of icons in each row and column).

keyBindings (class  KeyBindings)

This resource identifies the set of key bindings for window managementfunctions. If specified, these key bindings replace thebuilt-in default bindings. The named set of key bindings is specified in mwm resource description file. The default value for this resourceis "DefaultKeyBindings".

limitResize (class  LimitResize)

If this resource is True, the user is not allowed to resize a windowto greater than the maximum size. The default value for this resource is True.

maximumMaximumSize (class  MaximumMaximumSize)

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

moveOpaque (class  MoveOpaque)

This resource controls whether the actual window is moved or a rectangularoutline of the window is moved. A default value of False displays a rectangularoutline on moves.

resizeBorderWidth (class  ResizeBorderWidth)

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

resizeCursors (class  ResizeCursors)

This is used to indicate whether the resize cursors are always displayedwhen the pointer is in the window size border. If True, the cursors are shown,otherwise the window manager cursor is shown. The default value is True.

transientDecoration (class  TransientDecoration)

This controls the amount of decoration that mwmputs on transient windows. The decoration specification is exactly the sameas for the clientDecoration (client specific) resource.Transient windows are identified by the WM_TRANSIENT_FORproperty, which is added by the client to indicate a relatively temporarywindow. The default value for this resource is menu title (that is, transientwindows have frame borders and a titlebar with a window menu button).

An application can also specify which decorations mwmshould apply to its windows. If it does so, mwm appliesonly those decorations indicated by both the application and the transientDecoration resource. Otherwise, mwmapplies the decorations indicated by the transientDecorationresource. For more information see the description of XmNmwmDecorations on the VendorShell(3)reference page.

transientFunctions (class  TransientFunctions)

This resource is used to indicate which window management functionsare applicable (or not applicable) to transient windows. The function specificationis exactly the same as for the clientFunctions (clientspecific) resource. The default value for this resource is -minimize -maximize.

An application can also specify which functions mwmshould apply to its windows. If it does so, mwm appliesonly those functions indicated by both the application and the transientFunctions resource. Otherwise, mwmapplies the functions indicated by the transientFunctionsresource. For more information see the description of XmNmwmFunctions on the VendorShell(3) referencepage.

useIconBox (class  UseIconBox)

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

 

Client Specific Resources

The syntax for specifying client specific resources is

Mwm*client_name_or_class *resource_id

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

Mwm*resource_id

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

The syntax for specifying resource values for windows that have an unknownname and class (that is, windows that do not have a WM_CLASSproperty associated with them) is

Mwm*defaults*resource_id

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

The following client specific resources can be specified: 

Client Specific Resources

Name	Class	Value Type	Default
clientDecoration	ClientDecoration	string	all.
clientFunctions	ClientFunctions	string	all.
focusAutoRaise	FocusAutoRaise	T/F	varies
iconImage	IconImage	pathname	(image)
iconImage-	Background	color	icon background
Background
iconImageBottom-	Foreground	color	icon
ShadowColor			bottom shadow
iconImageBottom-	BottomShadow-	color	icon bottom
ShadowPixmap	Pixmap		shadow pixmap
iconImageForeground	Foreground	color	varies
iconImageTopShadowColor	Background	color	icon top