| 1 |
'\" t |
| 2 |
...\" mwm.sgm /main/13 1996/09/25 11:30:27 cdedoc $ |
| 3 |
.de P! |
| 4 |
.fl |
| 5 |
\!!1 setgray |
| 6 |
.fl |
| 7 |
\\&.\" |
| 8 |
.fl |
| 9 |
\!!0 setgray |
| 10 |
.fl \" force out current output buffer |
| 11 |
\!!save /psv exch def currentpoint translate 0 0 moveto |
| 12 |
\!!/showpage{}def |
| 13 |
.fl \" prolog |
| 14 |
.sy sed -e 's/^/!/' \\$1\" bring in postscript file |
| 15 |
\!!psv restore |
| 16 |
. |
| 17 |
.de pF |
| 18 |
.ie \\*(f1 .ds f1 \\n(.f |
| 19 |
.el .ie \\*(f2 .ds f2 \\n(.f |
| 20 |
.el .ie \\*(f3 .ds f3 \\n(.f |
| 21 |
.el .ie \\*(f4 .ds f4 \\n(.f |
| 22 |
.el .tm ? font overflow |
| 23 |
.ft \\$1 |
| 24 |
.. |
| 25 |
.de fP |
| 26 |
.ie !\\*(f4 \{\ |
| 27 |
. ft \\*(f4 |
| 28 |
. ds f4\" |
| 29 |
' br \} |
| 30 |
.el .ie !\\*(f3 \{\ |
| 31 |
. ft \\*(f3 |
| 32 |
. ds f3\" |
| 33 |
' br \} |
| 34 |
.el .ie !\\*(f2 \{\ |
| 35 |
. ft \\*(f2 |
| 36 |
. ds f2\" |
| 37 |
' br \} |
| 38 |
.el .ie !\\*(f1 \{\ |
| 39 |
. ft \\*(f1 |
| 40 |
. ds f1\" |
| 41 |
' br \} |
| 42 |
.el .tm ? font underflow |
| 43 |
.. |
| 44 |
.ds f1\" |
| 45 |
.ds f2\" |
| 46 |
.ds f3\" |
| 47 |
.ds f4\" |
| 48 |
.ta 8n 16n 24n 32n 40n 48n 56n 64n 72n |
| 49 |
.TH "mwm" "user cmd" |
| 50 |
.SH "NAME" |
| 51 |
\fBmwm\fP \(em The Motif |
| 52 |
Window Manager |
| 53 |
.SH "SYNOPSIS" |
| 54 |
.PP |
| 55 |
\fBmwm\fP [\fIoptions\fP] |
| 56 |
.SH "DESCRIPTION" |
| 57 |
.PP |
| 58 |
The \fBmwm\fP window manager provides |
| 59 |
functions that facilitate control (by the user and the programmer) |
| 60 |
of elements of window state such as placement, size, icon/normal display, |
| 61 |
and input-focus ownership\&. |
| 62 |
.PP |
| 63 |
The stand-alone window manager is not an integral part |
| 64 |
of CDE and does not support communication with other components in the CDE |
| 65 |
environment, such as the Style Manager and the Session Manager\&. |
| 66 |
.SS "Options" |
| 67 |
.IP "\fI-display\fP\ \fBdisplay\fP" 10 |
| 68 |
This option specifies the display to use; see \fBX\fP(1)\&. |
| 69 |
.IP "\fI-xrm\fP\ \fBresourcestring\fP" 10 |
| 70 |
This option specifies a resource string to use\&. |
| 71 |
.IP "\fI-multiscreen\fP" 10 |
| 72 |
This option causes \fBmwm\fP to manage all screens on |
| 73 |
the display\&. The default is to manage only a single screen. |
| 74 |
.IP "\fI-name\fP\ \fBname\fP" 10 |
| 75 |
This option causes \fBmwm\fP to retrieve its resources |
| 76 |
using the specified name, as in \fBname*resource\fP\&. |
| 77 |
.IP "\fI-screens\fP\ \fBname\ [name\ [\&.\&.\&.]]\fP" 10 |
| 78 |
This option specifies the resource names to use for the screens managed |
| 79 |
by \fBmwm\fP\&. If \fBmwm\fP is managing a single |
| 80 |
screen, only the first name in the list is used\&. If \fBmwm\fP |
| 81 |
is managing multiple screens, the names are assigned to the screens in order, |
| 82 |
starting with screen 0\&. Screen 0 gets the first name, screen 1 the second |
| 83 |
name, and so on\&. |
| 84 |
.SS "Appearance" |
| 85 |
.PP |
| 86 |
The following sections describe the basic default behaviors of windows, |
| 87 |
icons, the icon box, input focus, and window stacking\&. The appearance and |
| 88 |
behavior of the window manager can be altered by changing the configuration |
| 89 |
of specific resources\&. Resources are defined under the heading "X DEFAULTS\&." |
| 90 |
.SS "Screens" |
| 91 |
.PP |
| 92 |
By default, \fBmwm\fP manages only the single screen specified |
| 93 |
by the \fI-display\fP option or the \fBDISPLAY\fP environment variable (by default, screen 0)\&. If the \fI-multiscreen\fP option is specified or if the \fImultiScreen\fP resource is True, \fBmwm\fP tries to manage all |
| 94 |
the screens on the display\&. |
| 95 |
.PP |
| 96 |
When \fBmwm\fP is managing multiple screens, the \fI-screens\fP option can be used to give each screen a unique |
| 97 |
resource name\&. The names are separated by blanks, for example, \fI-screens\fP scr0 scr1\&. If there are more screens than names, |
| 98 |
resources for the remaining screens will be retrieved using the first name\&. |
| 99 |
By default, the screen number is used for the screen name\&. |
| 100 |
.SS "Windows" |
| 101 |
.PP |
| 102 |
Default \fBmwm\fP window frames have distinct components |
| 103 |
with associated functions: |
| 104 |
.IP "\fITitle\ Area\fP" 10 |
| 105 |
In addition to displaying the client\&'s title, the title area is used |
| 106 |
to move the window\&. To move the window, place the pointer over the title area, |
| 107 |
press button 1 and drag the window to a new location\&. By default, a wire |
| 108 |
frame is moved during the drag to indicate the new location\&. When the button |
| 109 |
is released, the window is moved to the new location\&. |
| 110 |
.IP "\fITitle\ Bar\fP" 10 |
| 111 |
The title bar includes the title area, the minimize button, the maximize |
| 112 |
button, and the window menu button\&. In shaped windows, such as round windows, |
| 113 |
the title bar floats above the window\&. |
| 114 |
.IP "\fIMinimize\ Button\fP" 10 |
| 115 |
To turn the window into an icon, click button 1 on the minimize button |
| 116 |
(the frame box with a \fBsmall\fP square in it)\&. |
| 117 |
.IP "\fIMaximize\ Button\fP" 10 |
| 118 |
To make the window fill the screen (or enlarge to the largest size allowed |
| 119 |
by the configuration files), click button 1 on the maximize button (the frame |
| 120 |
box with a \fBlarge\fP square in it)\&. |
| 121 |
.IP "\fIWindow\ Menu\ Button\fP" 10 |
| 122 |
The window menu button is the frame box with a horizontal bar in it\&. |
| 123 |
To pull down the window menu, press button 1\&. While pressing, drag the pointer |
| 124 |
on the menu to your selection, then release the button when your selection |
| 125 |
is highlighted\&. Pressing button 3 in the title bar or resize border handles |
| 126 |
also posts the window menu\&. Alternately, you can click button 1 to pull down |
| 127 |
the menu and keep it posted; then position the pointer and select\&. You can |
| 128 |
also post the window menu by pressing <Shift> <Esc> or <Alt> <Space>\&. |
| 129 |
Double-clicking button 1 with the pointer on the window menu button closes |
| 130 |
the window\&. |
| 131 |
.PP |
| 132 |
The following table lists the contents of the window menu\&. |
| 133 |
.SS "Default Window Menu" |
| 134 |
.TS |
| 135 |
tab(); |
| 136 |
lw(1.803823i) lw(1.062374i) lw(2.633803i). |
| 137 |
SelectionAcceleratorDescription |
| 138 |
RestoreT{ |
| 139 |
Restores the window to its size before minimizing |
| 140 |
or maximizing\&. |
| 141 |
T} |
| 142 |
MoveT{ |
| 143 |
Allows the window to be moved with keys or |
| 144 |
mouse\&. |
| 145 |
T} |
| 146 |
SizeAllows the window to be resized\&. |
| 147 |
MinimizeTurns the window into an icon\&. |
| 148 |
MaximizeMakes the window fill the screen\&. |
| 149 |
LowerT{ |
| 150 |
Moves window to bottom of window stack\&. |
| 151 |
T} |
| 152 |
CloseAlt+F4Causes client to terminate\&. |
| 153 |
.TE |
| 154 |
.IP "\fIResize\ Border\ Handles\fP" 10 |
| 155 |
To change the size of a window, move the pointer over a resize border |
| 156 |
handle (the cursor changes), press button 1, and drag the window to a new |
| 157 |
size\&. When the button is released, the window is resized\&. While dragging is |
| 158 |
being done, a rubber-band outline is displayed to indicate the new window |
| 159 |
size\&. |
| 160 |
.IP "\fIMatte\fP" 10 |
| 161 |
An optional matte decoration can be added between the client area and |
| 162 |
the window frame (see the \fImatteWidth\fP resource)\&. A |
| 163 |
\fImatte\fP is not actually part of the window frame\&. |
| 164 |
There is no functionality associated with a matte\&. |
| 165 |
.SS "Icons" |
| 166 |
.PP |
| 167 |
Icons are small graphic representations of windows\&. A window can be |
| 168 |
minimized (iconified) using the minimize button on the window frame\&. Icons |
| 169 |
provide a way to reduce clutter on the screen\&. |
| 170 |
.PP |
| 171 |
Pressing mouse button 1 when the pointer is over an icon causes the |
| 172 |
icon\&'s window menu to pop up\&. Releasing the button (press + release without |
| 173 |
moving mouse = click) causes the menu to stay posted\&. The menu contains the |
| 174 |
following selections: |
| 175 |
.SS "Icon Window Menu" |
| 176 |
.TS |
| 177 |
tab(); |
| 178 |
lw(0.913000i) lw(1.144000i) lw(3.443000i). |
| 179 |
SelectionAcceleratorDescription |
| 180 |
RestoreOpens the associated window\&. |
| 181 |
MoveT{ |
| 182 |
Allows the icon to be moved with keys\&. |
| 183 |
T} |
| 184 |
SizeInactive (not an option for icons)\&. |
| 185 |
MinimizeInactive (not an option for icons)\&. |
| 186 |
MaximizeT{ |
| 187 |
Opens the associated window and makes it |
| 188 |
fill the screen\&. |
| 189 |
T} |
| 190 |
LowerMoves icon to bottom of icon stack\&. |
| 191 |
CloseAlt+F4T{ |
| 192 |
Removes client from \fBmwm\fP |
| 193 |
management\&. |
| 194 |
T} |
| 195 |
.TE |
| 196 |
.PP |
| 197 |
Note that pressing button 3 over an icon also causes the icon\&'s window |
| 198 |
menu to pop up\&. To make a menu selection, drag the pointer over the menu and |
| 199 |
release button 3 when the desired item is highlighted\&. |
| 200 |
.PP |
| 201 |
Double-clicking button 1 on an icon invokes the \fBf\&.restore_and_raise\fP function and restores the icon\&'s associated window to its previous |
| 202 |
state\&. For example, if a maximized window is iconified, double-clicking button |
| 203 |
1 restores it to its maximized state\&. Double-clicking button 1 on the icon |
| 204 |
box\&'s icon opens the icon box and allows access to the contained icons\&. (In |
| 205 |
general, double-clicking a mouse button is a quick way to perform a function\&.) |
| 206 |
Pressing <Shift> <Esc> or <Menu> (the pop-up menu key) causes the |
| 207 |
icon window menu of the currently selected icon to pop up\&. |
| 208 |
.SS "Icon Box" |
| 209 |
.PP |
| 210 |
When icons begin to clutter the screen, they can be packed into an icon |
| 211 |
box\&. (To use an icon box, \fBmwm\fP must be started with the |
| 212 |
icon box configuration already set\&.) The icon box is a \fBmwm\fP |
| 213 |
window that holds client icons\&. It includes one or more scroll bars when there |
| 214 |
are more window icons than the icon box can show at the same time\&. |
| 215 |
.PP |
| 216 |
Icons in the icon box can be manipulated with the mouse\&. The following |
| 217 |
table summarizes the behavior of this interface\&. Button actions apply whenever |
| 218 |
the pointer is on any part of the icon\&. Note that double-clicking an icon |
| 219 |
in the icon box invokes the \fBf\&.restore_and_raise\fP function\&. |
| 220 |
.TS |
| 221 |
tab(); |
| 222 |
lw(0.841046i) lw(1.051308i) lw(3.607646i). |
| 223 |
ButtonActionDescription |
| 224 |
Button 1clickSelects the icon\&. |
| 225 |
Button 1double-clickT{ |
| 226 |
Normalizes (opens) the associated window\&. |
| 227 |
Raises an already open window to the top of the stack\&. |
| 228 |
T} |
| 229 |
Button 1dragMoves the icon\&. |
| 230 |
Button 3pressT{ |
| 231 |
Causes the menu for that icon to pop up\&. |
| 232 |
T} |
| 233 |
Button 3dragT{ |
| 234 |
Highlights items as the pointer moves across |
| 235 |
the menu\&. |
| 236 |
T} |
| 237 |
.TE |
| 238 |
.PP |
| 239 |
Pressing mouse button 3 when the pointer is over an icon causes the |
| 240 |
menu for that icon to pop up\&. |
| 241 |
.SS "Icon Menu for the Icon Box" |
| 242 |
.TS |
| 243 |
tab(); |
| 244 |
lw(0.885312i) lw(1.062374i) lw(3.552314i). |
| 245 |
SelectionAcceleratorDescription |
| 246 |
RestoreT{ |
| 247 |
Opens the associated window (if not already |
| 248 |
open)\&. |
| 249 |
T} |
| 250 |
MoveT{ |
| 251 |
Allows the icon to be moved with keys\&. |
| 252 |
T} |
| 253 |
SizeInactive\&. |
| 254 |
MinimizeInactive\&. |
| 255 |
MaximizeT{ |
| 256 |
Opens the associated window (if not already |
| 257 |
open) and maximizes its size\&. |
| 258 |
T} |
| 259 |
LowerInactive\&. |
| 260 |
CloseAlt+F4T{ |
| 261 |
Removes client from \fBmwm\fP |
| 262 |
management\&. |
| 263 |
T} |
| 264 |
.TE |
| 265 |
.PP |
| 266 |
To pull down the window menu for the icon box itself, press button 1 |
| 267 |
with the pointer over the menu button for the icon box\&. The window menu of |
| 268 |
the icon box differs from the window menu of a client window: The "Close" |
| 269 |
selection is replaced with the "PackIcons Shift+Alt+F7" selection\&. When selected, |
| 270 |
PackIcons packs the icons in the box to achieve neat rows with no empty slots\&. |
| 271 |
.PP |
| 272 |
You can also post the window menu by pressing <Shift>, <Esc> or |
| 273 |
<Alt> <Space>\&. Pressing <Menu> (the pop-up menu key) causes the icon |
| 274 |
window menu of the currently selected icon to pop up\&. |
| 275 |
.SS "Input Focus" |
| 276 |
.PP |
| 277 |
The \fBmwm\fP window manager supports (by default) a keyboard |
| 278 |
input focus policy of explicit selection\&. This means when a window is selected |
| 279 |
to get keyboard input, it continues to get keyboard input until the window |
| 280 |
is withdrawn from window management, another window is explicitly selected |
| 281 |
to get keyboard input, or the window is iconified\&. Several resources control |
| 282 |
the input focus\&. The client window with the keyboard input focus has the active |
| 283 |
window appearance with a visually distinct window frame\&. |
| 284 |
.PP |
| 285 |
The following tables summarize the keyboard input focus selection behavior: |
| 286 |
.TS |
| 287 |
tab(); |
| 288 |
lw(0.880482i) lw(0.844298i) lw(1.350877i) lw(2.424342i). |
| 289 |
ButtonActionObjectFunction Description |
| 290 |
Button 1pressWindow / window frameKeyboard focus selection\&. |
| 291 |
Button 1pressIconKeyboard focus selection\&. |
| 292 |
.TE |
| 293 |
.TS |
| 294 |
tab(); |
| 295 |
lw(1.394366i) lw(4.105634i). |
| 296 |
Key ActionFunction Description |
| 297 |
[Alt][Tab]T{ |
| 298 |
Move input focus to next window in window |
| 299 |
stack (available only in explicit focus mode)\&. |
| 300 |
T} |
| 301 |
[Alt][Shift][Tab]T{ |
| 302 |
Move input focus to previous window in window |
| 303 |
stack (available only in explicit focus mode)\&. |
| 304 |
T} |
| 305 |
.TE |
| 306 |
.SS "Window Stacking" |
| 307 |
.PP |
| 308 |
There are two types of window stacks: global window stacks and an application\&'s |
| 309 |
local family window stack\&. |
| 310 |
.PP |
| 311 |
The global stacking order of windows may be changed as a result of setting |
| 312 |
the keyboard input focus, iconifying a window, or performing a window manager |
| 313 |
window stacking function\&. When keyboard focus policy is explicit the default |
| 314 |
value of the \fIfocusAutoRaise\fP resource is True\&. This causes |
| 315 |
a window to be raised to the top of the stack when it receives input focus, |
| 316 |
for example, by pressing button 1 on the title bar\&. The key actions defined |
| 317 |
in the previous table will thus raise the window receiving focus to the top |
| 318 |
of the stack\&. |
| 319 |
.PP |
| 320 |
In pointer mode, the default value of \fIfocusAutoRaise\fP |
| 321 |
is False, that is, the window stacking order is not changed when a window |
| 322 |
receives keyboard input focus\&. The following key actions can be used to cycle |
| 323 |
through the global window stack\&. |
| 324 |
.TS |
| 325 |
tab(); |
| 326 |
lw(1.567982i) lw(3.932018i). |
| 327 |
Key ActionFunction Description |
| 328 |
[Alt][ESC]T{ |
| 329 |
Place top window on bottom of stack\&. |
| 330 |
T} |
| 331 |
[Alt][Shift][ESC]T{ |
| 332 |
Place bottom window on top of stack\&. |
| 333 |
T} |
| 334 |
.TE |
| 335 |
.PP |
| 336 |
By default, a window\&'s icon is placed on the bottom of the stack when |
| 337 |
the window is iconified; however, the default can be changed by the \fIlowerOnIconify\fP resource\&. |
| 338 |
.PP |
| 339 |
Transient windows (secondary windows such a dialog boxes) stay above |
| 340 |
their parent windows by default; however, an application\&'s local family stacking |
| 341 |
order may be changed to allow a transient window to be placed below its parent |
| 342 |
top-level window\&. The following arguments show the modification of the stacking |
| 343 |
order for the \fBf\&.lower\fP function\&. |
| 344 |
.IP "\fBf\&.lower\fP" 10 |
| 345 |
Lowers the transient window within the family (staying above the parent) |
| 346 |
and lowers the family in the global window stack\&. |
| 347 |
.IP "\fBf\&.lower\fP\ [ \fIwithin\fP]" 10 |
| 348 |
Lowers the transient window within the family (staying above the parent) |
| 349 |
but does not lower the family in the global window stack\&. |
| 350 |
.IP "\fBf\&.lower\fP\ [\fIfreeFamily\fP ]" 10 |
| 351 |
Lowers the window free from its family stack (below the parent), but |
| 352 |
does not lower the family in the global window stack\&. |
| 353 |
.PP |
| 354 |
The arguments \fIwithin\fP and \fIfreeFamily\fP can also be used with \fBf\&.raise\fP |
| 355 |
and \fBf\&.raise_lower\fP\&. |
| 356 |
.SS "Session Management" |
| 357 |
.PP |
| 358 |
The window manager is an X Session Management Protocol aware client\&. It responds to SaveYourself |
| 359 |
(and other associated messages) by saving the geometries of its clients to a state file\&. |
| 360 |
\fBmwm\fP can then be restarted by the XSMP session manager\&. |
| 361 |
The default location for the state file is \fB$HOME/\&.mwmclientdb\fP\&. |
| 362 |
This location can be overriden with the resource \fBsessionClientDB\fP\&. |
| 363 |
.SS "X Resources" |
| 364 |
.PP |
| 365 |
The \fBmwm\fP command is configured from its resource |
| 366 |
database\&. This database is built from the following sources\&. They are listed |
| 367 |
in order of precedence, low to high: |
| 368 |
.PP |
| 369 |
\fB/usr/X11R6/lib/X11/app-defaults/Mwm\fP |
| 370 |
.PP |
| 371 |
\fB$HOME/Mwm\fP |
| 372 |
.PP |
| 373 |
\fBRESOURCE_MANAGER\fP root window property or \fB$HOME/\&.Xdefaults\fP |
| 374 |
.PP |
| 375 |
\fBXENVIRONMENT\fP variable or \fB$HOME/\&.Xdefaults-host\fP |
| 376 |
.PP |
| 377 |
\fBmwm\fP command line options |
| 378 |
.PP |
| 379 |
The file names \fB/usr/X11R6/lib/X11/app-defaults/Mwm\fP and \fB$HOME/Mwm\fP represent customary locations for these files\&. The actual |
| 380 |
location of the system-wide class resource file may depend on the \fBXFILESEARCHPATH\fP environment variable and the |
| 381 |
current language environment\&. The actual location of the user-specific class |
| 382 |
resource file may depend on the \fBXUSERFILESEARCHPATH\fP and \fBXAPPLRESDIR\fP |
| 383 |
environment variables and the current language environment\&. |
| 384 |
.PP |
| 385 |
Entries in the resource database may refer to other resource files for |
| 386 |
specific types of resources\&. These include files that contain bitmaps, fonts, |
| 387 |
and \fBmwm\fP specific resources such as menus and behavior |
| 388 |
specifications (for example, button and key bindings)\&. |
| 389 |
.PP |
| 390 |
\fIMwm\fP is the resource class name of \fBmwm\fP and \fBmwm\fP is the default resource name used by \fBmwm\fP to look up resources\&. the \fI-screens\fP |
| 391 |
command line option specifies resource names, such as "mwm_b+w" and "mwm_color"\&.) |
| 392 |
In the following discussion of resource specification, "Mwm" and "mwm" (and |
| 393 |
the aliased \fBmwm\fP resource names) can be used interchangeably, |
| 394 |
but "mwm" takes precedence over "Mwm"\&. |
| 395 |
.PP |
| 396 |
The \fBmwm\fP command uses the following types of resources: |
| 397 |
.IP "\fBComponent Appearance Resources:\fP" 10 |
| 398 |
These resources specify appearance attributes of window manager user |
| 399 |
interface components\&. They can be applied to the appearance of window manager |
| 400 |
menus, feedback windows (for example, the window reconfiguration feedback |
| 401 |
window), client window frames, and icons\&. |
| 402 |
.IP "\fBGeneral Appearance and Behavior Resources:\fP" 10 |
| 403 |
These resources specify \fBmwm\fP appearance and behavior |
| 404 |
(for example, window management policies)\&. They are not set separately for |
| 405 |
different \fBmwm\fP user interface components\&. They apply to |
| 406 |
all screens and workspaces\&. |
| 407 |
.IP "\fBScreen Specific Appearance and Behavior Resources:\fP" 10 |
| 408 |
These resources specify the appearance and behavior of \fBmwm\fP elements that are settable on a per-screen basis\&. |
| 409 |
.IP "\fBClient Specific Resources:\fP" 10 |
| 410 |
These \fBmwm\fP resources can be set for a particular |
| 411 |
client window or class of client windows\&. They specify client-specific icon |
| 412 |
and client window frame appearance and behavior\&. |
| 413 |
.PP |
| 414 |
Resource identifiers can be either a resource name (for example, foreground) |
| 415 |
or a resource class (for example, Foreground)\&. If the value of a resource |
| 416 |
is a filename and if the filename is prefixed by "~/", then it is relative |
| 417 |
to the path contained in the \fBHOME\fP |
| 418 |
environment variable (generally the user\&'s home directory)\&. |
| 419 |
.SS "Component Appearance Resources" |
| 420 |
.PP |
| 421 |
The syntax for specifying component appearance resources that apply |
| 422 |
to window manager icons, menus, and client window frames is \fIMwm*\fP \fBresource_id\fP |
| 423 |
.PP |
| 424 |
For example, \fIMwm*foreground\fP is used to specify |
| 425 |
the foreground color for \fBmwm\fP menus, icons, client window |
| 426 |
frames, and feedback dialogs\&. |
| 427 |
.PP |
| 428 |
The syntax for specifying component appearance resources that apply |
| 429 |
to a particular \fBmwm\fP component is \fIMwm*\fP[\fImenu\fP|\fIicon\fP|\fIclient\fP|\fIfeedback\fP] \fI*\fP\fBresource_id\fP |
| 430 |
.PP |
| 431 |
If \fBmenu\fP is specified, the resource is applied only |
| 432 |
to \fBmwm\fP menus; if \fBicon\fP is specified, |
| 433 |
the resource is applied to icons; and if \fBclient\fP is specified, |
| 434 |
the resource is applied to client window frames\&. For example, \fIMwm*icon*foreground\fP is used to specify the foreground color for \fBmwm\fP |
| 435 |
icons, \fIMwm*menu*foreground\fP specifies the foreground |
| 436 |
color for \fBmwm\fP menus, and \fIMwm*client*foreground\fP is used to specify the foreground color for \fBmwm\fP |
| 437 |
client window frames\&. |
| 438 |
.PP |
| 439 |
The appearance of the title area of a client window frame (including |
| 440 |
window management buttons) can be separately configured\&. The syntax for configuring |
| 441 |
the title area of a client window frame is \fIMwm*client*title*\fP \fBresource_id\fP |
| 442 |
.PP |
| 443 |
For example, \fIMwm*client*title*foreground\fP specifies |
| 444 |
the foreground color for the title area\&. Defaults for title area resources |
| 445 |
are based on the values of the corresponding client window frame resources\&. |
| 446 |
.PP |
| 447 |
The appearance of menus can be configured based on the name of the menu\&. |
| 448 |
The syntax for specifying menu appearance by name is \fIMwm*menu*\fP \fBmenu_name\fP\fI*\fP\fBresource_id\fP |
| 449 |
.PP |
| 450 |
For example, \fIMwm*menu*my_menu*foreground\fP specifies |
| 451 |
the foreground color for the menu named \fImy_menu\fP\&. The |
| 452 |
user can also specify resources for window manager menu components, that is, |
| 453 |
the gadgets that comprise the menu\&. These may include for example, a menu |
| 454 |
title, title separator, one or more buttons, and separators\&. If a menu contains |
| 455 |
more than one instance of a class, such as multiple PushButtonGadgets, the |
| 456 |
name of the first instance is "PushButtonGadget1", the second is "PushButtonGadget2", |
| 457 |
and so on\&. The following list identifies the naming convention used for window |
| 458 |
manager menu components: |
| 459 |
.IP " \(bu" 6 |
| 460 |
Menu Title LabelGadget - "TitleName" |
| 461 |
.IP " \(bu" 6 |
| 462 |
Menu Title SeparatorGadget - "TitleSeparator" |
| 463 |
.IP " \(bu" 6 |
| 464 |
CascadeButtonGadget - "CascadeButtonGadget<n>" |
| 465 |
.IP " \(bu" 6 |
| 466 |
PushButtonGadget - "PushButtonGadget<n>" |
| 467 |
.IP " \(bu" 6 |
| 468 |
SeparatorGadget - "SeparatorGadget<n>" |
| 469 |
.PP |
| 470 |
Refer to the man page for each class for a list of resources that can |
| 471 |
be specified\&. |
| 472 |
.PP |
| 473 |
The following component appearance resources that apply to all window |
| 474 |
manager parts can be specified: |
| 475 |
.SS "Component Appearance Resources - All Window Manager Parts" |
| 476 |
.TS |
| 477 |
tab(); |
| 478 |
lw(1.802521i) lw(1.571429i) lw(1.178571i) lw(0.947479i). |
| 479 |
NameClassValue TypeDefault |
| 480 |
backgroundBackgroundcolorvaries\(dg |
| 481 |
backgroundPixmapBackgroundPixmapstring\(dg\(dgvaries\(dg |
| 482 |
bottomShadowColorForegroundcolorvaries\(dg |
| 483 |
bottomShadowPixmapForegroundstring\(dg\(dgvaries\(dg |
| 484 |
fontListFontListT{ |
| 485 |
string\(dg\(dg\(dg |
| 486 |
T}"fixed" |
| 487 |
foregroundForegroundcolorvaries\(dg |
| 488 |
saveUnderSaveUnderT/FF |
| 489 |
topShadowColorBackgroundcolorvaries\(dg |
| 490 |
topShadowPixmapTopShadowPixmapstring\(dg\(dgvaries\(dg |
| 491 |
.TE |
| 492 |
.PP |
| 493 |
\(dgThe default is chosen based on the visual type of the screen\&. |
| 494 |
\(dg\(dgImage name\&. See \fBXmInstallImage\fP(3)\&. \(dg\(dg\(dgX11 |
| 495 |
X Logical Font Description |
| 496 |
.IP "\fIbackground\fP\ (class\ \fIBackground\fP)" 10 |
| 497 |
This resource specifies the background color\&. Any legal X color may |
| 498 |
be specified\&. The default value is chosen based on the visual type of the |
| 499 |
screen\&. |
| 500 |
.IP "\fIbackgroundPixmap\fP\ (class\ \fIBackgroundPixmap\fP)" 10 |
| 501 |
This resource specifies the background Pixmap of the \fBmwm\fP |
| 502 |
decoration when the window is inactive (does not have the keyboard focus)\&. |
| 503 |
The default value is chosen based on the visual type of the screen\&. |
| 504 |
.IP "\fIbottomShadowColor\fP\ (class\ \fIForeground\fP)" 10 |
| 505 |
This resource specifies the bottom shadow color\&. This color is used |
| 506 |
for the lower and right bevels of the window manager decoration\&. Any legal |
| 507 |
X color may be specified\&. The default value is chosen based on the visual |
| 508 |
type of the screen\&. |
| 509 |
.IP "\fIbottomShadowPixmap\fP\ (class\ \fIBottomShadowPixmap\fP)" 10 |
| 510 |
This resource specifies the bottom shadow Pixmap\&. This Pixmap is used |
| 511 |
for the lower and right bevels of the window manager decoration\&. The default |
| 512 |
is chosen based on the visual type of the screen\&. |
| 513 |
.IP "\fIfontList\fP\ (class\ \fIFontList\fP)" 10 |
| 514 |
This resource specifies the font used in the window manager decoration\&. |
| 515 |
The character encoding of the font should match the character encoding of |
| 516 |
the strings that are used\&. The default is "fixed\&." |
| 517 |
.IP "\fIforeground\fP\ (class\ \fIForeground\fP)" 10 |
| 518 |
This resource specifies the foreground color\&. The default is chosen |
| 519 |
based on the visual type of the screen\&. |
| 520 |
.IP "\fIsaveUnder\fP\ (class\ \fISaveUnder\fP)" 10 |
| 521 |
This is used to indicate whether "save unders" are used for \fBmwm\fP components\&. For this to have any effect, save unders must be |
| 522 |
implemented by the X server\&. If save unders are implemented, the X server |
| 523 |
saves the contents of windows obscured by windows that have the save under |
| 524 |
attribute set\&. If the \fIsaveUnder\fP resource is True, \fBmwm\fP will set the save under attribute on the window manager frame |
| 525 |
of any client that has it set\&. If \fIsaveUnder\fP is False, |
| 526 |
save unders will not be used on any window manager frames\&. The default value |
| 527 |
is False\&. |
| 528 |
.IP "\fItopShadowColor\fP\ (class\ \fIBackground\fP)" 10 |
| 529 |
This resource specifies the top shadow color\&. This color is used for |
| 530 |
the upper and left bevels of the window manager decoration\&. The default is |
| 531 |
chosen based on the visual type of the screen\&. |
| 532 |
.IP "topShadowPixmap\ (\ class\ \fITopShadowPixmap)\fP" 10 |
| 533 |
This resource specifies the top shadow Pixmap\&. This Pixmap is used for |
| 534 |
the upper and left bevels of the window manager decoration\&. The default is |
| 535 |
chosen based on the visual type of the screen\&. |
| 536 |
.PP |
| 537 |
The following component appearance resources that apply to frame and |
| 538 |
icons can be specified: |
| 539 |
.SS "Frame and Icon Components" |
| 540 |
.TS |
| 541 |
tab(); |
| 542 |
lw(2.072144i) lw(1.653307i) lw(0.991984i) lw(0.782565i). |
| 543 |
NameClassValue TypeDefault |
| 544 |
activeBackgroundBackgroundcolorvaries\(dg |
| 545 |
activeBackgroundPixmapBackgroundPixmapstring\(dg\(dgvaries\(dg |
| 546 |
activeBottomShadowColorForegroundcolorvaries\(dg |
| 547 |
activeBottomShadowPixmapBottomShadowPixmapstring\(dg\(dgvaries\(dg |
| 548 |
activeForegroundForegroundcolorvaries\(dg |
| 549 |
activeTopShadowColorBackgroundcolorvaries\(dg |
| 550 |
activeTopShadowPixmapTopShadowPixmapstring\(dg\(dgvaries\(dg |
| 551 |
.TE |
| 552 |
.PP |
| 553 |
\(dgThe default is chosen based on the visual type of the screen\&. |
| 554 |
\(dg\(dgSee \fBXmInstallImage\fP(3)\&. |
| 555 |
.IP "\fIactiveBackground\fP\ (class\ \fIBackground\fP)" 10 |
| 556 |
This resource specifies the background color of the \fBmwm\fP |
| 557 |
decoration when the window is active (has the keyboard focus)\&. The default |
| 558 |
is chosen based on the visual type of the screen\&. |
| 559 |
.IP "\fIactiveBackgroundPixmap\fP\ (class\ \fIActiveBackgroundPixmap\fP)" 10 |
| 560 |
This resource specifies the background Pixmap of the \fBmwm\fP |
| 561 |
decoration when the window is active (has the keyboard focus)\&. The default |
| 562 |
is chosen based on the visual type of the screen\&. |
| 563 |
.IP "\fIactiveBottomShadowColor\fP\ (class\ \fIForeground\fP)" 10 |
| 564 |
This resource specifies the bottom shadow color of the \fBmwm\fP decoration when the window is active (has the keyboard focus)\&. |
| 565 |
The default is chosen based on the visual type of the screen\&. |
| 566 |
.IP "\fIactiveBottomShadowPixmap\fP\ (class\ \fIBottomShadowPixmap\fP)" 10 |
| 567 |
This resource specifies the bottom shadow Pixmap of the \fBmwm\fP decoration when the window is active (has the keyboard focus)\&. |
| 568 |
The default is chosen based on the visual type of the screen\&. |
| 569 |
.IP "\fIactiveForeground\fP\ (class\ \fIForeground\fP)" 10 |
| 570 |
This resource specifies the foreground color of the \fBmwm\fP |
| 571 |
decoration when the window is active (has the keyboard focus)\&. The default |
| 572 |
is chosen based on the visual type of the screen\&. |
| 573 |
.IP "\fIactiveTopShadowColor\fP\ (class\ \fIBackground\fP)" 10 |
| 574 |
This resource specifies the top shadow color of the \fBmwm\fP |
| 575 |
decoration when the window is active (has the keyboard focus)\&. The default |
| 576 |
is chosen based on the visual type of the screen\&. |
| 577 |
.IP "\fIactiveTopShadowPixmap\fP\ (class\ \fITopShadowPixmap\fP)" 10 |
| 578 |
This resource specifies the top shadow Pixmap of the \fBmwm\fP |
| 579 |
decoration when the window is active (has the keyboard focus)\&. The default |
| 580 |
is chosen based on the visual type of the screen\&. |
| 581 |
.SS "General Appearance and Behavior Resources" |
| 582 |
.PP |
| 583 |
The syntax for specifying general appearance and behavior resources |
| 584 |
is \fIMwm*\fP\fBresource_id\fP |
| 585 |
.PP |
| 586 |
For example, \fIMwm*keyboardFocusPolicy\fP specifies |
| 587 |
the window manager policy for setting the keyboard focus to a particular client |
| 588 |
window\&. |
| 589 |
.PP |
| 590 |
The following general appearance and behavior resources can be specified: |
| 591 |
.SS "General Appearance and Behavior Resources" |
| 592 |
.TS |
| 593 |
tab(); |
| 594 |
lw(1.528376i) lw(1.592955i) lw(1.054795i) lw(1.323875i). |
| 595 |
NameClassValue TypeDefault |
| 596 |
autoKeyFocusAutoKeyFocusT/FT |
| 597 |
autoRaiseDelayAutoRaiseDelaymillisec500 |
| 598 |
bitmap-Bitmap-directory/usr/X11R6/include- |
| 599 |
DirectoryDirectory/X11/bitmaps |
| 600 |
clientAutoPlaceClientAutoPlaceT/FT |
| 601 |
colormapFocus-ColormapFocus-stringkeyboard |
| 602 |
PolicyPolicy |
| 603 |
configFileConfigFilefile$HOME/mwmrc |
| 604 |
deiconifyKeyFocusDeiconifyKeyFocusT/FT |
| 605 |
doubleClick-DoubleClick-millisec\&.multi-click |
| 606 |
TimeTimetime\(dg |
| 607 |
enableWarpenableWarpT/FT |
| 608 |
enforceKeyFocusEnforceKeyFocusT/FT |
| 609 |
frameStyleFrameStylestringrecessed |
| 610 |
iconAutoPlaceIconAutoPlaceT/FT |
| 611 |
iconClickIconClickT/FT |
| 612 |
interactivePlacementInteractivePlacementT/FT |
| 613 |
keyboardFocus-KeyboardFocus-stringexplicit |
| 614 |
PolicyPolicy |
| 615 |
lowerOnIconifyLowerOnIconifyT/FT |
| 616 |
moveThresholdMoveThresholdpixels4 |
| 617 |
multiScreenMultiScreenT/FF |
| 618 |
passButtonsPassButtonsT/FF |
| 619 |
passSelectButtonPassSelectButtonT/FT |
| 620 |
positionIsFramePositionIsFrameT/FT |
| 621 |
positionOnScreenPositionOnScreenT/FT |
| 622 |
quitTimeoutQuitTimeoutmillisec\&.1000 |
| 623 |
raiseKeyFocusRaiseKeyFocusT/FF |
| 624 |
refreshByClearingRefreshByClearingT/FT |
| 625 |
rootButtonClickRootButtonClickT/FF |
| 626 |
screensScreensstringvaries |
| 627 |
sessionClientDBSessionClientDBstring$HOME/\&.mwmclientdb |
| 628 |
showFeedbackShowFeedbackstringall |
| 629 |
startupKeyFocusStartupKeyFocusT/FT |
| 630 |
wMenuButtonClickWMenuButtonClickT/FT |
| 631 |
wMenuButtonClick2WMenuButtonClick2T/FT |
| 632 |
.TE |
| 633 |
.PP |
| 634 |
\(dgThe resource doubleClickTime is included for backward compatibility\&. |
| 635 |
Use of the Xt resource multiClickTime is preferred\&. |
| 636 |
.IP "\fIautoKeyFocus\fP\ (class\ \fIAutoKeyFocus\fP)" 10 |
| 637 |
This resource is available only when the keyboard input focus policy |
| 638 |
is explicit\&. If \fIautoKeyFocus\fP is given a value of True, |
| 639 |
then when a window with the keyboard input focus is withdrawn from window |
| 640 |
management or is iconified, the focus is set to the previous window that had |
| 641 |
the focus\&. If the value given is False, there is no automatic setting of the |
| 642 |
keyboard input focus\&. It is recommended that both \fIautoKeyFocus\fP and \fIstartupKeyFocus\fP be True to work with |
| 643 |
tear off menus\&. The default value is True\&. |
| 644 |
.IP "\fIautoRaiseDelay\fP\ (class\ \fIAutoRaiseDelay\fP)" 10 |
| 645 |
This resource is available only when the \fIfocusAutoRaise\fP |
| 646 |
resource is True and the keyboard focus policy is pointer\&. The \fIautoRaiseDelay\fP resource specifies the amount of time (in milliseconds) |
| 647 |
that \fBmwm\fP will wait before raising a window after it gets |
| 648 |
the keyboard focus\&. The default value of this resource is 500 (ms)\&. |
| 649 |
.IP "\fIbitmapDirectory\fP\ (class\ \fIBitmapDirectory\fP)" 10 |
| 650 |
This resource identifies a directory to be searched for bitmaps referenced |
| 651 |
by \fBmwm\fP resources\&. This directory is searched if a bitmap |
| 652 |
is specified without an absolute pathname\&. The default value for this resource |
| 653 |
is \fB/usr/X11R6/include/X11/bitmaps\fP\&. The directory \fB/usr/X11R6/include/X11/bitmaps\fP |
| 654 |
represents the customary locations for this directory\&. The actual |
| 655 |
location of this directory may vary on some systems\&. If the bitmap is not |
| 656 |
found in the specified directory, \fBXBMLANGPATH\fP is searched\&. |
| 657 |
.IP "\fIclientAutoPlace\fP\ (class\ \fIClientAutoPlace\fP)" 10 |
| 658 |
This resource determines the position of a window when the window has |
| 659 |
not been given a program- or user-specified position\&. With a value of True, |
| 660 |
windows are positioned with the top left corners of the frames offset horizontally |
| 661 |
and vertically\&. A value of False causes the currently configured position |
| 662 |
of the window to be used\&. In either case, \fBmwm\fP will attempt |
| 663 |
to place the windows totally on-screen\&. The default value is True\&. |
| 664 |
.IP "\fIcolormapFocusPolicy\fP\ (class\ \fIColormapFocusPolicy\fP)" 10 |
| 665 |
This resource indicates the colormap focus policy that is to be used\&. |
| 666 |
If the resource value is explicit, a colormap selection action is done on |
| 667 |
a client window to set the colormap focus to that window\&. If the value is |
| 668 |
pointer, the client window containing the pointer has the colormap focus\&. |
| 669 |
If the value is keyboard, the client window that has the keyboard input focus |
| 670 |
has the colormap focus\&. The default value for this resource is keyboard\&. |
| 671 |
.IP "\fIconfigFile\fP\ (class\ \fIConfigFile\fP)" 10 |
| 672 |
The resource value is the pathname for a \fBmwm\fP resource |
| 673 |
description file\&. If the pathname begins with "~/", \fBmwm\fP |
| 674 |
considers it to be relative to the user\&'s home directory (as specified by |
| 675 |
the \fBHOME\fP environment variable)\&. |
| 676 |
If the \fBLANG\fP environment variable |
| 677 |
is set, \fBmwm\fP looks for \fI$HOME/$LANG\fP/ \fBconfigFile\fP\&. If that file does not exist or if \fBLANG\fP is not set, \fBmwm\fP looks for |
| 678 |
\fB$HOME\fP/\fBconfigFile\fP\&. If the \fIconfigFile\fP pathname does not begin with "~/" or "/", \fBmwm\fP considers it to be relative to the current working directory\&. If |
| 679 |
the \fIconfigFile\fP resource is not specified |
| 680 |
or if that file does not exist, \fBmwm\fP uses several default |
| 681 |
paths to find a configuration file\&. The order of the search is shown below: \fB/usr/X11R6/lib/X11/$LANG/system\&.mwmrc\fP\(dg |
| 682 |
\fB/usr/X11R6/lib/X11/system\&.mwmrc\fP\(dg Paths marked with \&'\(dg\&' are |
| 683 |
implementation dependent\&. |
| 684 |
.IP "\fIdeiconifyKeyFocus\fP\ (class\ \fIDeiconifyKeyFocus\fP)" 10 |
| 685 |
This resource applies only when the keyboard input focus policy is explicit\&. |
| 686 |
If a value of True is used, a window receives the keyboard input focus when |
| 687 |
it is normalized (deiconified)\&. True is the default value\&. |
| 688 |
.IP "\fIdoubleClickTime\fP\ (class\ \fIDoubleClickTime\fP)" 10 |
| 689 |
This resource is used to set the maximum time (in ms) between the clicks |
| 690 |
(button presses) that make up a double-click\&. The use of this resource is |
| 691 |
deprecated\&. Use the Xt resource \fImultiClickTime\fP instead\&. |
| 692 |
The value of \fIdoubleClickTime\fP dynamically defaults to |
| 693 |
the value of \fImultiClickTime\fP\&. |
| 694 |
.IP "\fIenableWarp\fP\ (class\ \fIEnableWarp\fP)" 10 |
| 695 |
The default value of this resource, True, causes \fBmwm\fP |
| 696 |
to warp the pointer to the center of the selected window during keyboard-controlled |
| 697 |
resize and move operations\&. Setting the value to False causes \fBmwm\fP to leave the pointer at its original place on the screen, unless |
| 698 |
the user explicitly moves it with the cursor keys or pointing device\&. |
| 699 |
.IP "\fIenforceKeyFocus\fP\ (class\ \fIEnforceKeyFocus\fP)" 10 |
| 700 |
If this resource is given a value of True, the keyboard input focus |
| 701 |
is always explicitly set to selected windows even if there is an indication |
| 702 |
that they are "globally active" input windows\&. (An example of a globally active |
| 703 |
window is a scroll bar that can be operated without setting the focus to that |
| 704 |
client\&.) If the resource is False, the keyboard input focus is not explicitly |
| 705 |
set to globally active windows\&. The default value is True\&. |
| 706 |
.IP "\fIframeStyle\fP\ (class\ \fIframeStyle\fP)" 10 |
| 707 |
If this resource is given a value of "slab", the the window manager |
| 708 |
frame is drawn such that the client area appears to be at the same height |
| 709 |
as the top of the window frame\&. If the resource is set to "recessed", the |
| 710 |
window frame is drawn such that the client area appears lower than the top |
| 711 |
of the window frame\&. The default value is "recessed"\&. |
| 712 |
.IP "\fIiconAutoPlace\fP\ (class\ \fIIconAutoPlace\fP)" 10 |
| 713 |
This resource indicates whether the window manager arranges icons in |
| 714 |
a particular area of the screen or places each icon where the window was when |
| 715 |
it was iconified\&. The value True indicates that icons are arranged in a particular |
| 716 |
area of the screen, determined by the \fIiconPlacement\fP resource\&. |
| 717 |
The value False indicates that an icon is placed at the location of the window |
| 718 |
when it is iconified\&. The default is True\&. |
| 719 |
.IP "\fIiconClick\fP\ (class\ \fIIconClick\fP)" 10 |
| 720 |
When this resource is given the value of True, the system menu is posted |
| 721 |
and left posted when an icon is clicked\&. The default value is True\&. |
| 722 |
.IP "\fIinteractivePlacement\fP\ (class\ \fIInteractivePlacement\fP)" 10 |
| 723 |
This resource controls the initial placement of new windows on the screen\&. |
| 724 |
If the value is True, the pointer shape changes before a new window is placed |
| 725 |
on the screen to indicate to the user that a position should be selected for |
| 726 |
the upper-left hand corner of the window\&. If the value is False, windows are |
| 727 |
placed according to the initial window configuration attributes\&. The default |
| 728 |
value of this resource is False\&. |
| 729 |
.IP "\fIkeyboardFocusPolicy\fP\ (class\ \fIKeyboardFocusPolicy\fP)" 10 |
| 730 |
If set to pointer, the keyboard focus policy is to have the keyboard |
| 731 |
focus set to the client window that contains the pointer (the pointer could |
| 732 |
also be in the client window decoration that \fBmwm\fP adds)\&. |
| 733 |
If set to explicit, the policy is to have the keyboard focus set to a client |
| 734 |
window when the user presses button 1 with the pointer on the client window |
| 735 |
or any part of the associated \fBmwm\fP decoration\&. The default |
| 736 |
value for this resource is explicit\&. |
| 737 |
.IP "\fIlowerOnIconify\fP\ (class\ \fILowerOnIconify\fP)" 10 |
| 738 |
If this resource is given the default value of True, a window\&'s icon |
| 739 |
appears on the bottom of the window stack when the window is minimized (iconified)\&. |
| 740 |
A value of False places the icon in the stacking order at the same place as |
| 741 |
its associated window\&. The default value of this resource is True\&. |
| 742 |
.IP "\fImoveThreshold\fP\ (class\ \fIMoveThreshold\fP)" 10 |
| 743 |
This resource is used to control the sensitivity of dragging operations |
| 744 |
that move windows and icons\&. The value of this resource is the number of pixels |
| 745 |
that the locator is moved with a button down before the move operation is |
| 746 |
initiated\&. This is used to prevent window/icon movement when you click or |
| 747 |
double-click and there is unintentional pointer movement with the button down\&. |
| 748 |
The default value of this resource is 4 (pixels)\&. |
| 749 |
.IP "\fImultiScreen\fP\ (class\ \fIMultiScreen\fP)" 10 |
| 750 |
This resource, if True, causes \fBmwm\fP to manage all |
| 751 |
the screens on the display\&. If False, \fBmwm\fP manages only |
| 752 |
a single screen\&. The default value is False\&. |
| 753 |
.IP "\fIpassButtons\fP\ (class\ \fIPassButtons\fP)" 10 |
| 754 |
This resource indicates whether or not button press events are passed |
| 755 |
to clients after they are used to do a window manager function in the client |
| 756 |
context\&. If the resource value is False, the button press is not passed to |
| 757 |
the client\&. If the value is True, the button press is passed to the client |
| 758 |
window\&. The window manager function is done in either case\&. The default value |
| 759 |
for this resource is False\&. |
| 760 |
.IP "\fIpassSelectButton\fP\ (class\ \fIPassSelectButton\fP)" 10 |
| 761 |
This resource indicates whether or not to pass the select button press |
| 762 |
events to clients after they are used to do a window manager function in the |
| 763 |
client context\&. If the resource value is False, then the button press will |
| 764 |
not be passed to the client\&. If the value is True, the button press is passed |
| 765 |
to the client window\&. The window manager function is done in either case\&. |
| 766 |
The default value for this resource is True\&. |
| 767 |
.IP "\fIpositionIsFrame\fP\ (class\ \fIPositionIsFrame\fP)" 10 |
| 768 |
This resource indicates how client window position information (from |
| 769 |
the \fIWM_NORMAL_HINTS\fP property and from configuration requests) |
| 770 |
is to be interpreted\&. If the resource value is True, the information is interpreted |
| 771 |
as the position of the \fBmwm\fP client window frame\&. If the |
| 772 |
value is False, it is interpreted as being the position of the client area |
| 773 |
of the window\&. The default value of this resource is True\&. |
| 774 |
.IP "\fIpositionOnScreen\fP\ (class\ \fIPositionOnScreen\fP)" 10 |
| 775 |
This resource is used to indicate that windows should initially be placed |
| 776 |
(if possible) so that they are not clipped by the edge of the screen (if the |
| 777 |
resource value is True)\&. If a window is larger than the size of the screen, |
| 778 |
at least the upper-left corner of the window is on-screen\&. If the resource |
| 779 |
value is False, windows are placed in the requested position even if totally |
| 780 |
off-screen\&. The default value of this resource is True\&. |
| 781 |
.IP "\fIquitTimeout\fP\ (class\ \fIQuitTimeout\fP)" 10 |
| 782 |
This resource specifies the amount of time (in milliseconds) that \fBmwm\fP will wait for a client to update the \fIWM_COMMAND\fP |
| 783 |
property after \fBmwm\fP has sent the \fBWM_SAVE_YOURSELF\fP message\&. The default value of this resource is 1000 (ms)\&. (Refer |
| 784 |
to the \fBf\&.kill\fP function description for additional information\&.) |
| 785 |
.IP "\fIraiseKeyFocus\fP\ (class\ \fIRaiseKeyFocus\fP)" 10 |
| 786 |
This resource is available only when the keyboard input focus policy |
| 787 |
is explicit\&. When set to True, this resource specifies that a window raised |
| 788 |
by means of the \fBf\&.normalize_and_raise\fP function also receives |
| 789 |
the input focus\&. The default value of this resource is False\&. |
| 790 |
.IP "\fIrefreshByClearing\fP\ (class\ \fIRefreshByClearing\fP)" 10 |
| 791 |
This resource determines the mechanism used to refresh a window (or |
| 792 |
the screen) when the \fBf\&.refresh_win\fP (\fBf\&.refresh\fP) function is executed\&. When set to True, an XClearArea is performed |
| 793 |
over the window for \fBf\&.refresh_win\fP\&. When set to False, |
| 794 |
a covering window is created and destroyed over the top of the window to be |
| 795 |
refreshed\&. If the function is \fBf\&.refresh\fP and this resource |
| 796 |
is set to True, then an XClearArea is performed over every window on the screen\&. |
| 797 |
If the resource is set to False, then one large window covering the entire |
| 798 |
screen is created and destroyed\&. The default value of this resource is True\&. |
| 799 |
.IP "\fIrootButtonClick\fP\ (class\ \fIRootButtonClick\fP)" 10 |
| 800 |
The \fIrootButtonClick\fP resource controls whether the |
| 801 |
a click on the root window will post the root menu in a "sticky" mode\&. If |
| 802 |
this resource is set to True, a button click on the root window will post |
| 803 |
the menu bound to the button down event for that button in a "sticky" fashion\&. |
| 804 |
If this resource is set to False, then the same button click would only cause |
| 805 |
the menu to flash as it would be unposted once the button up event is seen\&. |
| 806 |
The criterion used to determine if it is a button click is if the pointer |
| 807 |
doesn\&'t move between the button down and button up events\&. The default value |
| 808 |
for this resource is True\&. |
| 809 |
.IP "\fIscreens\fP\ (class\ \fIScreens\fP)" 10 |
| 810 |
This resource specifies the resource names to use for the screens managed |
| 811 |
by \fBmwm\fP\&. If \fBmwm\fP is managing a single |
| 812 |
screen, only the first name in the list is used\&. If \fBmwm\fP |
| 813 |
is managing multiple screens, the names are assigned to the screens in order, |
| 814 |
starting with screen 0\&. Screen 0 gets the first name, screen 1 the second |
| 815 |
name, and so on\&. The default screen names are 0, 1, and so on\&. |
| 816 |
.IP "\fIsessionClientDB\fP\ (class\ \fISessionClientDB\fP)" 10 |
| 817 |
This resource identifies a file name to use as a root when saving state |
| 818 |
at the request of an XSMP session manager\&. When the session is saved, the window manager will then reuse |
| 819 |
the file name by automatically incrementing a suffix\&. |
| 820 |
.IP "\fIshowFeedback\fP\ (class\ \fIShowFeedback\fP)" 10 |
| 821 |
This resource controls whether or not feedback windows or confirmation |
| 822 |
dialogs are displayed\&. A feedback window shows a client window\&'s initial |
| 823 |
placement and shows position and size during move and resize operations\&. |
| 824 |
Confirmation dialogs can be displayed for certain operations\&. The value for |
| 825 |
this resource is a list of names of the feedback options to be enabled or |
| 826 |
disabled; the names must be separated by a space\&. If an option is preceded |
| 827 |
by a minus sign, that option is excluded from the list\&. The \fBsign\fP of the first item in the list determines the initial set of options\&. |
| 828 |
If the sign of the first option is minus, \fBmwm\fP assumes |
| 829 |
all options are present and starts subtracting from that set\&. If the sign |
| 830 |
of the first decoration is plus (or not specified), \fBmwm\fP |
| 831 |
starts with no options and builds up a list from the resource\&. |
| 832 |
.PP |
| 833 |
The names of the feedback options are shown below: |
| 834 |
.TS |
| 835 |
tab(); |
| 836 |
lw(1.097588i) lw(4.402412i). |
| 837 |
NameDescription |
| 838 |
allShow all feedback (Default value)\&. |
| 839 |
behaviorConfirm behavior switch\&. |
| 840 |
killConfirm on receipt of KILL signal\&. |
| 841 |
moveShow position during move\&. |
| 842 |
noneShow no feedback\&. |
| 843 |
placementT{ |
| 844 |
Show position and size during initial placement\&. |
| 845 |
T} |
| 846 |
quitConfirm quitting \fBmwm\fP\&. |
| 847 |
resizeShow size during resize\&. |
| 848 |
restartConfirm \fBmwm\fP restart\&. |
| 849 |
.TE |
| 850 |
.PP |
| 851 |
The following command line illustrates the syntax for showFeedback: |
| 852 |
.PP |
| 853 |
.nf |
| 854 |
\f(CW\fIMwm*showFeedback: placement resize behavior restart\fP\fR |
| 855 |
.fi |
| 856 |
.PP |
| 857 |
.PP |
| 858 |
This resource specification provides feedback for initial client placement |
| 859 |
and resize, and enables the dialog boxes to confirm the restart and set behavior |
| 860 |
functions\&. It disables feedback for the move function\&. The default value for |
| 861 |
this resource is all\&. |
| 862 |
.IP "\fIstartupKeyFocus\fP\ (class\ \fIStartupKeyFocus\fP)" 10 |
| 863 |
This resource is available only when the keyboard input focus policy |
| 864 |
is explicit\&. When given the default value of True, a window gets the keyboard |
| 865 |
input focus when the window is mapped (that is, initially managed by the window |
| 866 |
manager)\&. It is recommended that both \fIautoKeyFocus\fP and \fIstartupKeyFocus\fP be True to work with tear off menus\&. The default |
| 867 |
value is True\&. |
| 868 |
.IP "\fIwMenuButtonClick\fP\ (class\ \fIWMenuButtonClick\fP)" 10 |
| 869 |
This resource indicates whether a click of the mouse when the pointer |
| 870 |
is over the window menu button posts and leaves posted the window menu\&. If |
| 871 |
the value given this resource is True, the menu remains posted\&. True is the |
| 872 |
default value for this resource\&. |
| 873 |
.IP "\fIwMenuButtonClick2\fP\ (class\ \fIWMenuButtonClick2\fP)" 10 |
| 874 |
When this resource is given the default value of True, a double-click |
| 875 |
action on the window menu button does an \fIf\&.kill function\fP\&. |
| 876 |
.SS "Screen Specific Appearance and Behavior Resources" |
| 877 |
.PP |
| 878 |
The syntax for specifying screen specific resources is \fIMwm*\fP \fBscreen_name\fP\fI*\fP\fBresource_id\fP For example, \fIMwm*1*keyBindings\fP specifies |
| 879 |
the key bindings to use for screen "1"\&. |
| 880 |
.SS "Screen Specific Resources" |
| 881 |
.TS |
| 882 |
tab(); |
| 883 |
lw(1.768627i) lw(1.790196i) lw(0.927451i) lw(1.013725i). |
| 884 |
NameClassValue TypeDefault |
| 885 |
buttonBindingsButtonBindingsstringDefaultButtonBindings |
| 886 |
cleanTextCleanTextT/FT |
| 887 |
fadeNormalIconFadeNormalIconT/FF |
| 888 |
feedbackGeometryFeedbackGeometrystringcenter on screen |
| 889 |
frameBorderWidthFrameBorderWidthpixelsvaries |
| 890 |
iconBoxGeometryIconBoxGeometrystring6x1+0-0 |
| 891 |
iconBoxNameIconBoxNamestringiconbox |
| 892 |
iconBoxSBDisplayPolicyIconBoxSBDisplayPolicystringall |
| 893 |
iconBoxTitleIconBoxTitleXmStringIcons |
| 894 |
iconDecorationIconDecorationstringvaries |
| 895 |
iconImageMaximumIconImageMaximumwxh48x48 |
| 896 |
iconImageMinimumIconImageMinimumwxh16x16 |
| 897 |
iconPlacementIconPlacementstringleft bottom |
| 898 |
iconPlacementMarginIconPlacementMarginpixelsvaries |
| 899 |
keyBindingsKeyBindingsstringDefaultKeyBindings |
| 900 |
limitResizeLimitResizeT/FT |
| 901 |
maximumMaximumSizeMaximumMaximumSizewxh (pixels)2X screen w&h |
| 902 |
moveOpaqueMoveOpaqueT/FF |
| 903 |
resizeBorderWidthResizeBorderWidthpixelsvaries |
| 904 |
resizeCursorsResizeCursorsT/FT |
| 905 |
transientDecorationTransientDecorationstringmenu title |
| 906 |
transientFunctionsTransientFunctionsstringT{ |
| 907 |
-minimize-maximize |
| 908 |
T} |
| 909 |
useIconBoxUseIconBoxT/FF |
| 910 |
.TE |
| 911 |
.IP "\fIbuttonBindings\fP\ (class\ \fIButtonBindings\fP)" 10 |
| 912 |
This resource identifies the set of button bindings for window management |
| 913 |
functions\&. The named set of button bindings is specified in the \fBmwm\fP resource description file\&. These button bindings are \fBmerged\fP with the built-in default bindings\&. The default value for |
| 914 |
this resource is "DefaultButtonBindings"\&. |
| 915 |
.IP "\fIcleanText\fP\ (class\ \fICleanText\fP)" 10 |
| 916 |
This resource controls the display of window manager text in the client |
| 917 |
title and feedback windows\&. If the default value of True is used, the text |
| 918 |
is drawn with a clear (no stipple) background\&. This makes text easier to read |
| 919 |
on monochrome systems where a backgroundPixmap is specified\&. Only the stippling |
| 920 |
in the area immediately around the text is cleared\&. If False, the text is |
| 921 |
drawn directly on top of the existing background\&. |
| 922 |
.IP "\fIfadeNormalIcon\fP\ (class\ \fIFadeNormalIcon\fP)" 10 |
| 923 |
If this resource is given a value of True, an icon is grayed out whenever |
| 924 |
it has been normalized (its window has been opened)\&. The default value is |
| 925 |
False\&. |
| 926 |
.IP "\fIfeedbackGeometry\fP\ (class\ \fIFeedbackGeometry\fP)" 10 |
| 927 |
This resource sets the position of the move and resize feedback window\&. |
| 928 |
If this resource is not specified, the default is to place the feedback window |
| 929 |
at the center of the screen\&. The value of the resource is a standard window |
| 930 |
geometry string with the following syntax: [\fI=\fP]{ \fI+-\fP}\fBxoffset\fP{\fI+-\fP} \fByoffset\fP] |
| 931 |
.IP "\fIframeBorderWidth\fP\ (class\ \fIFrameBorderWidth\fP)" 10 |
| 932 |
This resource specifies the width (in pixels) of a client window frame |
| 933 |
border without resize handles\&. The border width includes the 3-D shadows\&. |
| 934 |
The default value is based on the size and resolution of the screen\&. |
| 935 |
.IP "\fIiconBoxGeometry\fP\ (class\ \fIIconBoxGeometry\fP)" 10 |
| 936 |
This resource indicates the initial position and size of the icon box\&. |
| 937 |
The value of the resource is a standard window geometry string with the following |
| 938 |
syntax: [\fI=\fP][\fBwidth\fP \fIx\fP\fBheight\fP][{\fI+-\fP}\fBxoffset\fP {\fI+-\fP}\fByoffset\fP] If the offsets |
| 939 |
are not provided, the iconPlacement policy is used to determine the initial |
| 940 |
placement\&. The units for width and height are columns and rows\&. The actual |
| 941 |
screen size of the icon box window depends on the iconImageMaximum (size) |
| 942 |
and \fIiconDecoration\fP resources\&. The default value for size |
| 943 |
is (6 * iconWidth + padding) wide by (1 * iconHeight + padding) high\&. The |
| 944 |
default value of the location is +0 -0\&. |
| 945 |
.IP "\fIiconBoxName\fP\ (class\ \fIIconBoxName\fP)" 10 |
| 946 |
This resource specifies the name that is used to look up icon box resources\&. |
| 947 |
The default name is iconbox\&. |
| 948 |
.IP "\fIiconBoxSBDisplayPolicy\fP\ (class\ \fIIconBoxSBDisplayPolicy\fP)" 10 |
| 949 |
This resource specifies the scroll bar display policy of the window |
| 950 |
manager in the icon box\&. The resource has three possible values: all, vertical, |
| 951 |
and horizontal\&. The default value, "all", causes both vertical and horizontal |
| 952 |
scroll bars always to appear\&. The value "vertical" causes a single vertical |
| 953 |
scroll bar to appear in the icon box and sets the orientation of the icon |
| 954 |
box to horizontal (regardless of the iconBoxGeometry specification)\&. The value |
| 955 |
"horizontal" causes a single horizontal scroll bar to appear in the icon box |
| 956 |
and sets the orientation of the icon box to vertical (regardless of the iconBoxGeometry |
| 957 |
specification)\&. |
| 958 |
.IP "\fIiconBoxTitle\fP\ (class\ \fIIconBoxTitle\fP)" 10 |
| 959 |
This resource specifies the name that is used in the title area of the |
| 960 |
icon box frame\&. The default value is Icons\&. |
| 961 |
.IP "\fIiconDecoration\fP\ (class\ \fIIconDecoration\fP)" 10 |
| 962 |
This resource specifies the general icon decoration\&. The resource value |
| 963 |
is label (only the label part is displayed) or image (only the image part |
| 964 |
is displayed) or label image (both the label and image parts are displayed)\&. |
| 965 |
A value of activelabel can also be specified to get a label (not truncated |
| 966 |
to the width of the icon) when the icon is selected\&. The default icon decoration |
| 967 |
for icon box icons is that each icon has a label part and an image part (label |
| 968 |
image)\&. The default icon decoration for stand alone icons is that each icon |
| 969 |
has an active label part, a label part, and an image part (activelabel label |
| 970 |
image)\&. |
| 971 |
.IP "\fIiconImageMaximum\fP\ (class\ \fIIconImageMaximum\fP)" 10 |
| 972 |
This resource specifies the maximum size of the icon image\&. The resource |
| 973 |
value is \fBwidth\fP\fIx\fP \fBheight\fP (for example, 64x64)\&. The maximum supported size is 128x128\&. |
| 974 |
The default value of this resource is 50x50\&. |
| 975 |
.IP "\fIiconImageMinimum\fP\ (class\ \fIIconImageMinimum\fP)" 10 |
| 976 |
This resource specifies the minimum size of the icon image\&. The resource |
| 977 |
value is \fBwidth\fP\fIx\fP \fBheight\fP (for example, 32x50)\&. The minimum supported size is 16x16\&. |
| 978 |
The default value of this resource is 16x16\&. |
| 979 |
.IP "\fIiconPlacement\fP\ (class\ \fIIconPlacement\fP)" 10 |
| 980 |
This resource specifies the icon placement scheme to be used\&. The resource |
| 981 |
value has the following syntax: |
| 982 |
.IP "" 10 |
| 983 |
\fBprimary_layout secondary_layout [tight]\fP |
| 984 |
.PP |
| 985 |
The layout values are one of the following: |
| 986 |
.TS |
| 987 |
tab(); |
| 988 |
lw(0.796053i) lw(4.703947i). |
| 989 |
ValueDescription |
| 990 |
topLay the icons out top to bottom\&. |
| 991 |
bottomLay the icons out bottom to top\&. |
| 992 |
leftLay the icons out left to right\&. |
| 993 |
rightLay the icons out right to left\&. |
| 994 |
.TE |
| 995 |
.PP |
| 996 |
A horizontal (vertical) layout value should not be used for both the \fBprimary_layout\fP and the \fBsecondary_layout\fP (for |
| 997 |
example, don\&'t use top for the \fBprimary_layout\fP and bottom |
| 998 |
for the \fBsecondary_layout\fP)\&. |
| 999 |
.PP |
| 1000 |
The \fBprimary_layout\fP indicates whether, when an icon |
| 1001 |
placement is done, the icon is placed in a row or a column and the direction |
| 1002 |
of placement\&. The \fBsecondary_layout\fP indicates where to place |
| 1003 |
new rows or columns\&. For example, top right indicates that icons should be |
| 1004 |
placed top to bottom on the screen and that columns should be added from right |
| 1005 |
to left on the screen\&. |
| 1006 |
.PP |
| 1007 |
The default placement is left bottom (icons are placed left to right |
| 1008 |
on the screen, with the first row on the bottom of the screen, and new rows |
| 1009 |
added from the bottom of the screen to the top of the screen)\&. A \fBtight\fP value places icons with zero spacing in between icons\&. This |
| 1010 |
value is useful for aesthetic reasons, as well as X-terminals with small screens\&. |
| 1011 |
.IP "\fIiconPlacementMargin\fP\ (class\ \fIIconPlacementMargin\fP)" 10 |
| 1012 |
This resource sets the distance between the edge of the screen and the |
| 1013 |
icons that are placed along the edge of the screen\&. The value should be greater |
| 1014 |
than or equal to 0\&. A default value (see below) is used if the value specified |
| 1015 |
is invalid\&. The default value for this resource is equal to the space between |
| 1016 |
icons as they are placed on the screen (this space is based on maximizing |
| 1017 |
the number of icons in each row and column)\&. |
| 1018 |
.IP "\fIkeyBindings\fP\ (class\ \fIKeyBindings\fP)" 10 |
| 1019 |
This resource identifies the set of key bindings for window management |
| 1020 |
functions\&. If specified, these key bindings \fBreplace\fP the |
| 1021 |
built-in default bindings\&. The named set of key bindings is specified in \fBmwm\fP resource description file\&. The default value for this resource |
| 1022 |
is "DefaultKeyBindings"\&. |
| 1023 |
.IP "\fIlimitResize\fP\ (class\ \fILimitResize\fP)" 10 |
| 1024 |
If this resource is True, the user is not allowed to resize a window |
| 1025 |
to greater than the maximum size\&. The default value for this resource is True\&. |
| 1026 |
.IP "\fImaximumMaximumSize\fP\ (class\ \fIMaximumMaximumSize\fP)" 10 |
| 1027 |
This resource is used to limit the maximum size of a client window as |
| 1028 |
set by the user or client\&. The resource value is \fBwidth\fP\fIx\fP\fBheight\fP (for example, 1024x1024) |
| 1029 |
where the width and height are in pixels\&. The default value of this resource |
| 1030 |
is twice the screen width and height\&. |
| 1031 |
.IP "\fImoveOpaque\fP\ (class\ \fIMoveOpaque\fP)" 10 |
| 1032 |
This resource controls whether the actual window is moved or a rectangular |
| 1033 |
outline of the window is moved\&. A default value of False displays a rectangular |
| 1034 |
outline on moves\&. |
| 1035 |
.IP "\fIresizeBorderWidth\fP\ (class\ \fIResizeBorderWidth\fP)" 10 |
| 1036 |
This resource specifies the width (in pixels) of a client window frame |
| 1037 |
border with resize handles\&. The specified border width includes the 3-D shadows\&. |
| 1038 |
The default value is based on the size and resolution of the screen\&. |
| 1039 |
.IP "\fIresizeCursors\fP\ (class\ \fIResizeCursors\fP)" 10 |
| 1040 |
This is used to indicate whether the resize cursors are always displayed |
| 1041 |
when the pointer is in the window size border\&. If True, the cursors are shown, |
| 1042 |
otherwise the window manager cursor is shown\&. The default value is True\&. |
| 1043 |
.IP "\fItransientDecoration\fP\ (class\ \fITransientDecoration\fP)" 10 |
| 1044 |
This controls the amount of decoration that \fBmwm\fP |
| 1045 |
puts on transient windows\&. The decoration specification is exactly the same |
| 1046 |
as for the \fIclientDecoration\fP (client specific) resource\&. |
| 1047 |
Transient windows are identified by the \fIWM_TRANSIENT_FOR\fP |
| 1048 |
property, which is added by the client to indicate a relatively temporary |
| 1049 |
window\&. The default value for this resource is menu title (that is, transient |
| 1050 |
windows have frame borders and a titlebar with a window menu button)\&. |
| 1051 |
.IP "" 10 |
| 1052 |
An application can also specify which decorations \fBmwm\fP |
| 1053 |
should apply to its windows\&. If it does so, \fBmwm\fP applies |
| 1054 |
only those decorations indicated by both the application and the \fItransientDecoration\fP resource\&. Otherwise, \fBmwm\fP |
| 1055 |
applies the decorations indicated by the \fItransientDecoration\fP |
| 1056 |
resource\&. For more information see the description of \fBXmNmwmDecorations\fP on the \fBVendorShell\fP(3) |
| 1057 |
reference page\&. |
| 1058 |
.IP "\fItransientFunctions\fP\ (class\ \fITransientFunctions\fP)" 10 |
| 1059 |
This resource is used to indicate which window management functions |
| 1060 |
are applicable (or not applicable) to transient windows\&. The function specification |
| 1061 |
is exactly the same as for the \fIclientFunctions\fP (client |
| 1062 |
specific) resource\&. The default value for this resource is -minimize -maximize\&. |
| 1063 |
.IP "" 10 |
| 1064 |
An application can also specify which functions \fBmwm\fP |
| 1065 |
should apply to its windows\&. If it does so, \fBmwm\fP applies |
| 1066 |
only those functions indicated by both the application and the \fItransientFunctions\fP resource\&. Otherwise, \fBmwm\fP |
| 1067 |
applies the functions indicated by the \fItransientFunctions\fP |
| 1068 |
resource\&. For more information see the description of \fBXmNmwmFunctions\fP on the \fBVendorShell\fP(3) reference |
| 1069 |
page\&. |
| 1070 |
.IP "\fIuseIconBox\fP\ (class\ \fIUseIconBox\fP)" 10 |
| 1071 |
If this resource is given a value of True, icons are placed in an icon |
| 1072 |
box\&. When an icon box is not used, the icons are placed on the root window |
| 1073 |
(default value)\&. |
| 1074 |
.SS "Client Specific Resources" |
| 1075 |
.PP |
| 1076 |
The syntax for specifying client specific resources is |
| 1077 |
.PP |
| 1078 |
\fIMwm*\fP\fBclient_name_or_class\fP \fI*\fP\fBresource_id\fP |
| 1079 |
.PP |
| 1080 |
For example, \fIMwm*mterm*windowMenu\fP is used to specify |
| 1081 |
the window menu to be used with mterm clients\&. The syntax for specifying client |
| 1082 |
specific resources for all classes of clients is |
| 1083 |
.PP |
| 1084 |
\fIMwm*\fP\fBresource_id\fP |
| 1085 |
.PP |
| 1086 |
Specific client specifications take precedence over the specifications |
| 1087 |
for all clients\&. For example, \fIMwm*windowMenu\fP is used |
| 1088 |
to specify the window menu to be used for all classes of clients that don\&'t |
| 1089 |
have a window menu specified\&. |
| 1090 |
.PP |
| 1091 |
The syntax for specifying resource values for windows that have an unknown |
| 1092 |
name and class (that is, windows that do not have a \fBWM_CLASS\fP |
| 1093 |
property associated with them) is |
| 1094 |
.PP |
| 1095 |
\fIMwm*defaults*\fP\fBresource_id\fP |
| 1096 |
.PP |
| 1097 |
For example, \fIMwm*defaults*iconImage\fP is used to |
| 1098 |
specify the icon image to be used for windows that have an unknown name and |
| 1099 |
class\&. |
| 1100 |
.PP |
| 1101 |
The following client specific resources can be specified: |
| 1102 |
.SS "Client Specific Resources" |
| 1103 |
.TS |
| 1104 |
tab(); |
| 1105 |
lw(1.999018i) lw(1.458743i) lw(0.918468i) lw(1.123772i). |
| 1106 |
NameClassValue TypeDefault |
| 1107 |
clientDecorationClientDecorationstringall\&. |
| 1108 |
clientFunctionsClientFunctionsstringall\&. |
| 1109 |
focusAutoRaiseFocusAutoRaiseT/Fvaries |
| 1110 |
iconImageIconImagepathname(image) |
| 1111 |
iconImage-Backgroundcoloricon background |
| 1112 |
Background |
| 1113 |
iconImageBottom-Foregroundcoloricon |
| 1114 |
ShadowColorbottom shadow |
| 1115 |
iconImageBottom-BottomShadow-coloricon bottom |
| 1116 |
ShadowPixmapPixmapshadow pixmap |
| 1117 |
iconImageForegroundForegroundcolorvaries |
| 1118 |
iconImageTopShadowColorBackgroundcoloricon top |
| 1119 |
shadow color |
| 1120 |
iconImageTop-TopShadowPixmapcoloricon top |
| 1121 |
ShadowPixmapshadow pixmap |
| 1122 |
matteBackgroundBackgroundcolorbackground |
| 1123 |
matteBottom-Foregroundcolorbottom |
| 1124 |
ShadowColorshadow color |
| 1125 |
matteBottom-BottomShadow-colorbottom |
| 1126 |
ShadowPixmapPixmapshadow pixmap |
| 1127 |
matteForegroundForegroundcolorforeground |
| 1128 |
matteTopShadowColorBackgroundcolortop |
| 1129 |
shadow color |
| 1130 |
matteTopShadowPixmapTopShadowPixmapcolortop |
| 1131 |
shadow pixmap |
| 1132 |
matteWidthMatteWidthpixels0 |
| 1133 |
maximumClientSizeMaximumClientSizewxh |
| 1134 |
vertical horizontalfill the screen |
| 1135 |
useClientIconUseClientIconT/FT |
| 1136 |
usePPositionUsePPositionstringnonzero |
| 1137 |
windowMenuWindowMenustringDefaultWindowMenu |
| 1138 |
.TE |
| 1139 |
.IP "\fIclientDecoration\fP\ (class\ \fIClientDecoration\fP)" 10 |
| 1140 |
This resource controls the amount of window frame decoration\&. The resource |
| 1141 |
is specified as a list of decorations to specify their inclusion in the frame\&. |
| 1142 |
If a decoration is preceded by a minus sign, that decoration is excluded from |
| 1143 |
the frame\&. The \fBsign\fP of the first item in the list determines |
| 1144 |
the initial amount of decoration\&. If the sign of the first decoration is minus, \fBmwm\fP assumes all decorations are present and starts subtracting |
| 1145 |
from that set\&. If the sign of the first decoration is plus (or not specified), |
| 1146 |
then \fBmwm\fP starts with no decoration and builds up a list |
| 1147 |
from the resource\&. |
| 1148 |
.IP "" 10 |
| 1149 |
An application can also specify which decorations \fBmwm\fP |
| 1150 |
should apply to its windows\&. If it does so, \fBmwm\fP applies |
| 1151 |
only those decorations indicated by both the application and the \fIclientDecoration\fP resource\&. Otherwise, \fBmwm\fP applies |
| 1152 |
the decorations indicated by the \fIclientDecoration\fP resource\&. |
| 1153 |
For more information see the description of \fBXmNmwmDecorations\fP on the \fBVendorShell\fP(3) reference |
| 1154 |
page\&. |
| 1155 |
.TS |
| 1156 |
tab(); |
| 1157 |
lw(0.989035i) lw(4.510965i). |
| 1158 |
NameDescription |
| 1159 |
allT{ |
| 1160 |
Include all decorations (default value)\&. |
| 1161 |
T} |
| 1162 |
borderWindow border\&. |
| 1163 |
maximizeT{ |
| 1164 |
Maximize button (includes title bar)\&. |
| 1165 |
T} |
| 1166 |
minimizeT{ |
| 1167 |
Minimize button (includes title bar)\&. |
| 1168 |
T} |
| 1169 |
noneNo decorations\&. |
| 1170 |
resizehT{ |
| 1171 |
Border resize handles (includes border)\&. |
| 1172 |
T} |
| 1173 |
menuT{ |
| 1174 |
Window menu button (includes title bar)\&. |
| 1175 |
T} |
| 1176 |
titleTitle bar (includes border)\&. |
| 1177 |
.TE |
| 1178 |
.PP |
| 1179 |
Examples: \fIMwm*XClock\&.clientDecoration: -resizeh -maximize\fP This removes the resize handles and maximize button from XClock |
| 1180 |
windows\&. \fIMwm*XClock\&.clientDecoration: menu minimize border\fP This does the same thing as above\&. Note that either \fImenu\fP or \fIminimize\fP implies |
| 1181 |
\fItitle\fP\&. |
| 1182 |
.IP "\fIclientFunctions\fP\ (class\ \fIClientFunctions\fP)" 10 |
| 1183 |
This resource is used to indicate which \fBmwm\fP functions |
| 1184 |
are applicable (or not applicable) to the client window\&. The value for the |
| 1185 |
resource is a list of functions\&. If the first function in the list has a minus |
| 1186 |
sign in front of it, then \fBmwm\fP starts with all functions |
| 1187 |
and subtracts from that set\&. If the first function in the list has a plus |
| 1188 |
sign in front of it, then \fBmwm\fP starts with no functions |
| 1189 |
and builds up a list\&. Each function in the list must be preceded by the appropriate |
| 1190 |
plus or minus sign and separated from the next function by a space\&. |
| 1191 |
.IP "" 10 |
| 1192 |
An application can also specify which functions \fBmwm\fP |
| 1193 |
should apply to its windows\&. If it does so, \fBmwm\fP applies |
| 1194 |
only those functions indicated by both the application and the \fIclientFunctions\fP resource\&. Otherwise, \fBmwm\fP applies |
| 1195 |
the functions indicated by the \fIclientFunctions\fP resource\&. |
| 1196 |
For more information see the description of \fBXmNmwmFunctions\fP on the \fBVendorShell\fP(3) reference |
| 1197 |
page\&. |
| 1198 |
.PP |
| 1199 |
The following table lists the functions available for this resource: |
| 1200 |
.TS |
| 1201 |
tab(); |
| 1202 |
lw(0.928728i) lw(4.571272i). |
| 1203 |
NameDescription |
| 1204 |
allT{ |
| 1205 |
Include all functions (default value)\&. |
| 1206 |
T} |
| 1207 |
noneNo functions\&. |
| 1208 |
resizef\&.resize\(dg\&. |
| 1209 |
movef\&.move\(dg\&. |
| 1210 |
minimizef\&.minimize\(dg\&. |
| 1211 |
maximizef\&.maximize\(dg\&. |
| 1212 |
closef\&.kill\(dg\&. |
| 1213 |
.TE |
| 1214 |
.PP |
| 1215 |
\(dgSee \fBmwmrc\fP(4)\&. |
| 1216 |
.IP "\fIfocusAutoRaise\fP\ (class\ \fIFocusAutoRaise\fP)" 10 |
| 1217 |
When the value of this resource is True, clients are raised when they |
| 1218 |
get the keyboard input focus\&. If the value is False, the stacking of windows |
| 1219 |
on the display is not changed when a window gets the keyboard input focus\&. |
| 1220 |
The default value is True when the keyboardFocusPolicy is explicit and False |
| 1221 |
when the keyboardFocusPolicy is pointer\&. |
| 1222 |
.IP "\fIiconImage\fP\ (class\ \fIIconImage\fP)" 10 |
| 1223 |
This resource can be used to specify an icon image for a client (for |
| 1224 |
example, "Mwm*myclock*iconImage")\&. The resource value is a pathname for a |
| 1225 |
pixmap or bitmap file\&. The value of the (client specific) \fIuseClientIcon\fP resource is used to determine whether or not user supplied icon |
| 1226 |
images are used instead of client supplied icon images\&. The default value |
| 1227 |
is to display a built-in window manager icon image\&. |
| 1228 |
.IP "\fIiconImageBackground\fP\ (class\ \fIBackground\fP)" 10 |
| 1229 |
This resource specifies the background color of the icon image that |
| 1230 |
is displayed in the image part of an icon\&. The default value of this resource |
| 1231 |
is the icon background color (that is, specified by "Mwm*background or Mwm*icon*background)\&. |
| 1232 |
.IP "\fIiconImageBottomShadowColor\fP\ (class\ \fIForeground\fP)" 10 |
| 1233 |
This resource specifies the bottom shadow color of the icon image that |
| 1234 |
is displayed in the image part of an icon\&. The default value of this resource |
| 1235 |
is the icon bottom shadow color (that is, specified by Mwm*icon*bottomShadowColor)\&. |
| 1236 |
.IP "\fIiconImageBottomShadowPixmap\fP\ (class\ \fIBottomShadowPixmap\fP)" 10 |
| 1237 |
This resource specifies the bottom shadow Pixmap of the icon image that |
| 1238 |
is displayed in the image part of an icon\&. The default value of this resource |
| 1239 |
is the icon bottom shadow Pixmap (that is, specified by Mwm*icon*bottomShadowPixmap)\&. |
| 1240 |
.IP "\fIiconImageForeground\fP\ (class\ \fIForeground\fP)" 10 |
| 1241 |
This resource specifies the foreground color of the icon image that |
| 1242 |
is displayed in the image part of an icon\&. The default value of this resource |
| 1243 |
varies depending on the icon background\&. |
| 1244 |
.IP "\fIiconImageTopShadowColor\fP\ (class\ \fIBackground\fP)" 10 |
| 1245 |
This resource specifies the top shadow color of the icon image that |
| 1246 |
is displayed in the image part of an icon\&. The default value of this resource |
| 1247 |
is the icon top shadow color (that is, specified by Mwm*icon*topShadowColor)\&. |
| 1248 |
.IP "\fIiconImageTopShadowPixmap\fP\ (class\ \fITopShadowPixmap\fP)" 10 |
| 1249 |
This resource specifies the top shadow Pixmap of the icon image that |
| 1250 |
is displayed in the image part of an icon\&. The default value of this resource |
| 1251 |
is the icon top shadow pixmap (that is, specified by Mwm*icon*topShadowPixmap)\&. |
| 1252 |
.IP "\fImatteBackground\fP\ \ (class\ \fIBackground\fP)" 10 |
| 1253 |
This resource specifies the background color of the matte, when \fImatteWidth\fP is positive\&. The default value of this resource is the |
| 1254 |
client background color (that is, specified by "Mwm*background or Mwm*client*background)\&. |
| 1255 |
.IP "\fImatteBottomShadowColor\fP\ (class\ \fIForeground\fP)" 10 |
| 1256 |
This resource specifies the bottom shadow color of the matte, when \fImatteWidth\fP is positive\&. The default value of this resource is the |
| 1257 |
client bottom shadow color (that is, specified by Mwm*bottomShadowColor or |
| 1258 |
Mwm*client*bottomShadowColor)\&. |
| 1259 |
.IP "\fImatteBottomShadowPixmap\fP\ (class\ \fIBottomShadowPixmap\fP)" 10 |
| 1260 |
This resource specifies the bottom shadow Pixmap of the matte, when \fImatteWidth\fP is positive\&. The default value of this resource is the |
| 1261 |
client bottom shadow pixmap (that is, specified by Mwm*bottomShadowPixmap |
| 1262 |
or Mwm*client*bottomShadowPixmap)\&. |
| 1263 |
.IP "\fImatteForeground\fP\ (class\ \fIForeground\fP)" 10 |
| 1264 |
This resource specifies the foreground color of the matte, when \fImatteWidth\fP is positive\&. The default value of this resource is the |
| 1265 |
client foreground color (that is, specified by Mwm*foreground or Mwm*client*foreground)\&. |
| 1266 |
.IP "\fImatteTopShadowColor\fP\ (class\ \fIBackground\fP)" 10 |
| 1267 |
This resource specifies the top shadow color of the matte, when \fImatteWidth\fP is positive\&. The default value of this resource is the |
| 1268 |
client top shadow color (that is, specified by Mwm*topShadowColor or Mwm*client*topShadowColor)\&. |
| 1269 |
.IP "\fImatteTopShadowPixmap\fP\ (class\ \fITopShadowPixmap\fP)" 10 |
| 1270 |
This resource specifies the top shadow pixmap of the matte, when \fImatteWidth\fP is positive\&. The default value of this resource is the |
| 1271 |
client top shadow pixmap (that is, specified by "Mwm*topShadowPixmap or Mwm*client*topShadowPixmap)\&. |
| 1272 |
.IP "\fImatteWidth\fP\ (class\ \fIMatteWidth\fP)" 10 |
| 1273 |
This resource specifies the width of the optional matte\&. The default |
| 1274 |
value is 0, which effectively disables the matte\&. |
| 1275 |
.IP "\fImaximumClientSize\fP\ (class\ \fIMaximumClientSize\fP)" 10 |
| 1276 |
This resource is either a size specification or a direction that indicates |
| 1277 |
how a client window is to be maximized\&. The resource value can be specified |
| 1278 |
as a size specification \fBwidth\fP\fIx\fP\fBheight\fP\&. The width and height are interpreted in |
| 1279 |
the units that the client uses (for example, for terminal emulators this is |
| 1280 |
generally characters)\&. Alternately, "vertical" or "horizontal" can be specified |
| 1281 |
to indicate the direction in which the client maximizes\&. |
| 1282 |
.IP "" 10 |
| 1283 |
If this resource is not specified, the maximum size from the \fIWM_NORMAL_HINTS\fP property is used if set\&. Otherwise the default |
| 1284 |
value is the size where the client window with window management borders fills |
| 1285 |
the screen\&. When the maximum client size is not determined by the \fImaximumClientSize\fP resource, the \fImaximumMaximumSize\fP |
| 1286 |
resource value is used as a constraint on the maximum size\&. |
| 1287 |
.IP "\fIuseClientIcon\fP\ (class\ \fIUseClientIcon\fP)" 10 |
| 1288 |
If the value given for this resource is True, a client-supplied icon |
| 1289 |
image takes precedence over a user-supplied icon image\&. The default value |
| 1290 |
is True, giving the client-supplied icon image higher precedence than the |
| 1291 |
user-supplied icon image\&. |
| 1292 |
.IP "\fIusePPosition\fP\ (class\ \fIUsePPosition\fP)" 10 |
| 1293 |
This resource specifies whether Mwm honors program specified position \fBPPosition\fP specified in the \fIWM_NORMAL_HINTS\fP property in the absence of an user specified position\&. Setting |
| 1294 |
this resource to on, causes \fBmwm\fP to always honor program |
| 1295 |
specified position\&. Setting this resource to off, causes \fBmwm\fP |
| 1296 |
to always ignore program specified position\&. Setting this resource to the |
| 1297 |
default value of nonzero cause \fBmwm\fP to honor program specified |
| 1298 |
position other than (0,0)\&. |
| 1299 |
.IP "\fIwindowMenu\fP\ (class\ \fIWindowMenu\fP)" 10 |
| 1300 |
This resource indicates the name of the menu pane that is posted when |
| 1301 |
the window menu is popped up (usually by pressing button 1 on the window |
| 1302 |
menu button on the client window frame)\&. Menu panes are specified in the \fBmwm\fP resource description file\&. Window menus can be customized on |
| 1303 |
a client class basis by creating custom menus in your \fBmwmrc\fP |
| 1304 |
file (see \fBmwmrc\fP(4) and specifying resources to activate |
| 1305 |
the custom menus\&. The resources have the form \fIMwm*\fP \fBclient_name_or_class\fP\fI*windowMenu\fP\&. The default |
| 1306 |
value of this resource is DefaultWindowMenu\&. |
| 1307 |
.SS "Resource Description File" |
| 1308 |
.PP |
| 1309 |
The \fBmwm\fP resource description file is a supplementary |
| 1310 |
resource file that contains resource descriptions that are referred to by |
| 1311 |
entries in the resource manager property (see \fBxrdb\fP(1) and |
| 1312 |
the defaults files (\fB\&.Xdefaults\fP, \fBapp-defaults/Mwm\fP )\&. It contains descriptions of resources that are to be used by \fBmwm\fP, and that cannot be easily encoded in the defaults files (a |
| 1313 |
bitmap file is an analogous type of resource description file)\&. A particular \fBmwm\fP resource description file can be selected using the |
| 1314 |
\fIconfigFile\fP resource\&. |
| 1315 |
.PP |
| 1316 |
The following types of resources can be described in the \fBmwm\fP resource description file: |
| 1317 |
.IP "\fIButtons\fP" 10 |
| 1318 |
Window manager functions can be bound (associated) with button events\&. |
| 1319 |
.IP "\fIKeys\fP" 10 |
| 1320 |
Window manager functions can be bound (associated) with key press events\&. |
| 1321 |
.IP "\fIMenus\fP" 10 |
| 1322 |
Menu panes can be used for the window menu and other menus posted with |
| 1323 |
key bindings and button bindings\&. |
| 1324 |
.IP "" 10 |
| 1325 |
The \fBmwm\fP resource description file is described in \fBmwmrc\fP(4)\&. |
| 1326 |
.SS "Environment" |
| 1327 |
.PP |
| 1328 |
The \fBmwm\fP window manager uses the environment variable \fBHOME\fP specifying the user\&'s home directory\&. |
| 1329 |
.PP |
| 1330 |
The \fBmwm\fP window manager uses the environment variable \fBLANG\fP specifying the user\&'s choice of language |
| 1331 |
for the \fBmwm\fP message catalog and the \fBmwm\fP |
| 1332 |
resource description file\&. |
| 1333 |
.PP |
| 1334 |
The \fBmwm\fP window uses the environment variable \fBXFILESEARCHPATH\fP, \fBXUSERFILESEARCHPATH\fP, \fBXAPPLRESDIR\fP, \fBXENVIRONMENT\fP, \fBLANG\fP, and \fBHOME\fP in determining search paths for resource defaults files\&. |
| 1335 |
The \fBmwm\fP window manager may also us \fBXBMLANGPATH\fP to search for bitmap files\&. |
| 1336 |
.PP |
| 1337 |
The \fBmwm\fP window manager reads the \fB$HOME/\&.motifbind\fP |
| 1338 |
file if it exists to install a virtual key bindings property on |
| 1339 |
the root window\&. For more information on the content of the \fB\&.motifbind\fP file, see |
| 1340 |
.PP |
| 1341 |
The \fBmwm\fP window manager uses the environment variable |
| 1342 |
\fBMWMSHELL\fP (or \fBSHELL\fP, \fIif\fP \fBMWMSHELL\fP is not set), specifying |
| 1343 |
the shell to use when executing commands via the \fBf\&.exec\fP |
| 1344 |
function\&. |
| 1345 |
.SS "Files" |
| 1346 |
.PP |
| 1347 |
\fB/usr/X11R6/lib/X11/$LANG/system\&.mwmrc\fP |
| 1348 |
.PP |
| 1349 |
\fB/usr/X11R6/lib/X11/system\&.mwmrc\fP |
| 1350 |
.PP |
| 1351 |
\fB/usr/X11R6/lib/X11/app-defaults/Mwm\fP |
| 1352 |
.PP |
| 1353 |
\fB$HOME/Mwm\fP |
| 1354 |
.PP |
| 1355 |
\fB$HOME/$LANG/\&.mwmrc\fP |
| 1356 |
.PP |
| 1357 |
\fB$HOME/\&.mwmrc\fP |
| 1358 |
.SS "RELATED INFORMATION" |
| 1359 |
.PP |
| 1360 |
\fBVendorShell\fP(3), \fBVirtualBindings\fP(3), \fBX\fP(1), \fBXmInstallImage\fP(3), \fBxrdb\fP(1)\&. |
| 1361 |
...\" created by instant / docbook-to-man, Sun 22 Dec 1996, 20:15 |