Commands Reference, Volume 3

mwm Command

Purpose

Runs the AIXwindows Window Manager (MWM).

Syntax

mwm -display Host:Display:ScreenID -xrm ResourceString -multiscreen -name Name -screens Name [ Name ... ]

Description

The mwm command runs the AIXwindows Window Manager (MWM) and is often started by a display or session manager. The AIXwindows Window Manager (MWM) is an X Window System client that provides window management functionality and some session management functionality. It provides functions that facilitate control (by the user and the programmer) of elements of window states such as placement, size, icon or normal display, and input-focus ownership. It also provides session management functions such as stopping a client.

The appearance and behavior of the window manager can be altered by changing the configuration of specific resources. Resources are defined under X Defaults .

By default, the mwm command manages only the single screen specified by 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, the mwm command tries to manage all the screens on the display.

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

For information on windows, icons, resources, events, button and key bindings, menus, and variables, see the following sections:

Flags

-display Host:Display:ScreenID	Specifies the display to use. The -display option has the following parameters: Host Specifies the host name of a valid system on the network. Depending on the situation, this could be the host name of the user or the host name of a remote system. Display Specifies the number (usually 0) of the display on the system on which the output is to be displayed. ScreenID Specifies the number of the screen where the output is to be displayed. This number is 0 for single-screen systems.
-xrm ResourceString	Enables the named resources when starting the mwm command.
-multiscreen	Causes the mwm command to manage all screens on the display. The default is to manage only a single screen.
-name Name	Causes the mwm command to retrieve its resources using the specified name, as in Name*Resource.
-screens Name [Name [...]]	Specifies the resource names to use for the screens managed by MWM. If MWM is managing a single screen, only the first name in the list is used. If multiple screens are being managed, the names are assigned to the screens in order, starting with screen 0. For example, screen 0 gets the first name and screen 1 gets the second name.

Windows

Default window manager window frames have the following distinct components with associated functions:

title area	In addition to displaying the client's title, the title area is used to move the window. To move the window, place the pointer over the title area, press button 1 and drag the window to a new location. A wire frame is moved during the drag to indicate the new location. When the button is released, the window is moved to the new location.
title bar	The title bar includes the title area, the Minimize button, the Maximize button, and the Window Menu button. 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 allowed by the configuration files), click button 1 on the Maximize button (the frame box with a large square in it).
Window Menu button	The Window Menu button is the frame box with a horizontal bar in it. To pull down the window menu, press button 1. While pressing the button, drag the pointer on the menu to your selection and release the button when your selection is highlighted. Pressing button 3 in the title bar or resize border handles also posts the window menu. Alternately, you can click button 1 to pull down the menu and keep it posted; then position the pointer and select. You can also post the window menu by pressing the Shift+Esc or Alt+Space key sequence. Double-clicking button 1 with the pointer on the Window Menu button closes the window. The following table lists the contents of the window menu: Default Window Menu Selection Accelerator Description Restore Alt+F5 Restores the window to its size before minimizing or maximizing. Move Alt+F7 Allows the window to be moved with keys or mouse. Size Alt+F8 Allows the window to be resized. Minimize Alt+F9 Turns the window into an icon. Maximize Alt+F10 Makes the window fill the screen. Lower Alt+F3 Moves window to bottom of window stack. Close Alt+F4 Causes client to stop.
resize border handles	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 indicate the new window size.
matte	An optional matte decoration can be added between the client area and the window frame. A matte is not actually part of the window frame. There is no functionality associated with a matte.

Icons

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

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

Icon Window Menu
Selection	Accelerator	Description
Restore	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).
Maximize	Alt+F10	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 window manager management.

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

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

Icon Box

When icons begin to clutter the screen, they can be packed into an icon box. (To use an icon box, the window manager must be started with the icon box configuration already set.) The icon box is a window manager 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 button action descriptions summarize the behavior of this interface. Button actions apply whenever the pointer is on any part of the icon. Double-clicking an icon in the icon box calls the f.restore_and_raise function.

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

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

Icon Menu for Icon Box
Selection	Accelerator	Description
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.
Maximize	Alt+F10	Opens the associated window (if not already open) and maximizes its size.
Lower	Alt+F3	Inactive.
Close	Alt+F4	Removes client from window manager 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) selection. When selected, the PackIcons option packs the icons in the box to achieve neat rows with no empty slots.

You can also post the window menu by pressing the Shift+Esc or Alt+Space key sequence. Pressing the pop-up Menu key causes the icon window menu of the currently selected icon to open.

Input Focus

The mwm command 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 table and key action descriptions summarize the keyboard input focus selection behavior:

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

Key Action	Function Description
Alt+Tab	Moves the input focus to next window in the window stack.
Alt+Shift+Tab	Moves the input focus to the previous window in the window stack (available only in explicit focus mode).

Window Stacking

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

