/usr/dt/share/man/cat4/dtwmrc.4(/usr/dt/share/man/cat4/dtwmrc.4)
dtwmrc(4) DEVICES AND NETWORK INTERFACES dtwmrc(4)
NAME
dtwmrc - the dtwm Window Manager Resource Description File
DESCRIPTION
The dtwmrc window manager is a supplementary resource file
that controls much of the behavior of the TED window manager
dtwm. It contains descriptions of resources that cannot
easily be written using standard X Window System, Version 11
resource syntax. The resource description file contains
entries that are referred to by X resources in defaults
files (for example, /usr/dt/app-defaults/$LANG/Dtwm) or in
the RESOURCE_MANAGER property on the root window.
For example, the resource description file enables you to
specify different types of window menus; however, an X
resource is used to specify which of these window menus the
dtwm should use for a particular window.
The specifications of the resource description file sup-
ported by the dtwm workspace manager are a strict superset
of the specifications supported by the OSF Motif Window
Manager (mwm 1.2.4). In other words, the system.mwmrc or
$HOME/.mwmrc file that you've used for mwm is easily made
usable by dtwm.
To merge your personal mwm resource specifications into
dtwm:
o Copy either /etc/dt/config/$LANG/sys.dtwmrc or
/usr/dt/config/$LANG/sys.dtwmrc to
$HOME/.dt/dtwmrc.
o Use a text editor to move menu definitions, key
bindings, and button bindings from your .mwmrc
file to your dtwmrc file. To merge your key and
button bindings, you'll need to augment the key
and button bindings that are referenced by dtwm
by default (refer to buttonBindings and keyBind-
ings resources in the dtwm app-defaults file
/usr/dt/app-defaults/$LANG/Dtwm). To replace the
key or button bindings, you'll also need to
modify your personal keyBindings and buttonBind-
ings resources.
o Restart dtwm.
Location
The workspace manager searches for one of the following
resource description files, where $LANG is the value of the
language environment on a per-user basis:
$HOME/.dt/$LANG/dtwmrc
$HOME/.dt/dtwmrc
Unix System LaboratoLast change: 1 August 1995 1
dtwmrc(4) DEVICES AND NETWORK INTERFACES dtwmrc(4)
/etc/dt/config/$LANG/sys.dtwmrc
/etc/dt/config/sys.dtwmrc
/usr/dt/config/$LANG/sys.dtwmrc
/usr/dt/config/sys.dtwmrc
The first file found is the first used.
If no file is found, a set of built-in specifications is
used.
A particular resource description file can be selected using
the configFile resource.
The following shows how a different resource description
file can be specified from the command line:
/usr/dt/bin/dtwm -xrm "Dtwm*configFile: mydtwmrc"
Resource Types
The following types of resources can be described in the
dtwm resource description file:
Buttons Workspace manager functions can be bound
(associated) with button events.
Keys Workspace manager functions can be bound
(associated) with key press events.
Menus Menu panes can be used for the window menu
and other menus posted with key bindings
and button bindings.
DTWM RESOURCE DESCRIPTION FILE SYNTAX
The dtwm resource description file is a standard text file
that contains items of information separated by blanks,
tabs, and new lines characters. Blank lines are ignored.
Items or characters can be quoted to avoid special interpre-
tation (for example, the comment character can be quoted to
prevent it from being interpreted as the comment character).
A quoted item can be contained in double quotes (" ").
Single characters can be quoted by preceding them by the
back-slash character (\), except for workspace names, which
may contain no back-slash characters. If a line ends with a
back-slash, the next line is considered a continuation of
that line.
All text from an unquoted # to the end of the line is
regarded as a comment and is not interpreted as part of a
resource description. If ! is the first character in a
line, the line is regarded as a comment.
Unix System LaboratoLast change: 1 August 1995 2
dtwmrc(4) DEVICES AND NETWORK INTERFACES dtwmrc(4)
Workspace Manager Functions
Workspace manager functions can be accessed with button and
key bindings, and with workspace manager menus. Functions
are indicated as part of the specifications for button and
key binding sets, and menu panes. The function specifica-
tion has the following syntax:
function = function_name [function_args]
function_name = workspace manager function
function_args = {quoted_item | unquoted_item}
The following functions are supported. If a function is
specified that isn't one of the supported functions then it
is interpreted by dtwm as f.nop.
f.action This function causes the specified action
to be invoked by means of the message
server.
f.beep This function causes a beep.
f.circle_down [icon | window]
This function causes the window or icon
that is on the top of the window stack to
be put on the bottom of the window stack
(so that it is no longer obscuring any
other window or icon). This function
affects only those windows and icons that
are obscuring other windows and icons, or
that are obscured by other windows and
icons. Secondary windows (that is, tran-
sient windows) are restacked with their
associated primary window. Secondary win-
dows always stay on top of the associated
primary window and there can be no other
primary windows between the secondary win-
dows and their primary window. If an icon
function argument is specified, then the
function applies only to icons. If a win-
dow function argument is specified then
the function applies only to windows.
f.circle_up [icon | window]
This function raises the window or icon on
the bottom of the window stack (so that it
is not obscured by any other windows).
This function affects only those windows
and icons that are obscuring other windows
and icons, or that are obscured by other
windows and icons. Secondary windows
(that is, transient windows) are restacked
with their associated primary window. If
Unix System LaboratoLast change: 1 August 1995 3
dtwmrc(4) DEVICES AND NETWORK INTERFACES dtwmrc(4)
an icon function argument is specified
then the function applies only to icons.
If an window function argument is speci-
fied then the function applies only to
windows.
f.create_workspace
This function creates a new workspace.
The new workspace name is generated
automatically and is of the form ws_n
where n is an integer.
f.delete_workspace
This function deletes the current
workspace. Windows that reside only in
this workspace will be moved to the next
workspace. If the last workspace is being
deleted, then windows will be moved to the
first workspace.
f.exec command (or ! command)
This function causes command to be exe-
cuted (using the value of the $MWMSHELL or
$SHELL environment variable if set; other-
wise, /usr/bin/sh). The ! notation can be
used in place of the f.exec function name.
f.focus_color This function sets the colormap focus to a
client window. If this function is done
in a root context, then the default color-
map (setup by the X Window System for the
screen where dtwm is running) is installed
and there is no specific client window
colormap focus. This function is treated
as f.nop if colormapFocusPolicy is not
explicit.
f.focus_key This function sets the keyboard input
focus to a client window or icon. This
function is treated as f.nop if keyboard-
FocusPolicy is not explicit or the func-
tion is executed in a root context.
f.goto_workspace workspace
This function causes the workspace manager
to switch to the workspace named by
workspace. If no workspace exists by the
specified name, then no action occurs.
Note that adding and deleting workspaces
dynamically and affect this function.
f.help [topic [volume]]
Unix System LaboratoLast change: 1 August 1995 4
dtwmrc(4) DEVICES AND NETWORK INTERFACES dtwmrc(4)
This function displays help on the speci-
fied topic and volume. If no volume is
given, then the workspace manager volume
is assumed. If no topic is given, then
help on the front panel is shown.
f.help_mode This function causes the workspace manager
to enter into help mode. In help mode, the
pointer changes shape to indicate that the
window manager is waiting for you to
select a front panel control. Any help
defined for the control is then shown in a
help window.
f.kill This function is used to close application
windows. The actual processing that
occurs depends on the protocols that the
application observes. The application
lists the protocols it observes in the
WM_PROTOCOLS property on its top level
window.
If the application observes the
WM_DELETE_WINDOW protocol, it is sent a
message that requests the window be
deleted.
If the application observes both
WM_DELETE_WINDOW and WM_SAVE_YOURSELF, it
is sent one message requesting the window
be deleted and another message advising it
to save its state.
If the application observes only the
WM_SAVE_YOURSELFprotocol, it is sent a
message advising it to save its state.
After a delay (specified by the resource
quitTimeout), the application's connection
to the X server is terminated.
If the application observes neither of
these protocols, its connection to the X
server is terminated.
f.lower [-client | within | freeFamily]
This function lowers a primary window to
the bottom of the global window stack
(where it obscures no other window) and
lowers the secondary window (transient
window or dialog box) within the client
family. The arguments to this function
are mutually exclusive.
Unix System LaboratoLast change: 1 August 1995 5
dtwmrc(4) DEVICES AND NETWORK INTERFACES dtwmrc(4)
The client argument indicates the name or
class of a client to lower. The name or
class of a client appears in the WM_CLASS
property on the client's top-level window.
If the client argument is not specified,
the context that the function was invoked
in indicates the window or icon to lower.
Specifying within lowers the secondary
window within the family (staying above
the parent) but does not lower the client
family in the global window stack.
Specifying freeFamily lowers the window to
the bottom of the global windows stack
from its local family stack.
f.marquee_selection
This function is only useful in conjunc-
tion with the TED file manager (see
dtfile(1)). It enables selection of file
manager objects that have been placed on
the root window. It must be bound to a
button when used.
f.maximize This function causes a client window to be
displayed with its maximum size. Refer to
the maximumClientSize, maximumMaximumSize,
and limitResize resources in dtwm(1).
f.menu menu_name
This function associates a cascading
(pull-right) menu with a menu pane entry
or a menu with a button or key binding.
The menu_name function argument identifies
the menu to be used.
f.minimize This function causes a client window to be
minimized (iconified). When a window is
minimized with no icon box in use, and if
the lowerOnIconify resource has the value
True (the default), the icon is placed on
the bottom of the window stack (such that
it obscures no other window). If an icon
box is used, then the client's icon
changes to its iconified form inside the
icon box. Secondary windows (that is,
transient windows) are minimized with
their associated primary window. There is
only one icon for a primary window and all
its secondary windows.
Unix System LaboratoLast change: 1 August 1995 6
dtwmrc(4) DEVICES AND NETWORK INTERFACES dtwmrc(4)
f.move This function initiates an interactive
move of a client window.
f.next_cmap This function installs the next colormap
in the list of colormaps for the window
with the colormap focus.
f.next_key [icon | window | transient]
This function sets the keyboard input
focus to the next window/icon in the set
of windows/icons managed by the workspace
manager (the ordering of this set is based
on the stacking of windows on the screen).
This function is treated as f.nop if key-
boardFocusPolicy is not explicit. The
keyboard input focus is only moved to win-
dows that do not have an associated secon-
dary window that is application modal. If
the transient argument is specified, then
transient (secondary) windows are
traversed (otherwise, if only window is
specified, traversal is done only to the
last focused window in a transient group).
If an icon function argument is specified,
then the function applies only to icons.
If a window function argument is speci-
fied, then the function applies only to
windows.
f.next_workspace
This function causes the workspace manager
to switch to the next workspace. If the
last workspace is currently active, then
this function will switch to the first
workspace.
f.nop This function does nothing.
f.normalize This function causes a client window to be
displayed with its normal size. Secondary
windows (that is, transient windows) are
placed in their normal state along with
their associated primary window.
f.normalize_and_raise
This function causes a client window to be
displayed with its normal size and raised
to the top of the window stack. Secondary
windows (that is, transient windows) are
placed in their normal state along with
their associated primary window.
Unix System LaboratoLast change: 1 August 1995 7
dtwmrc(4) DEVICES AND NETWORK INTERFACES dtwmrc(4)
f.occupy_all This function causes the associated window
to be placed in all workspaces.
f.pack_icons This function is used to relayout icons
(based on the layout policy being used) on
the root window or in the icon box. In
general this causes icons to be "packed"
into the icon grid.
f.pass_keys This function is used to enable/disable
(toggle) processing of key bindings for
workspace manager functions. When it dis-
ables key binding processing all keys are
passed on to the window with the keyboard
input focus and no workspace manager func-
tions are invoked. If the f.pass_keys
function is invoked with a key binding to
disable key binding processing the same
key binding can be used to enable key
binding processing.
f.post_wmenu This function is used to post the window
menu. If a key is used to post the window
menu and a window menu button is present,
the window menu is automatically placed
with its top-left corner at the bottom-
left corner of the window menu button for
the client window. If no window menu but-
ton is present, the window menu is placed
at the top-left corner of the client win-
dow.
f.prev_cmap This function installs the previous color-
map in the list of colormaps for the win-
dow with the colormap focus.
f.prev_key [icon | window | transient]
This function sets the keyboard input
focus to the previous window/icon in the
set of windows/icons managed by the
workspace manager (the ordering of this
set is based on the stacking of windows on
the screen). This function is treated as
f.nop if keyboardFocusPolicy is not expli-
cit. The keyboard input focus is only
moved to windows that do not have an asso-
ciated secondary window that is applica-
tion modal. If the transient argument is
specified, then transient (secondary) win-
dows are traversed (otherwise, if only
window is specified, traversal is done
only to the last focused window in a
Unix System LaboratoLast change: 1 August 1995 8
dtwmrc(4) DEVICES AND NETWORK INTERFACES dtwmrc(4)
transient group). If an icon function
argument is specified then the function
applies only to icons. If an window func-
tion argument is specified then the func-
tion applies only to windows.
f.prev_workspace
This function causes the workspace manager
to switch to the previous workspace. If
the first workspace is currently active,
then this function switches to the last
workspace.
f.quit_mwm This function terminates dtwm (but NOT the
X window system).
f.raise [-client | within | freeFamily]
This function raises a primary window to
the top of the global window stack (where
it is obscured by no other window) and
raises the secondary window (transient
window or dialog box) within the client
family. The arguments to this function
are mutually exclusive.
The client argument indicates the name or
class of a client to lower. If the client
is not specified, the context that the
function was invoked in indicates the win-
dow or icon to lower.
Specifying within raises the secondary
window within the family but does not
raise the client family in the global win-
dow stack.
Specifying freeFamily raises the window to
the top of its local family stack and
raises the family to the top of the global
window stack.
f.raise_lower [within | freeFamily]
This function raises a primary window to
the top of the global window stack if it
is partially obscured by another window;
otherwise, it lowers the window to the
bottom of the window stack. The arguments
to this function are mutually exclusive.
Specifying within raises a secondary win-
dow within the family (staying above the
parent window), if it is partially
Unix System LaboratoLast change: 1 August 1995 9
dtwmrc(4) DEVICES AND NETWORK INTERFACES dtwmrc(4)
obscured by another window in the
application's family; otherwise, it lowers
the window to the bottom of the family
stack. It has no effect on the global
window stacking order.
Specifying freeFamily raises the window to
the top of its local family stack, if
obscured by another window, and raises the
family to the top of the global window
stack; otherwise, it lowers the window to
the bottom of its local family stack and
lowers the family to the bottom of the
global window stack.
f.refresh This function causes all windows to be
redrawn.
f.refresh_win This function causes a client window to be
redrawn.
f.remove This function causes a client window to be
removed from the current workspace. If
the client window exists only in this
workspace, no action occurs.
f.resize This function initiates an interactive
resize of a client window.
f.restore This function restores the previous state
of an icon's associated window. If a max-
imized window is iconified, then f.restore
restores it to its maximized state. If a
normal window is iconified, then f.restore
restores it to its normalized state.
f.restore_and_raise
This function restores the previous state
of an icon's associated window and raises
the window to the top of the window stack.
If a maximized window is iconified, then
f.restore_and_raise restores it to its
maximized state and raises it to the top
of the window stack. If a normal window
is iconified, then f.restore_and_raise
restores it to its normalized state and
raises it to the top of the window stack.
2f.restart This function causes dtwm to be restarted
(effectively terminated and re-executed).
Restart is necessary for dtwm to incor-
porate changes in both the dtwmrc file and
Unix System LaboratoLast change: 1 August 1995 10
dtwmrc(4) DEVICES AND NETWORK INTERFACES dtwmrc(4)
X resources.
f.screen [next | prev | back | screen_number]
This function causes the pointer to be
warp to a specific screen number or to the
next, previous, or last visited (back)
screen. The arguments to this function
are mutually exclusive.
The screen_number argument indicates the
screen number that the pointer is to be
warped. Screens are numbered starting
from screen 0.
Specifying next cause the pointer to warp
to the next managed screen (skipping over
any unmanaged screens).
Specifying prev cause the pointer to warp
to the previous managed screen (skipping
over any unmanaged screens).
Specifying back cause the pointer to warp
to the last visited screen.
f.send_msg message_number
This function sends an XClientMessageEvent
of type _MOTIF_WM_MESSAGES with
message_type set to message_number. The
client message is sent only if
message_number is included in the client's
_MOTIF_WM_MESSAGES property. A menu item
label is grayed out if the menu item is
used to do f.send_msg of a message that is
not included in the client's
_MOTIF_WM_MESSAGES property.
f.separator This function causes a menu separator to
be put in the menu pane at the specified
location (the label is ignored).
f.set_behavior This function causes the workspace manager
to restart with the default behavior (if a
custom behavior is configured) or a custom
behavior (if a default behavior is config-
ured). By default this is bound to
Shift Ctrl Alt <Key>!.
f.title This function inserts a title in the menu
pane at the specified location.
f.toggle_frontpanel
Unix System LaboratoLast change: 1 August 1995 11
dtwmrc(4) DEVICES AND NETWORK INTERFACES dtwmrc(4)
If the front panel is in the normal state,
this function causes it to be minimized.
If the front panel is minimized, this
function will change it to the normal
state.
f.version This function causes the workspace manager
to display its release version in a dialog
box.
f.workspace_presence
This function displays the workspace pres-
ence (or "Occupy Workspace") dialog box.
This dialog allows you to view and set the
workspace in which a particular window
resides. The root context is disallowed
for this function.
Function Constraints
Each function may be constrained as to which resource types
can specify the function (for example, menu pane) and also
what context the function can be used in (for example, the
function is done to the selected client window). Function
contexts are:
root No client window or icon has been selected
as an object for the function.
window A client window has been selected as an
object for the function. This includes
the window's title bar and frame. Some
functions are applied only when the window
is in its normalized state (for example,
f.maximize) or its maximized state (for
example, f.normalize).
icon An icon has been selected as an object for
the function.
If a function is specified in a type of resource where it is
not supported or is invoked in a context that does not apply
then the function is treated as f.nop. The following table
indicates the resource types and function contexts in which
workspace manager functions apply.
____________________________________________________________________________
Function Contexts Resources
____________________________________________________________________________
f.action root,icon,window button,key,menu
f.beep root,icon,window button,key,menu
f.circle_down root,icon,window button,key,menu
f.circle_up root,icon,window button,key,menu
Unix System LaboratoLast change: 1 August 1995 12
dtwmrc(4) DEVICES AND NETWORK INTERFACES dtwmrc(4)
f.create_workspace root,icon,window button,key,menu
f.delete_workspace root,icon,window button,key,menu
f.exec root,icon,window button,key,menu
f.focus_color root,icon,window button,key,menu
f.focus_key root,icon,window button,key,menu
f.goto_workspace root,icon,window button,key,menu
f.help root,icon,window button,key,menu
f.help_mode root,icon,window button,key,menu
f.kill icon,window button,key,menu
f.lower root,icon,window button,key,menu
f.marquee_selection root button
f.maximize icon,window(normal) button,key,menu
f.menu root,icon,window button,key,menu
f.minimize window button,key,menu
f.move icon,window button,key,menu
f.next_cmap root,icon,window button,key,menu
f.next_key root,icon,window button,key,menu
f.next_workspace root,icon,window button,key,menu
f.nop root,icon,window button,key,menu
f.normalize icon,window(maximized) button,key,menu
f.normalize_and_raise icon,window button,key,menu
f.occupy_all icon,window button,key,menu
f.pack_icons root,icon,window button,key,menu
f.pass_keys root,icon,window button,key,menu
f.post_wmenu root,icon,window button,key
f.prev_cmap root,icon,window button,key,menu
f.prev_key root,icon,window button,key,menu
f.prev_workspace root,icon,window button,key,menu
f.quit_dtwm root button,key,menu (root only)
f.raise root,icon,window button,key,menu
f.raise_lower icon,window button,key,menu
f.refresh root,icon,window button,key,menu
f.refresh_win window button,key,menu
f.remove root,icon,window button,key,menu
f.resize window button,key,menu
f.restart root button,key,menu (root only)
f.restore icon,window button,key,menu
f.restore_and_raise icon,window button,key,menu
f.screen root,icon,window button,key,menu
f.send_msg icon,window button,key,menu
f.separator root,icon,window menu
f.set_behavior root,icon,window button,key,menu
f.title root,icon,window menu
f.toggle_frontpanel root,icon,window button,key,menu
f.version root,icon,window button,key,menu
f.workspace_presence window button,key,menu
____________________________________________________________________________
WORKSPACE MANAGER EVENT SPECIFICATION
Events are indicated as part of the specifications for but-
ton and key binding sets, and menu panes.
Unix System LaboratoLast change: 1 August 1995 13
dtwmrc(4) DEVICES AND NETWORK INTERFACES dtwmrc(4)
Button events have the following syntax:
button =~[modifier_list]<button_event_name>
modifier_list =~modifier_name {modifier_name}
The following table indicates the values that can be used
for modifier_name. Note that [Alt] and [Meta] can be used
interchangably on some hardware.
______________________
Modifier Description
______________________
Ctrl Control Key
Shift Shift Key
Alt Alt Key
Meta Meta Key
Mod1 Modifier1
Mod2 Modifier2
Mod3 Modifier3
Mod4 Modifier4
Mod5 Modifier5
______________________
Locking modifiers are ignored when processing button and key
bindings. The following table lists keys that are inter-
preted as locking modifiers. The X server may map some of
these symbols to the Mod1 - Mod5 modifier keys. These keys
may or may not be available on your hardware:
Key Symbol
Caps Lock
Shift Lock
Kana Lock
Num Lock
Scroll Lock
The following table indicates the values that can be used
for button_event_name.
_______________________________________
Button Description
_______________________________________
Btn1Down Button 1 Press
Btn1Up Button 1 Release
Btn1Click Button 1 Press and Release
Btn1Click2 Button 1 Double Click
Btn2Down Button 2 Press
Btn2Up Button 2 Release
Btn2Click Button 2 Press and Release
Btn2Click2 Button 2 Double Click
Btn3Down Button 3 Press
Btn3Up Button 3 Release
Btn3Click Button 3 Press and Release
Unix System LaboratoLast change: 1 August 1995 14
dtwmrc(4) DEVICES AND NETWORK INTERFACES dtwmrc(4)
Btn3Click2 Button 3 Double Click
Btn4Down Button 4 Press
Btn4Up Button 4 Release
Btn4Click Button 4 Press and Release
Btn4Click2 Button 4 Double Click
Btn5Down Button 5 Press
Btn5Up Button 5 Release
Btn5Click Button 5 Press and Release
Btn5Click2 Button 5 Double Click
_______________________________________
Key events that are used by the workspace manager for menu
mnemonics and for binding to workspace manager functions are
single key presses; key releases are ignored. Key events
have the following syntax:
key =~[modifier_list]<Key>key_name
modifier_list =~modifier_name {modifier_name}
All modifiers specified are interpreted as being exclusive
(this means that only the specified modifiers can be present
when the key event occurs). Modifiers for keys are the same
as those that apply to buttons. The key_name is an X11
keysym name. Keysym names can be found in the keysymdef.h
file (remove the XK_ prefix).
BUTTON BINDINGS
The buttonBindings resource value is the name of a set of
button bindings that are used to configure workspace manager
behavior. A workspace manager function can be done when a
button press occurs with the pointer over a framed client
window, an icon or the root window. The context for indi-
cating where the button press applies is also the context
for invoking the workspace manager function when the button
press is done (significant for functions that are context
sensitive).
The button binding syntax is
Buttons bindings_set_name
{
button context function
button context function
.
.
button context function
}
The syntax for the context specification is:
context = object[|context]
object = root | icon | window | title | frame | border | app
Unix System LaboratoLast change: 1 August 1995 15
dtwmrc(4) DEVICES AND NETWORK INTERFACES dtwmrc(4)
The context specification indicates where the pointer must
be for the button binding to be effective. For example, a
context of window indicates that the pointer must be over a
client window or window management frame for the button
binding to be effective. The frame context is for the win-
dow management frame around a client window (including the
border and titlebar), the border context is for the border
part of the window management frame (not including the
titlebar), the title context is for the title area of the
window management frame, and the app context is for the
application window (not including the window management
frame).
If an f.nop function is specified for a button binding, the
button binding is not done.
KEY BINDINGS
The keyBindings resource value is the name of a set of key
bindings that are used to configure workspace manager
behavior. A window manager function can be done when a par-
ticular key is pressed. The context in which the key binding
applies is indicated in the key binding specification. The
valid contexts are the same as those that apply to button
bindings.
The key binding syntax is:
Keys bindings_set_name
{
key context function
key context function
.
.
key context function
}
If an f.nop function is specified for a key binding, the key
binding is not done. If an f.post_wmenu or f.menu function
is bound to a key, dtwm automatically uses the same key for
removing the menu from the screen after it has been popped
up.
The context specification syntax is the same as for button
bindings with one addition. The context ifkey may be speci-
fied for binding keys that may not be available on all
displays. If the key is not available and if ifkey is in
the context, then reporting of the error message to the
error log is suppressed. This feature is useful for
networked, heterogeneous environments.
For key bindings, the frame, title, border, and app contexts
are equivalent to the window context. The context for a key
Unix System LaboratoLast change: 1 August 1995 16
dtwmrc(4) DEVICES AND NETWORK INTERFACES dtwmrc(4)
event is the window or icon that has the keyboard input
focus (root if no window or icon has the keyboard input
focus).
MENU PANES
Menus can be popped up using the f.post_wmenu and f.menu
workspace manager functions. The context for workspace
manager functions that are done from a menu is root, icon or
window depending on how the menu was popped up. In the case
of the window menu or menus popped up with a key binding,
the location of the keyboard input focus indicates the con-
text. For menus popped up using a button binding, the con-
text of the button binding is the context of the menu.
The menu pane specification syntax is:
Menu menu_name
{
label [mnemonic] [accelerator] function
label [mnemonic] [accelerator] function
.
.
label [mnemonic] [accelerator] function
}
Each line in the Menu specification identifies the label for
a menu item and the function to be done if the menu item is
selected. Optionally a menu button mnemonic and a menu but-
ton keyboard accelerator may be specified. Mnemonics are
functional only when the menu is posted and keyboard traver-
sal applies.
The label may be a string or a bitmap file. The label
specification has the following syntax:
label = text | bitmap_file
bitmap_file = @file_name
text = quoted_item | unquoted_item
The string encoding for labels must be compatible with the
menu font that is used. Labels are greyed out for menu
items that do the f.nop function or an invalid function or a
function that doesn't apply in the current context.
A mnemonic specification has the following syntax:
mnemonic = _character
The first matching character in the label is underlined. If
there is no matching character in the label, no mnemonic is
registered with the workspace manager for that label.
Although the character must exactly match a character in the
Unix System LaboratoLast change: 1 August 1995 17
dtwmrc(4) DEVICES AND NETWORK INTERFACES dtwmrc(4)
label, the mnemonic does not execute if any modifier (such
as Shift) is pressed with the character key.
The accelerator specification is a key event specification
with the same syntax as is used for key bindings to
workspace manager functions.
INCLUDING FILES
You may include other files into your dtwmrc file by using
the include construct. For example,
INCLUDE
{
/usr/local/shared/dtwm.menus
/home/kmt/personal/my.bindings
}
causes the files named to be read in and interpreted in
order as an additional part of the dtwmrc file.
Include is a top-level construct. It cannot be nested
inside another construct.
WARNINGS
Errors that occur during the processing of the resource
description file are recorded in: $HOME/.dt/errorlog. Be
sure to check this file if the appearance or behavior of
dtwm is not what you expect.
FILES
$HOME/.dt/$LANG/dtwmrc
$HOME/.dt/dtwmrc
/etc/dt/config/$LANG/sys.dtwmrc
/etc/dt/config/sys.dtwmrc
/usr/dt/config/$LANG/sys.dtwmrc
/usr/dt/config/sys.dtwmrc
$HOME/.dt/errorlog
RELATED INFORMATION
dtwm(1), mwm(1X), dtfile(1), X(1).
Unix System LaboratoLast change: 1 August 1995 18
See also dtwmrc(4)
Man(1) output converted with
man2html