The global stacking order of windows can be changed as a result of setting the keyboard input focus, iconifying a window, or performing a window manager window stacking function. When keyboard focus policy is explicit the default value of the focusAutoRaise resource is True. This causes a window to be raised to the top of the stack when it receives input focus, for example, by pressing button 1 on the title bar. The key actions defined in the preceding list raises the window receiving focus to the top of the stack.

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

Key Action	Function Description
Alt+Esc	Places top window on bottom of stack.
Alt+Shift+Esc	Places bottom window on top of stack.

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

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

f.lower	Lowers the transient window within the family (staying above the parent) and lowers the family in the global window stack.
f.lower [within]	Lowers the transient window within the family (staying above the parent) but does not lower the family in the global window stack.
f.lower [freeFamily]	Lowers the window separate from its family stack (below the parent), but does not lower the family in the global window stack.

The within and freeFamily parameter values can also be used with the f.raise and f.raise_lower functions.

X Defaults

The mwm command is configured from its resource database. This database is built from the following sources. They are listed in order of precedence.

mwm command line options
XENVIRONMENT variable or $HOME/.Xdefaults-host
RESOURCE_MANAGER root window property or $HOME/.Xdefaults
$HOME/Mwm
/usr/lib/X11/app-defaults/Mwm.

The /usr/lib/X11/app-defaults/Mwm and $HOME/Mwm file names represent customary locations for these files. The actual location of the systemwide class resource file might depend on the XFILESEARCHPATH environment variable and the current language environment. The actual location of the user-specific class resource file might depend on the XUSERFILESEARCHPATH and XAPPLRESDIR environment variables and the current language environment.

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

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

component appearance resource set	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.
frame and icon component resource set	This subset of component appearance resources specifies attributes that are specific to frame and icon components.
general appearance and behavior resource set	These resources specify the mwm command appearance and behavior (for example, window management policies). They are not set separately for different mwm command user-interface components.
client-specific resource set	These mwm resources can be set for a particular client window or class of client windows. They specify client-specific icon and client window frame appearance and behavior.

Resource identifiers can be either a resource name (for example, foreground) or a resource class (for example, Foreground). If the value of a resource is a file name and if the file name is prefixed by the ~/ (tilde followed by a slash) characters, 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 as follows:

Mwm*ResourceID

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

The syntax for specifying component appearance resources that apply to a particular mwm component is as follows:

Mwm*[Menu|Icon|Client|Feedback]*ResourceID

If Menu is specified, the resource is applied only to Mwm menus; if Icon is specified, the resource is applied to icons; and if Client is specified, the resource is applied to client window frames. For example, Mwm*Icon*foreground is used to specify the foreground color for the mwm command icons, Mwm*Menu*foreground specifies the foreground color for the mwm command menus, and Mwm*Client*foreground is used to specify the foreground color for the mwm command 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 as follows:

Mwm*Client*Title*ResourceID

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

The appearance of menus can be configured based on the name of the menu. The syntax for specifying menu appearance by name is as follows:

Mwm*Menu*MenuName*ResourceID

For example, Mwm*Menu*MyMenu*foreground specifies the foreground color for the menu named MyMenu.

The user can also specify resources for window manager menu components (the gadgets that comprise the menu). These may include, for example, a menu title, a title separator, one or more buttons, and separators. If a menu contains more than one instance of a class, such as multiple PushButtonGadget gadgets, the name of the first instance is PushButtonGadget1, the second is PushButtonGadget2, and so on. The following list identifies the naming conventions used for window manager menu components:

TitleName	Menu title LabelGadget
TitleSeparator	Menu title SeparatorGadget
CascadeButtonGadgetn	CascadeButtonGadget
PushButtonGadgetn	PushButtonGadget
SeparatorGadgetn	SeparatorGadget

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

Component Appearance Resource Set

Name	Class	Value Type	Default
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	True or False	False
topShadowColor	Background	color	varies¹
topShadowPixmap	TopShadowPixmap	string²	varies¹
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	True or False	False
topShadowColor	Background	color	varies¹
topShadowPixmap	TopShadowPixmap	string²	varies¹
Notes: The default is chosen based on the visual type of the screen. Image name. X Version 11 Release 4 (X11R4) font description.

background (class Background)	Specifies the background color. Any legal X color can be specified. The default value is chosen based on the visual type of the screen.
backgroundPixmap (class BackgroundPixmap)	Specifies the background pixmap of the mwm decoration 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)	Specifies the bottom shadow color. This color is used for the lower and right bevels of the window manager decoration. Any legal X color can be specified. The default value is chosen based on the visual type of the screen.
bottomShadowPixmap (class BottomShadowPixmap)	Specifies the bottom shadow pixmap. This pixmap is used for the lower and right bevels of the window manager decoration. The default is chosen based on the visual type of the screen.
fontList (class FontList)	Specifies the font used in the window manager decoration. The character encoding of the font needs to match the character encoding of the strings that are used. The default is the fixed value.
foreground (class Foreground)	Specifies the foreground color. The default is chosen based on the visual type of the screen.
saveUnder (class SaveUnder)	Controls the repainting of windows that are uncovered after being obscured. This resource indicates whether save unders are used for mwm components. For this to have any effect, save unders must be implemented by the X server. If save unders are 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, the mwm command sets the save under attribute on the window manager frame of any client that has it set. If the saveUnder resource is False, save unders is not used on any window manager frames. The default value is False.
topShadowColor (class Background)	Specifies the top shadow color. This color is used for the upper and left bevels of the window manager decoration. The default is chosen based on the visual type of the screen.
topShadowPixmap (class TopShadowPixmap)	Specifies the top shadow pixmap. This pixmap is used for the upper and left bevels of the window manager decoration. The default is chosen based on the visual type of the screen.

Frame and Icon Component Resource Set

Note

Hyphens in the following table are for readability purposes only. Do not include hyphens within names in programs.

Name	Class	Value Type	Default
activeBackground	Background	color	varies¹
activeBackground-Pixmap	BackgroundPixmap	string²	varies¹
activeBottomShadow-Color	Foreground	color	varies¹
activeBottomShadow-Pixmap	BottomShadow-Pixmap	string²	varies¹
activeForeground	Foreground	color	varies¹
activeTopShadowColor	Background	color	varies¹
activeTopShadowPixmap	TopShadowPixmap	string²	varies¹
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¹
Notes: The default is chosen based on the visual type of the screen. Image name.

activeBackground (class Background)	Specifies the background 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.
activeBackgroundPixmap (class BackgroundPixmap)	Specifies the background 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.
activeBottomShadowColor (class Foreground)	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)	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)	Specifies the foreground 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.
activeTopShadowColor (class Background)	Specifies the top 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.
activeTopShadowPixmap (class TopShadowPixmap)	Specifies the top 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.

General Appearance and Behavior Resources

The syntax for specifying general appearance and behavior resources is as follows:

Mwm*ResourceID

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

General Appearance and Behavior Resource Set

Note

Hyphens in the following table are for readability purposes only. Do not include hyphens within names in programs.

Name	Class	Value Type	Default
autoKeyFocus	AutoKeyFocus	True or False	True
autoRaiseDelay	AutoRaiseDelay	millisec.	500
bitmapDirectory	BitmapDirectory	directory	/usr/include/X11/bitmaps
buttonBindings	ButtonBindings	string	"DefaultButton-Bindings"
cleanText	CleanText	True or False	True
clientAutoPlace	ClientAutoPlace	True or False	True
colormapFocusPolicy	ColormapFocus-Policy	string	keyboard
configFile	ConfigFile	file	.mwmrc
deiconifyKeyFocus	DeiconifyKeyFocus	True or False	True
doubleClickTime	DoubleClickTime	millisec.	multiclick time
enableWarp	enableWarp	True or False	True
enforceKeyFocus	EnforceKeyFocus	True or False	True
fadeNormalIcon	FadeNormalIcon	True or False	False
feedbackGeometry	FeedbackGeometry	string	center on screen
frameBorderWidth	FrameBorderWidth	pixels	varies
iconAutoPlace	IconAutoPlace	True or False	True
iconBoxGeometry	IconBoxGeometry	string	6x1+0-0
iconBoxName	IconBoxName	string	iconbox
iconBoxSBDisplayPolicy	IconBoxSBDisplayPolicy	string	all
iconBoxTitle	IconBoxTitle	XmString	Icons
iconClick	IconClick	True or False	True
iconDecoration	IconDecoration	string	varies
iconImage-Maximum	IconImage-Maximum	wxh	50x50
iconImageMinimum	IconImageMinimum	wxh	16x16
iconPlacement	IconPlacement	string	left bottom
iconPlacementMargin	IconPlacementMargin	pixels	varies
interactivePlacement	InteractivePlacement	True or False	False
keyBindings	KeyBindings	string	"DefaultKeyBindings"
keyboardFocusPolicy	KeyboardFocusPolicy	string	explicit
limitResize	LimitResize	True or False	True
lowerOnIconify	LowerOnIconify	True or False	True
maximumMaximuSize	MaximumMaximuSize	wxh (pixels)	2X screen w&h
moveOpaque	MoveOpaque	True or False	False
moveThreshold	MoveThreshold	pixels	4
multiScreen	MultiScreen	True or False	False
passButtons	PassButtons	True or False	False
PassSelectButton	PassSelectButton	True or False	True
positionIsFrame	PositionIsFrame	True or False	True
positionOnScreen	PositionOnScreen	True or False	True
quitTimeout	QuitTimeout	millisec.	1000
raiseKeyFocus	RaiseKeyFocus	True or False	False
resizeBorderWidth	ResizeBorder-Width	pixels	varies
resizeCursors	ResizeCursors	True or False	True
screens	Screens	string	varies
showFeedback	ShowFeedback	string	all
startupKeyFocus	StartupKeyFocus	True or False	True
transientDecoration	Transient-Decoration	string	menu title
transientFunctions	Transient-Functions	string	-minimize -maximize
useIconBox	UseIconBox	True or False	False
wMenuButtonClick	WMenuButtonClick	True or False	True
wMenuButtonClick2	WMenuButtonClick2	True or False	True
autoKeyFocus	AutoKeyFocus	True or False	True
autoRaiseDelay	AutoRaiseDelay	millisec.	500
bitmapDirectory	BitmapDirectory	directory	/usr/include/X11/bitmaps
buttonBindings	ButtonBindings	string	"DefaultButtonBindings"
cleanText	CleanText	True or False	True
clientAutoPlace	ClientAutoPlace	True or False	True
colormapFocusPolicy	ColormapFocusPolicy	string	keyboard
configFile	ConfigFile	file	.mwmrc
deiconifyKeyFocus	DeiconifyKeyFocus	True or False	True
doubleClickTime	DoubleClickTime	millisec.	multiclick time
enableWarp	enableWarp	True or False	True
enforceKeyFocus	EnforceKeyFocus	True or False	True
fadeNormalIcon	FadeNormalIcon	True or False	False
feedbackGeometry	FeedbackGeometry	string	center on screen
frameBorderWidth	FrameBorderWidth	pixels	varies
iconAutoPlace	IconAutoPlace	True or False	True
iconBoxGeometry	IconBoxGeometry	string	6x1+0-0
iconBoxName	IconBoxName	string	iconbox
iconBoxSBDisplayPolicy	IconBoxSBDisplayPolicy	string	all
iconBoxTitle	IconBoxTitle	XmString	Icons
iconClick	IconClick	True or False	True
iconDecoration	IconDecoration	string	varies
iconImageMaximum	IconImageMaximum	wxh	50x50
iconImageMinimum	IconImageMinimum	wxh	16x16
iconPlacement	IconPlacement	string	left bottom
iconPlacementMargin	IconPlacementMargin	pixels	varies
interactivePlacement	InteractivePlacement	True or False	False
keyBindings	KeyBindings	string	"DefaultKeyBindings"
keyboardFocusPolicy	KeyboardFocusPolicy	string	explicit
limitResize	LimitResize	True or False	True
lowerOnIconify	LowerOnIconify	True or False	True
maximumMaximumSize	MaximumMaximumSize	wxh (pixels)	2X screen w&h
moveOpaque	MoveOpaque	True or False	False
moveThreshold	MoveThreshold	pixels	4
multiScreen	MultiScreen	True or False	False
passButtons	PassButtons	True or False	False
PassSelectButton	PassSelectButton	True or False	True
positionIsFrame	PositionIsFrame	True or False	True
positionOnScreen	PositionOnScreen	True or False	True
quitTimeout	QuitTimeout	millisec.	1000
raiseKeyFocus	RaiseKeyFocus	True or False	False
resizeBorderWidth	ResizeBorderWidth	pixels	varies
resizeCursors	ResizeCursors	True or False	True
screens	Screens	string	varies
showFeedback	ShowFeedback	string	all
startupKeyFocus	StartupKeyFocus	True or False	True
transientDecoration	TransientDecoration	string	menu title
transientFunctions	TransientFunctions	string	-minimize -maximize
useIconBox	UseIconBox	True or False	False
wMenuButtonClick	WMenuButtonClick	True or False	True
wMenuButtonClick2	WMenuButtonClick2	True or False	True
Note Abbreviations for value types: w = width h = height millisec = milliseconds

autoKeyFocus (class AutoKeyFocus)	Controls whether the focus is set to the previous window that had the focus. If the autoKeyFocus resource is given a value of True and a window with the keyboard input focus is withdrawn from window management or is iconified, the focus is set to the previous window that had the focus. If the value given is False, there is no automatic setting of the keyboard input focus. It is recommended that both the autoKeyFocus resource and the startupKeyFocus resource be set to a value of True to work with tear-off menus. The default value is True. This resource is available only when the keyboard input focus policy is set to the explicit value.
autoRaiseDelay (class AutoRaiseDelay)	Specifies the amount of time in milliseconds (ms) that the mwm command waits before raising a window after it gets the keyboard focus. The default value of this resource is 500 (milliseconds). This resource is available only when the focusAutoRaise resource is True and the keyboard focus policy is the pointer value.
bitmapDirectory (class BitmapDirectory)	Identifies a directory to be searched for bitmaps referenced by mwm resources. This directory is searched if a bitmap is specified without an absolute path name. The default value for this resource is /usr/include/X11/bitmaps. The /usr/include/X11/bitmaps directory represents the customary locations for this directory. The actual location of this directory may vary on some systems. If the bitmap is not found in the specified directory, the XBMLANGPATH environment variable is searched.
buttonBindings (class ButtonBindings)	Identifies the set of button bindings for window management functions. The named set of button bindings is specified in the mwm resource description file. These button bindings are merged with the built-in default bindings. The default value for this resource is DefaultButtonBindings.
cleanText (class CleanText)	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.
clientAutoPlace (class ClientAutoPlace)	Determines the position of a window when the window does not have 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, the mwm command attempts to place the windows totally on-screen. The default value is True.
colormapFocusPolicy (class ColormapFocusPolicy)	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 containing the pointer has the colormap focus. If the value is keyboard, the client window that has the keyboard input focus has the colormap focus. The default value for this resource is keyboard.
configFile (class ConfigFile)	Contains the path name for an mwm resource description file. If the path name begins with the ~/ characters, the mwm command considers it to be relative to the user's home directory (as specified by the HOME environment variable). If the LANG environment variable is set, the mwm command 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 path name does not begin with the ~/ characters, mwm considers it to be relative to the current working directory. If the configFile resource is not specified or if that file does not exist, the mwm command uses several default paths to find a configuration file. If the LANG environment variable is set, the mwm command looks for the configuration file first in the $HOME/$LANG/.mwmrc file. If that file does not exist or if the LANG environment variable is not set, the mwm command looks for the $HOME/.mwmrc file. If the $HOME/.mwmrc file does not exist and if the LANG environment variable is set, the mwm command next looks for the /usr/lib/X11/$LANG/system.mwmrc file. If the /usr/lib/X11/$LANG/system.mwmrc file does not exist or if the LANG environment variable is not set, the mwm command looks for /usr/lib/X11/system.mwmrc.
deiconifyKeyFocus (class DeiconifyKeyFocus)	Determines whether a window receives the keyboard input focus when it is deiconified (normalized). The default value is True. This resource applies only when the keyboard input focus policy is set to the explicit value.
doubleClickTime (class DoubleClickTime)	Sets 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 multiclick time.
enableWarp (class EnableWarp)	Causes the mwm command to warp the pointer to the center of the selected window during keyboard-controlled resize and move operations. Setting the value to False causes the mwm command to leave the pointer at its original place on the screen unless the user explicitly moves it with the cursor keys or pointing device. The default value of this resource is True.
enforceKeyFocus (class EnforceKeyFocus)	Determines whether 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.
fadeNormalIcon (class FadeNormalIcon)	Determines whether an icon is unavailable whenever it is normalized (its window is opened). The default value is False.
feedbackGeometry (class FeedbackGeometry)	Sets the position of the move and resize feedback window. If this resource is not specified, the default is to place the feedback window at the center of the screen. The value of the resource is a standard window geometry string with the following syntax: [=][{+-}XOffset{+-}YOffset]
frameBorderWidth (class FrameBorderWidth)	Specifies the width in pixels of a client window frame border without resize handles. The border width includes the three-dimensional (3-D) shadows. The default value is based on the size and resolution of the screen.
iconAutoPlace (class IconAutoPlace)	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 True value indicates that icons are arranged in a particular area of the screen determined by the iconPlacement resource. The False value indicates that an icon is placed at the location of the window when it is iconified. The default is True.
iconBoxGeometry (class IconBoxGeometry)	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: [=][WidthxHeight][{+-}XOffset{+-}YOffset] 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 iconDecoration resources. The default value for size is (6 times iconWidth + padding) wide by (1 times iconHeight + padding) high. The default value of the location is +0 -0.
iconBoxName (class IconBoxName)	Specifies the name that is used to look up icon box resources. The default name is iconbox.
iconBoxSBDisplayPolicy (class IconBoxSBDisplayPolicy)	Specifies the scroll bar display policy of the window manager in the icon box. The resource has the following three possible values: all, vertical, and horizontal. The default value, all, causes both vertical and horizontal scroll bars always to be displayed. The vertical value causes a single vertical scroll bar to be displayed in the icon box and sets the orientation of the icon box to horizontal (regardless of the iconBoxGeometry specification). The horizontal value causes a single horizontal scroll bar to be displayed in the icon box and sets the orientation of the icon box to vertical (regardless of the iconBoxGeometry specification).
iconBoxTitle (class IconBoxTitle)	Specifies the name that is used in the title area of the icon box frame. The default value is Icons.
iconClick (class IconClick)	Specifies whether the system menu is posted and remains posted when an icon is clicked. The default value is True.
iconDecoration (class IconDecoration)	Specifies the general icon decoration. The resource value is label (only the label part is displayed) or image (only the image part is displayed) or label image (both the label and image parts are displayed). A value of activelabel can also be specified to get a label (not truncated to the width of the icon) when the icon is selected. The default icon decoration for icon box icons is that each icon has a label part and an image part (label image). The default icon decoration for standalone icons is that each icon has an active label part, a label part, and an image part (activelabel, label, and image).
iconImageMaximum (class IconImageMaximum)	Specifies the maximum size of the icon image. The resource value is Width x Height (for example, 64x64). The maximum supported size is 128x128. The default value of this resource is 50x50.
iconImageMinimum (class IconImageMinimum)	Specifies the minimum size of the icon image. The resource value is Width x Height (for example, 32x50). The minimum supported size is 16x16. The default value of this resource is 16x16.
iconPlacement (class IconPlacement)	Specifies the icon placement scheme to be used. The resource value has the following syntax: PrimaryLayout SecondaryLayout [Tight] The layout values are described as one of the following:
	top Lays out the icons from top to bottom. bottom Lays out the icons from bottom to top. left Lays out the icons from left to right. right Lays out the icons from right to left.
	A horizontal (vertical) layout value must not be used for both the PrimaryLayout and the SecondaryLayout (for example, do not use top for the PrimaryLayout and bottom for the SecondaryLayout). The PrimaryLayout indicates at the time an icon placement is done whether the icon is placed in a row or a column and the direction of placement. The SecondaryLayout indicates where to place new rows or columns.
	For example, the top right value 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 the left bottom value (icons are placed from left to right on the screen, with the first row on the bottom of the screen, and new rows added from the bottom of the screen to the top of the screen). A tight value places icons with zero spacing between icons. This value is useful for aesthetic reasons, as well as for terminals with small screens.
	Following is a list of options for iconPlacement values:
	Icon Placement Appropriate Scheme From left to right across the top of the screen, new rows below Left top From right to left across the top of the screen, new rows below Right top From left to right across the bottom of the screen, new rows above Left bottom From right to left across the bottom of the screen, new rows above Right bottom From bottom to top along the left of the screen, new columns to right Bottom left From bottom to top along the right of the screen, new columns to left Bottom right From top to bottom along the left of the screen, new columns to right Top left From top to bottom along the right of the screen, new columns to left Top right
iconPlacementMargin (class IconPlacementMargin)	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 is used if the value specified is invalid. The default value for this resource is equal to the space between icons as they are placed on the screen (this space is based on maximizing the number of icons in each row and column).
interactivePlacement (class InteractivePlacement)	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 needs to be selected for the upper-left 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.
keyBindings (class KeyBindings)	Identifies the set of key bindings for window management functions. If specified, these key bindings replace the built-in default bindings. The named set of key bindings is specified in mwm resource description file. The default value for this resource is DefaultKeyBindings.
keyboardFocusPolicy (class KeyboardFocusPolicy)	Determines the keyboard focus policy. If set to the pointer value, the keyboard focus policy has the keyboard focus set to the client window that contains the pointer (the pointer could also be in the client window decoration that the mwm command adds). If set to the explicit value, the policy is to have the keyboard focus set to a client window when the user presses the left mouse button with the pointer on the client window or any part of the associated mwm decoration. The default value for this resource is explicit.
limitResize (class LimitResize)	Determines whether the user is allowed to resize a window to greater than the maximum size. 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.
lowerOnIconify (class LowerOnIconify)	Determines whether a window icon is displayed on the bottom of the window stack when the window is iconified (minimized). 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.
maximumMaximumSize (class MaximumMaximumSize)	Limits the maximum size of a client window as set by the user or client. The resource value is Width x Height (for example, 1024x1024) where the width and height are in pixels. The default value of this resource is twice the screen width and height.
moveOpaque (class MoveOpaque)	Controls whether the actual window is moved or a rectangular outline of the window is moved. A default value of False displays a rectangular outline on move operations.
moveThreshold (class MoveThreshold)	Controls 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 used to prevent window and icon movement when you click or double-click and there is unintentional pointer movement with the button down. The default value of this resource is 4 (pixels).
multiScreen (class MultiScreen)	Determines whether the mwm command manages all the screens on the display. If False, the mwm command manages only a single screen. The default value is False.
passButtons (class PassButtons)	Indicates whether 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 window manager function is done in either case. The default value for this resource is False.
passSelectButton (class PassSelectButton)	Indicates whether 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, the button press is not passed to the client. If the value is True, the button press is passed to the client window. The window manager function is done in either case. The default value for this resource is True.
positionIsFrame (class PositionIsFrame)	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.
positionOnScreen (class PositionOnScreen)	Indicates 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.
quitTimeout (class QuitTimeout)	Specifies the amount of time in milliseconds that the mwm command waits for a client to update the WM_COMMAND property after the mwm command has sent the WM_SAVE_YOURSELF message. This protocol is used only for those clients that have a WM_SAVE_YOURSELF atom and no WM_DELETE_WINDOW atom in the WM_PROTOCOLS client window property. The default value of this resource is 1000 (milliseconds). See the f.kill function for additional information.
raiseKeyFocus (class RaiseKeyFocus)	Specifies whether a window raised by means of the f.normalize_and_raise function also receives the input focus. The default value of this resource is False. This resource is available only when the keyboard input focus policy is set to the explicit value.
resizeBorderWidth (class ResizeBorderWidth)	Specifies the width (in pixels) of a client window frame border with resize handles. The specified border width includes the 3-D shadows. The default value is based on the size and resolution of the screen.
resizeCursors (class ResizeCursors)	Indicates 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.
screens (class Screens)	Specifies the resource names to use for the screens managed by the mwm command. If the mwm command is managing a single screen, only the first name in the list is used. If the mwm command is managing multiple screens, the names are assigned to the screens in order, starting with screen 0. For example, screen 0 gets the first name and screen 1 gets the second name. Examples of default screen names are 0 and 1.
showFeedback (class ShowFeedback)	Controls when feedback information is displayed. It controls both window position and size feedback during move or resize operations and initial client placement. It also controls window manager message and dialog boxes. The value for this resource is a list of names of the feedback options to be enabled 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 sign of the first item in the list determines the initial set of options. If the sign of the first option is - (a minus sign), the mwm command assumes all options are present and starts subtracting from that set. If the sign of the first decoration is + (a plus sign) or is not specified, the mwm command starts with no options and builds up a list from the resource. The names of the feedback options are as follows: all Shows all feedback (default value). behavior Confirms the behavior switch. kill Confirms on receipt of the KILL signal. move Shows position during the move. none Shows no feedback. placement Shows position and size during initial placement. quit Confirms quitting MWM. resize Shows size during resize. restart Confirms MWM restart. The following command line illustrates the syntax for the showFeedback resource: Mwm*showFeedback: placement resize behavior restart This resource specification provides feedback for initial client placement and resize, and it 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 the all value.
startupKeyFocus (class StartupKeyFocus)	Determines whether a window gets the keyboard input focus when the window is mapped (that is, initially managed by the window manager). It is recommended that both the autoKeyFocus resource and the startupKeyFocus resource be set to a value of True to work with tear-off menus. The default value is True. This resource is available only when the keyboard input focus policy is set to the explicit value.
transientDecoration (class TransientDecoration)	Controls the amount of decoration that Mwm puts on transient windows. The decoration specification is exactly the same as for the clientDecoration (client-specific) resource. Transient windows are identified by the WM_TRANSIENT_FOR property, which is added by the client to indicate a relatively temporary window. The default value for this resource is the menu title value (that is, transient windows have resize borders and a title bar with a window menu button). An application can also specify which decorations the window manager should apply to its windows. If it does so, the window manager applies only those decorations indicated by both the application and the transientDecoration resource. Otherwise, the window manager applies only the decorations indicated by the transientDecoration resource.
transientFunctions (class TransientFunctions)	Indicates which window management functions are applicable (or not applicable) to transient windows. The function specification is exactly the same as for the clientFunctions (client-specific) resource. The default value for this resource is -minimize -maximize. An application can also specify which functions the window manager should apply to its windows. If it does so, the window manager applies only those functions indicated by both the application and the transientFunctions resource. Otherwise, the window manager applies only the functions indicated by the transientFunctions resource.
useIconBox (class UseIconBox)	Determines whether icons are placed in an icon box. 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).
wMenuButtonClick (class WMenuButtonClick)	Indicates whether the window menu is posted and remains posted after a click of the mouse when the pointer is over the Window Menu button. If the value given this resource is True, the menu remains posted. True is the default value for this resource.
wMenuButtonClick2 (class WMenuButtonClick2)	Indicates whether a double-click action on the Window Menu button performs an f.kill function. When this resource is given the default value of True, a double-click action on the Window Menu button performs an f.kill function.

Client-Specific Resources

The syntax for specifying client-specific resources is as follows:

Mwm*ClientNameOrClass*ResourceID

For example, Mwm*mterm*windowMenu is used to specify the window menu to be used with mterm clients.

The syntax for specifying client-specific resources for all classes of clients is as follows:

Mwm*ResourceID

Specific client specifications take precedence over the specifications for all clients. For example, Mwm*windowMenu is used to specify the window menu to be used for all classes of clients that do not 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 as follows:

Mwm*defaults*ResourceID

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

Client-Specific Resource Set

Note

Hyphens in the following table are for readability purposes only. Do not include hyphens within names in programs.

Name	Class	Value Type	Default
clientDecoration	ClientDecoration	all
clientFunctions	ClientFunctions	string	all
focusAutoRaise	FocusAutoRaise	True or False	varies
iconImage	IconImage	pathname	(image)
iconImageBackground	Background	color	icon background
iconImageBottomShadowColor	Foreground	color	icon bottom shadow
iconImageBottomShadowPixmap	BottomShadowPixmap	color	icon bottom shadow pixmap
iconImageForeground	Foreground	color	varies
iconImageTopShadowColor	Background	color	icon top shadow color
iconImageTopShadoPixmap	TopShadowPixmap	color	icon top shadow pixmap
matteBackground	Background	color	background
matteBottomShadowColor	Foreground	color	bottom shadow color
matteBottomShadowPixmap	BottomShadowPixmap	color	bottom shadow pixmap
matteForeground	Foreground	color	foreground
matteTopShadowColor	Background	color	top shadow color
matteTopShadowPixmap	TopShadowPixmap	color	top shadow pixmap
matteWidth	MatteWidth	pixels	0
maximumClientSize	MaximumClientSize	wxh, vertical, horizontal	fill the screen
useClientIcon	UseClientIcon	True or False	F
usePPosition	UsePPosition	string	nonzero
windowMenu	WindowMenu	string	DefaultWindowMenu

clientDecoration (class ClientDecoration)	Controls the amount of window frame decoration. The resource is specified as a list of decorations to specify their inclusion in the frame. If a decoration is preceded by - (a minus sign), that decoration is excluded from the frame. The sign of the first item in the list determines the initial amount of decoration. If the sign of the first decoration is a minus sign, the mwm command assumes all decorations are present and starts subtracting from that set. If the sign of the first decoration is plus (or not specified), the mwm command starts with no decoration and builds up a list from the resource. An application can also specify which decorations the mwm command should apply to its windows. If it does so, the mwm command applies only those decorations indicated by both the application and the clientDecoration resource. Otherwise, the mwm command applies the decorations indicated by the clientDecoration resource. Following is a list of window frame decorations: all Specifies to include all decorations (default value). border Specifies the window border. maximize Specifies the Maximize button (includes title bar). minimize Specifies the Minimize button (includes title bar). none Specifies no decorations. resizeh Specifies the border resize handles (includes border). menu Specifies the Window Menu button (includes title bar). title Specifies the title bar (includes border). Following are examples of window frame decoration commands: MwmXClock.clientDecoration: -resizeh -maximize This removes the resize handles and Maximize button from XClock windows. MwmXClock.clientDecoration: menu minimize border This removes the resize handles and Maximize button from XClock windows. Note that either `menu` or `minimize` implies title.
clientFunctions (class ClientFunctions)	Indicates which mwm functions are applicable (or not applicable) to the client window. The value for the resource is a list of functions. If the first function in the list has - (a minus sign) in front of it, the mwm command starts with all functions and subtracts from that set. If the first function in the list has a + (plus sign) in front of it, the mwm command 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 the mwm command should apply to its windows. If it does so, the mwm command applies only those functions indicated by both the application and the clientFunctions resource. Otherwise, the mwm command applies the functions indicated by the clientFunctions resource. Following is a list of functions available for this resource: all Specifies to include all functions (default value). none Specifies no functions. resize Specifies f.resize. move Specifies f.move. minimize Specifies f.minimize. maximize Specifies f.maximize. close Specifies f.kill.
focusAutoRaise (class FocusAutoRaise)	Determines whether 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 the explicit value and False when the keyboardFocusPolicy is the pointer value.
iconImage (class IconImage)	Specifies an icon image for a client (for example, MwmmyclockiconImage). The resource value is a path name for a bitmap file. The value of the (client-specific) useClientIcon resource is used to determine whether 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.
iconImageBackground (class Background)	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 Mwmbackground or Mwmicon*background).
iconImageBottomShadowColor (class Foreground)	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 MwmiconbottomShadowColor).
iconImageBottomShadowPixmap (class BottomShadowPixmap)	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 MwmiconbottomShadowPixmap).
iconImageForeground (class Foreground)	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.
iconImageTopShadowColor (class Background)	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 MwmicontopShadowColor).
iconImageTopShadowPixmap (class TopShadowPixmap)	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 MwmicontopShadowPixmap).
matteBackground (class Background)	Specifies the background color of the matte when the matteWidth resource is a positive value. The default value of this resource is the client background color (that is, specified by Mwmbackground or Mwmclient*background).
matteBottomShadowColor (class Foreground)	Specifies the bottom shadow color of the matte when the matteWidth resource is a positive value. The default value of this resource is the client bottom shadow color (that is, specified by MwmbottomShadowColor or Mwmclient*bottomShadowColor).
matteBottomShadowPixmap (class BottomShadowPixmap)	Specifies the bottom shadow pixmap of the matte when the matteWidth resource is a positive value. The default value of this resource is the client bottom shadow pixmap (that is, specified by MwmbottomShadowPixmap or Mwmclient*bottomShadowPixmap).
matteForeground (class Foreground)	Specifies the foreground color o