jkh@ardent.UUCP (Jordan K. Hubbard) (06/06/88)
#! /bin/sh
# This is a shell archive. Remove anything before this line, then unpack
# it by saving it into a file and typing "sh file". To overwrite existing
# files, type "sh file -c". You can also feed this as standard input via
# unshar, or by typing "sh <file", e.g.. If this archive is complete, you
# will see the following message at the end:
# "End of archive 8 (of 8)."
# Contents: awm.man
# Wrapped by jkh@ardent on Sun Jun 5 18:56:38 1988
PATH=/bin:/usr/bin:/usr/ucb ; export PATH
if test -f 'awm.man' -a "${1}" != "-c" ; then
echo shar: Will not clobber existing file \"'awm.man'\"
else
echo shar: Extracting \"'awm.man'\" \(39430 characters\)
sed "s/^X//" >'awm.man' <<'END_OF_FILE'
X.de EX \"Begin example
X.ne 5
X.if n .sp 1
X.if t .sp .5
X.nf
X.in +.5i
X..
X.de EE
X.fi
X.in -.5i
X.if n .sp 1
X.if t .sp .5
X..
X.TH AWM 1 "20 March 1988" "X Version 11"
X.SH NAME
X.PP
awm - Window Manager Client Application of X
X.PP
X.SH SYNTAX
X.PP
X\fBawm \fP [-f \fIfilename\fP] [-e \fIexecfile\fP] [-b]
X.PP
X.SH DESCRIPTION
X.PP
The \fIawm\fP command is a window manager client
application of the window
server. It is heavily based on an earlier work by M. Gancarz
of Digital Equipment Corporation (see the end of this document for
appropriate disclaimers).
X.PP
When the command is invoked, it traces a predefined search path
to locate any \fIawm\fP startup files. If no startup files
exist, \fIawm\fP initializes its built-in default file.
X.PP
If startup files exist in any of the following locations,
it adds the variables to the default variables.
In the case of contention, the variables in the last file found
override previous specifications. Files in the \fIawm\fP
search path are:
X.sp
X \fI$(LIBDIR)/awm/system.awmrc
X $HOME/.awmrc\fP
X.PP
To use only the settings defined in a single startup file,
include the variables, \fBresetbindings\fP, \fBresetmenus\fP and
X\fBresetgagdets\fP at the top of that specific startup file.
X.PP
X.SH ARGUMENTS
X.IP "[-f \fIfilename\fP]"
Names an alternate file as an \fIawm\fP startup file.
X.IP "[-e \fIexecfile\fP]"
Names a file to exec (typically a shell script invoking other clients) after
all startup files have been loaded. This is useful for minimizing the number of
map/unmaps that occur when titlebars are added.
X.IP "[-b]"
X
Causes awm to ignore the system startup file.
X.PP
X.SH STARTUP FILE VARIABLES
X.PP
Variables are typically entered first, at the top of the startup
file. Because of a merge with the resource manager, very few variables
are set here now. The directives \fBresetbindings\fP, \fBresetmenus\fP
and \fBresetgadgets\fP are still allowed, as are gadget declarations of
X the form:
X.IP \fBgadget[\fP\fIn\fB]\fP=\fIexpr\fP
X.nf
X
Where \fIn\fP is a positive integer indicating the gadget to initialize and
X\fIexpr\fP is one of the following:
X
X \fIstring\fP or "\fIstring\fP" [ ^ \fBattributes\fP ]
X Set the name of the gadget to \fIstring\fP. The name will be
X painted in the gadget box with the \fBgadget.font\fP resource
X or an overriding font attribute (see below).
X \fIstring\fP may contain imbeded non-alphanumeric characters
X in the form of \\\fI#\fP where \fI#\fP is 1 or more decimal digits (i.e. \\54)
X or \\\fIc\fP where \fIc\fP is a character in the standard C string
X literal set (i.e. n, r, t, f). This is useful if you've specified
X a gadget font with glyphs in it (such as cursor) and you want to paint
X a specific glyph from it in a gadget box. Many such glyphs are not
X represented by ascii characters.
X
X (\fIstring\fP) [ ^ \fBattributes\fP ]
X Load a pixmap from the file named by \fIstring\fP and
X tile the gadget with it (see also: \fBpath\fP).
X
X Additional \fBattributes\fP may be specified after a '^' (carat)
X character in the form:
X
X \fIoffset\fP|\fIgravity\fP|\fIforeground\fP|\fIbackground\fP|\fIfont\fP
X
X Any omitted parameters will be set to default values.
X
X \fIoffset\fP is an integer specifying how far to place this
X gadget from its nearest neighbor (or an edge). Default
X offset is \fBgadget.pad\fP, or 2 if \fBgadget.pad\fP is not
X defined.
X
X \fIgravity\fP is one of \fBNoGravity\fP, \fBLeftGravity\fP or
X \fBRightGravity\fP. \fBNoGravity\fP specifies that the gadget
X is to be placed opposite of wherever the last gadget was
X placed.
X \fBLeftGravity\fP specifies that the gadget should stick to
X the left of the title bar, \fBRightGravity\fP to the right.
X
X \fIforeground\fP and \fIbackground\fP specify the colors used to
X tile the gadget or draw the text. If the number of colors
X exceeds \fBmaxColors\fP, black and white will be used.
X
X \fIfont\fP is the name of the font you want the gadget's name
X drawn in. This overrides the \fBgadget.font\fP setting for this
X gadget.
X
X The default values for \fBattributes\fP are 0, NoGravity, black
X (\fBreverse\fP: white) and white (\fBreverse\fP: black), the setting
X of \fBgadget.font\fP.
X
X It is important to note that in the absence of a \fIgravity\fP specification
X (I.E. we've defaulted to \fBNoGravity\fP), the window manager will
X automatically place a gadget on the side opposite of the last gadget
X placed. If it's the first gadget placed, it will go to the right.
X Thus in the absence of any \fIgravity\fP (or \fIoffset\fP) specifications,
X the window manager will place gadgets in a right-left-right fashion
X until all gadgets have been placed.
X
X For example:
X
X gadget[0] = "die"
X gadget[1] = (resize.b) ^ 2 | red | orange
X gadget[2] = (iconbox.b) ^ | LeftGravity
X gadget[3] = "\\56" ^ | LeftGravity | green | black | cursor
X
X These declarations will create 4 gadget boxes, situated in the
X following manner:
X
X The first gadget box will be created wide enough to print the
X word "die" in it (in whatever gadget font has been defined) and
X will be placed on the right side (since it hasn't chosen a gravity)
X against the edge (since it hasn't chosen an offset).
X Background and foreground colors will be black and white
X (assignment depending on whether \fBreverse\fP is set).
X
X The second gadget box will be tiled with the contents of the
X file "resize.b" (assuming that it's a valid bitmap file) and
X will go on the left side (since it also has no gravity and the
X last one went on the right). It will be offset from the edge by 2
X pixels since there was an offset for it. Foreground will be
X red, background will be orange.
X
X The third gadget will be tiled with the contents of "iconbox.b"
X and will be placed against the second gadget on the left hand
X side since we specified a gravity. Colors will be black and white
X (depending on \fBreverse\fP).
X
X The fourth gadget will display glyph #56 from the cursor font
X in green and black (it's gumby of course).
X
X
X IMPORTANT: Gadgets may be declared in any order, but you are
X not allowed to leave gaps. I.E. it's perfectly acceptable to
X declare gadgets in the order 0, 2, 3, 1, but *not* legal to
X declare gadgets in the order 0, 3, 2, 4 as gadget #1 has been
X ommitted. This restriction may be removed in the future, but
X for now you'll get a diagnostic and awm will exit.
X
X.fi
All other variables controlling window manager behaviour are described in
the \fBX DEFAULTS\fP section of this man page.
X.PP
X.SH BINDING SYNTAX
X.PP
X"\fIfunction\fP=[\fIcontrol key(s)\fP]:[\fIcontext\fP]:\fImouse events\fP:\fI" menu name "\fP
X.sp
OR
X.sp
X"\fIfunction\fP=[\fIcontrol key(s)\fP]:[\fIcontext\fP]:\fImouse events\fP:\fI" text action "\fP
X.PP
XFunction and mouse events are required input. Menu name is
required with the \fIf.menu\fP function definition only.
Similarly, text action is required only with the \fIf.action\fP
function definition.
X.PP
X.SH Function
X.IP "\fBf.beep\fP" 15
emits a beep from the keyboard. Loudness is determined by
the volume variable.
X.IP \fBf.circledown\fP
causes the top window that is obscuring another
window to drop to the bottom of the stack of windows.
X.IP \fBf.circleup\fP
exposes the lowest window that is obscured by other
windows.
X.IP \fBf.continue\fP
releases the window server display action after you
stop action with the \fBf.pause\fP function.
X.IP \fBf.exit\fP
exits the window manager. If you've started \fBawm\fP from
xinit (actually sort of useful now that the \fB-e\fP flag
has been added), this will also exit the window system.
X.IP \fBf.focus\fP
directs all keyboard input to the selected window.
To reset the focus to all windows, invoke \fIf.focus\fP from the root
window.
X.IP \fBf.iconify\fP
when implemented from a window, this function converts the window
to its respective icon. When implemented from an icon,
f.iconify converts the icon to its respective window.
X.IP \fBf.lower\fP
lowers a window that is obstructing a window below it.
X.IP \fBf.menu\fP
invokes a menu. Enclose `menu name' in quotes if it
contains blank characters or parentheses.
X.EX 0
X.B
f.menu=[\fIcontrol key(s)\fP]:[\fIcontext \fP]:\fImouse events\fP:\fI" menu name "\fP
X.EE
X.IP \fBf.action\fP
Invokes a text action. `text' should be in quotes with a preceeding
X"action" character (one of '^', '!' or '|'). The syntax is identical to
menu text actions which are discussed in greater detail under the \fBMenus\fP
section of this document.
X.EX 0
X.B
f.action=[\fIcontrol key(s)\fP]:[\fIcontext \fP]:\fImouse events\fP:\fIaction" text "\fP
X.EE
X.IP \fBf.move\fP
moves a window or icon to a new location, which becomes the
default location.
X.IP \fBf.moveopaque\fP
moves a window or icon to a new screen location. When using this
function, the entire window or icon is moved to the new screen
location. The grid effect is not used with this function.
X.IP \fBf.newiconify\fP
allows you to create a window or icon and then position the window or
icon in a new default location on the screen.
X.IP \fBf.pause\fP
temporarily stops all display action. To release the screen and
immediately update all windows, use the \fBf.continue\fP function.
X.IP \fBf.pushdown\fP
moves a window down.
The distance of the push is determined by the push variables.
X.IP \fBf.pushleft\fP
moves a window to the left.
The distance of the push is determined by the push variables.
X.IP \fBf.pushright\fP
moves a window to the right.
The distance of the push is determined by the push variables.
X.IP \fBf.pushup\fP
moves a window up.
The distance of the push is determined by the push variables.
X.IP \fBf.raise\fP
raises a window that is being obstructed by a window
above it.
X.IP \fBf.refresh\fP
results in exposure events being sent to the window server clients
for all unobscured or partially obscured windows.
The windows will not refresh correctly if the exposure events
are not handled properly.
X.IP \fBf.neaten\fP
neatens the desktop using the RTL neaten package. See the \fBX DEFAULTS\fP
for the resources necessary to customize this somewhat complex feature.
This function only works if \fBawm\fP has been compiled with the -DNEATEN
flag (which compiles in the neaten package). Invoking this function without
this is a no-op (though a warning diagnostic is printed to stderr).
See the INSTALLATION document for more details.
X.IP \fBf.resize\fP
resizes an existing window. Note that some clients, notably
editors, react unpredictably if you resize the window while the
client is running.
X.IP \fBf.restart\fP
causes the window manager application to restart,
retracing the \fIawm\fP search path and initializing the variables it
finds.
X.IP \fBf.destroy\fP
calls XKillClient on the selected window. Use with caution!! Binding it to
naked mouse buttons is probably not a good idea!
X.IP \fBf.title\fP
puts a title bar on the selected window. Use the \fBtitle\fP variable to put titles
on all windows. This function is intended for those that don't want titles on everything,
just selected windows.
X.IP \fBf.notitle\fP
removes a titlebar from the selected window. This does not effect the setting of \fBtitle\fP.
X.IP \fBf.gadgets\fP
Puts gadget boxes in a title. Use the \fBgadgets\fP variable to put gadgets in all
titles.
X.IP \fBf.nogadgets\fP
removes gadget boxes from a title.
X.PP
X.SH Control Keys
X.PP
By default, the window manager uses meta as its control
key. It can also use ctrl, shift, lock, or null (no control key).
Control keys must be entered in lower case, and can be
abbreviated as: c, l, m, s for ctrl, lock, meta, and shift,
respectively.
X.PP
You can bind one, two, or no control keys to a function.
Use the bar (|) character to combine control keys.
X.PP
X.SH Context
X.PP
The context refers to the screen location of the cursor when a
command is initiated. When you include a context entry in a
binding, the
cursor must be in that context or the function will not be
activated.
The window manager recognizes the following seven contexts:
icon, window, root, title, gadget[\fIn\fP] (where \fIn\fP is the
gadget number), border and (null).
X.PP
The icon context refers to any icon and may be safely bound without
interfering with window events.
X
The window context refers to application windows and should be
used carefully to avoid usurping button events that applications
may want for their own purposes.
X
The root context refers to the root, or background window.
X
The title context refers to the titlebar area of a window, if
one exists.
X
The gadget context (with mandatory index) specifies a given
gadget box. Binding to a gadget that's undefined (not initialized to
anything) is an error.
X
The border context refers to the artificial border area created when
the resource \fBBC.width\fP is defined (see \fBBC.width\fP under
X\fBX DEFAULTS\fP). Using this context when no border area exists
X(I.E. \fBBC.width\fP is not defined) is a no-op.
X
A (null) context is indicated when the context field is left blank,
and allows a function to be invoked from any screen location. This
is basically equivalant to specifying all the possible contexts.
X
Combine contexts using the bar (|) character.
X
X.PP
X.SH Mouse Buttons
X.PP
Any of the following mouse buttons are accepted in
lower case and can be abbreviated as l, m, or r, respectively: left,
middle, right.
X.PP
With the specific button, you must identify
the action of that button. Mouse actions
can be:
X.IP "\fBdown\fP" 10
function occurs when the specified button is pressed down.
X.IP \fBup\fP
function occurs when the specified button is released.
X.IP "\fBdelta\fP" 10
indicates that the mouse must be moved the number of pixels specified
with the delta variable before the specified function is invoked.
The mouse can be moved in any direction
to satisfy the delta requirement.
X.PP
X.SH MENU DEFINITION
X.PP
After binding a set of function keys and a menu name to
X\fBf.menu\fP, you must define the menu to be invoked, using the
following syntax:
X.EX
X.B
X\fBmenu \fP= (\fIstring\fP) " \fImenu name\fP " {
X"\fIitem name\fP" : "\fIaction\fP"
X .
X .
X .
X}
X.EE
X.PP
The \fIstring\fP in parenthesis is an optional argument which
names a pixmap file (see also: \fBpath\fP) to use as
the menu title rather than just using the name of the menu. This
is generally only useful if you're using pixmaps for the menu
panes as well (see below). Though the \fImenu name\fP isn't displayed
when you specify \fIstring\fP, you still need to specify one for awm
to use when looking up the binding to it.
X
XEnter the \fImenu name\fP exactly the way it is entered with the
X\fBf.menu\fP function or the window manager will not recognize the link.
If the \fImenu name\fP contains blank strings, tabs or parentheses, it must
be quoted here and in the \fBf.menu\fP function entry. If you haven't
chosen to display a pixmap title in \fIstring\fP, the menu name will be
displayed at the top of the menu in whatever font has been chosen
for \fBmenu.boldFont\fP (or its default).
X
You can enter as many menu items as your screen is long. You
cannot scroll within menus.
X.PP
Any menu entry that contains quotes, special characters,
parentheses, tabs, or strings of blanks must be enclosed
in double quotes. Follow the item name by a colon (:).
X
A special case is an item surrounded by parenthesis, which
designates the \fIitem name\fP as the name of a pixmap file to
tile the menu pane with. Given a pixmap for the menu title as well
X(see above), it's possible to create menus that are totally
pictoral in nature. There are, however, two caveats. Due to the fact
that it's easier to do, the pixmaps are used as backgrounds
for the menu panes rather than painting them on whenever a given pane in
exposed. This has rather ugly consequences if one of the pixmaps
X(or a line of text if a pane is textual) is larger than the others.
Since the server replicates pixmaps over the entire window, it results
in a "wallpaper" effect on the smaller pixmaps. The solution is to make all
the pixmaps the same size and/or not mix in any text items that will need a
wider pane.
X
The second problem is that the Check-marks and pull-right indicators are
always displayed in fixed positions on the right and left edges of menu
panes. If your pixmaps try to use this real-estate, they may be partially
covered by a checkmark or pull-right pixmap. Design your menus with this
in mind.
X
X.PP
X.SH Menu Action
X.IP "Window manager functions" 10
Any function previously described. E.g., \fBf.move\fP or \fBf.iconify\fP.
Using f.menu results in a pull-right pane which you can use to "walk"
between menus (see below). A "walk" can be done by moving the cursor onto
the pull-right arrow displayed at the right edge of the pane, or by clicking
another button in the pane while holding the original one down.
X
X.IP "Walking menus"
Select the function f.menu and separate from the menu name with a colon (:)
I.E:
X.nf
menu = "foo" {
X...
Walking Menu: f.menu: "NextMenu"
X...
X}
X
X.fi
X.IP "Text actions"
There are two kinds of special "actions" involving arbitrary strings
of text. These are:
X
X.IP "Shell commands"
Begin with an exclamation point (!) and set to run in
background. You cannot include a new line character within a shell
command.
X.IP "Text strings"
Text strings are placed in the window server's cut buffer.
X.IP
Strings with a new line character must begin with an
up arrow (^), which is stripped during the copy operation.
X.IP
Strings without a new line must begin with the bar character (|),
which is stripped during the copy operation.
X.IP "Booleans"
Any boolean variable previously described. E.g., \fBnohilite\fP or \fBautoraise\fP.
The current state of a boolean variable in a menu will be indicated with
a check-mark (a check-mark means the boolean is set to TRUE).
X
X
SPECIAL NOTE:
X
Menus bound to title bars, gadget boxes or borders cause (where logical)
the selected menu action to occur automatically on the titled window
as opposed to having to select a window for the action. However, actions
requiring mouse tracking (I.E. move, resize) will usually *not* work well
in this context. While this limitation will be eliminated in the near future,
it is suggested that you use this feature to do things that do not
require mouse tracking, such as raise, lower, iconify, raise, etc etc.
X
X.PP
X.SH Color Defaults
X.PP
Colors default to the colors of the root window
under any of the following conditions:
X.sp
X1) If you run out of color map entries, either before or during an
invocation of \fIawm\fP.
X.sp
X2) If you specify a foreground or background color that does
not exist in the RGB color database (\fI$(LIBDIR)/rgb.txt\fP) both
the foreground and background colors default to the root window colors.
X.sp
X3) If you omit a foreground or background color,
both the foreground and background colors default to the root
window colors.
X.sp
X4) If the total number of colors specified in the resource database
exceeds the number specified in the \fImaxColors\fP variable.
X.sp
X5) If you specify no colors in the resource database.
X.bp
X.SH X DEFAULTS
X.PP
A number of variables that were previously specified in the .uwmrc file
have been moved out of the .awmrc file and are now gotten from
the resource database. When a value cannot be found, a default
X(compiled into awm) is substituted. The resource database is also
now queried to determine whether or not to title a given window. See
the end of the BOOLEANS section for details.
X
X
X.SH BOOLEANS
X.nf
X autoraise
X (boolean) automatially raise a window to the top when it gains the
X input focus. See also: \fBraiseDelay\fP
X Default is off.
X
X autoselect
X (boolean) specifies that the pointer be placed over the first
X item in a menu, rather than the title, when the menu is popped up.
X Default is off.
X
X gadgets
X (boolean) display gadgets in title bars, if any are declared.
X Default is off.
X
X freeze
X (boolean) lock out all other clients during certain window manager tasks,
X such as move and resize.
X Default is off.
X
X grid
X (boolean) display a finely ruled grid when positioning or resizing
X windows/icons.
X Default is off.
X
X hilite
X (boolean) causes the following actions to occur when a window gains the input
X focus:
X
X 1. Border color changes to white (or \fBreverse\fP).
X 2. If \fBshowName\fP is on:
X
X 2a. If \fBtitle.boldFont\fP is defined, the window name is redrawn
X in this font.
X
X 2b. If it's not, then the window name is redrawn in inverse video.
X
X 3. If \fBtitle.boldPixmap\fP is defined, the background of the title bar is
X set to it.
X
X 4. If \fBBC.boldPixmap\fP is defined, the background of the border
X context area is set to it.
X
X
X On focus out, the border color reverts to grey, the window name to \fBtitle.font\fP
X the title background to \fBtitle.pixmap\fP and the border context
X to \fBBC.pixmap\fP, respectively.
X Default is off.
X
X normali
X (boolean) make sure that icons created with \fBf.newiconify\fP stay wholly within
X the root window (on screen), regardless of attempted placement. If off, put icons
X wherever the cursor is placed.
X Default is on.
X
X normalw
X (boolean) make sure that windows mapped with \fBf.newiconify\fP are placed on-screen,
X regardless of cursor position. If off, put windows wherever the cursor is placed.
X Default is on.
X
X pushRelative
X (boolean) When a window is pushed, push 1/\fBpush\fP of the window.
X If off, move window \fBpush\fP pixels.
X Default is off.
X
X reverse
X (boolean) reverse background/foreground colors for titles, menus,
X gadget windows, popup windows, etc. In the absence of any color
X specifications, this results in black-on-white.
X Default is off.
X
X rootResizeBox
X (boolean) put the resize (popup) window in the upper left corner of the root
X window, rather than on the window being resized. This saves a potentially
X expensive refresh that would occur when the popup was unmapped. If your server
X supports save-unders, it's generally (but not always) better to turn \fBsaveUnder\fP
X on instead.
X Default is off.
X
X saveUnder
X (boolean) use save-unders for menus and pop-up windows. If the server does not
X support save-unders, this action does nothing.
X Default is off.
X
X showName
X (boolean) display the window name in a title (assuming that the window is titled
X in the first place).
X Default is on.
X
X titles
X (boolean) put title bars on all windows (both existing windows and new ones as
X they're created. See also: \fBf.title\fP
X Default is off.
X
X wall
X (boolean) restrict window movement to edges of screen (rootwindow).
X This feature is fairly handy and should probably be bound to a menu
X so that it can readily be turned on and off.
X Default is off.
X
X warpOnDeIconify
X (boolean) warp pointer to upper right corner of window on de-iconify.
X Default is off.
X
X warpOnIconify
X (boolean) warp pointer to center of icon on iconify.
X Default is off.
X
X warpOnRaise
X (boolean) warp pointer to upper left corner of window on raise.
X Default is off.
X
X zap
X (boolean) causes ghost lines to follow the window or icon from its previous
X location to its new location during a move, resize or iconify operation.
X Default is off.
X
X
X.SH NUMERIC
X.nf
X
X BC.width
X (int) number of pixels wide to make the border context. Though
X functions may be bound to the border context (see: \fBContext\fP)
X without setting this, they will be impossible to invoke due to the
X fact that there will be nothing to click on. The border context
X should not be confused with the actual window border. It is an
X artificial area around each window that resembles a border.
X Default is 0 (no border).
X
X BC.cursor
X (int) glyph (in decimal) to retrieve from cursor font for use in
X border context.
X Default is XC_cross
X
X delta
X (int) number of pixels that must be moved over before a "delta" action
X is taken (see: \fBBINDING SYNTAX\fP).
X Default is 1.
X
X gadget.pad
X (int) the number of pixels to pad a gadget from its neighbor if it has
X no offset defined.
X Default is 3.
X
X hIconPad
X (int) number of pixels to pad icon text horizontally.
X Default is 2.
X
X icon.borderWidth
X (int) width of icon border in pixels.
X Default is 2.
X
X maxColors
X (int) don't allow \fBawm\fP to eat any more than this many colors.
X Default is 0 (as many colors as it wants).
X
X menu.borderWidth
X (int) width of menu border in pixels.
X Default is 2.
X
X menu.delta
X (int) number of pixels to move on a "pull-right" pane before the submenu
X attached to it is popped up.
X Default is 20.
X
X menu.itemBorder
X (int) width of individual (menu) item borders.
X Default is 1.
X
X menu.pad
X (int) number of pixels to pad menu text/pixmaps vertically.
X Default is 2.
X
X popup.borderWidth
X (int) width of pop-up window border in pixels.
X Default is 2.
X
X popup.pad
X (int) number of pixels to pad pop-up text horizontally.
X Default is 4.
X
X raiseDelay
X (int) amount of time in milliseconds to wait (while window has focus)
X before raising. If pointer leaves window before time elapses, raise is not
X performed.
X Default is 100 milliseconds.
X
X title.cursor
X (int) glyph (in decimal) to retrieve from cursor font for use in
X title bar.
X Default is XC_left_ptr
X
X title.pad
X (int) number of pixels to pad title bar text vertically.
X
X vIconPad
X (int) number of pixels to pad icon text vertically.
X Default is 2.
X
X volume
X (int) specifies the bell volume (delta on volume set with xset).
X Default is 4.
X
X.SH STRING
X.nf
X
X background
X (string) the default background color for all other color
X choices in \fBawm\fP. If \fBreverse\fP is not set, this defaults
X to white, otherwise it defaults to black.
X When you see a reference to \fBbackground\fP in this document,
X it's talking about this resource.
X
X foreground
X (string) the default foreground color for all other color
X choices in \fBawm\fP. If \fBreverse\fP is not set, this defaults
X to black, otherwise it defaults to white.
X When you see a reference to \fBforeground\fP in this document,
X it's talking about this resource.
X
X BC.background
X (string) background color to use for border context pixmap.
X Meaningless if \fBBC.width\fP and \fBBC.pixmap\fP are undefined.
X Default is \fBbackground\fP
X
X BC.foreground
X (string) foreground color to use for border color pixmap.
X Meaningless if \fBBC.width\fP and \fBBC.pixmap\fP are undefined.
X Default is \fBforeground\fP
X
X BC.boldPixmap
X (string) the name of a pixmap file to load and tile the border context area
X with when the focus is in. If this is defined, and \fBhilite\fP is set,
X focus changes will cause the border context background to alternate between
X \fBBC.pixmap\fP and \fBBC.boldPixmap\fP. If \fBBC.boldPixmap\fP is defined, but
X \fBBC.pixmap\fP is not, a blank pixmap will be used in place of
X \fBBC.pixmap\fP.
X Default is none.
X
X BC.pixmap
X (string) pixmap to display as border context area background.
X Meaningless is \fBBC.width\fP is undefined (or set to zero).
X Used exclusively as the background unless \fBBC.boldPixmap\fP and
X \fBhilite\fP are defined.
X Default is a solid \fBbackground\fP tile.
X
X gadget.font
X (string) which font to use for (textual) gadget labels.
X Default is fixed.
X
X \fBNote that most icon variables only affect icons owned by awm.
X Except for foreground and background colors, Client created
X icons are left alone.\fP
X
X icon.background
X (string) icon (pixmap) background color.
X Default is \fBbackground\fP.
X
X icon.border
X (string) color to use for icon borders.
X Default is \fBicon.foreground\fP.
X
X icon.foreground
X (string) icon (pixmap) foreground color.
X Default is \fBforeground\fP.
X
X icon.font
X (string) which font to use for icon text.
X Default is 8x13
X
X icon.text.background
X (string) background color to use for icon text.
X Default is \fBicon.background\fP.
X
X icon.text.foreground
X (string) foreground color to use for icon text.
X Default is \fBicon.foreground\fP.
X
X icon.pixmap
X (string) pixmap to display as icon background.
X Since this pixmap will be used to tile all icons owned
X by uwm, it's probably not a good idea to put application
X specific pictures in it. More typically, this will be a cross
X hatch pattern or some similar background weave.
X Default is grey.
X See also: \fBpath\fP, \fBicon.foreground\fP, \fBicon.background\fP.
X
X menu.background
X (string) menu background color.
X Default is \fBbackground\fP.
X
X menu.foreground
X (string) menu foreground color.
X Default is \fBforeground\fP.
X
X menu.boldFont
X (string) which font to use for (textual) menu panes. Currently,
X the only pane using this font is the title pane (unless, of course,
X it's a pixmap).
X Default is 8x13bold
X
X menu.font
X (string) which font to use in (textual) menu panes.
X Default is 8x13.
X
X path
X (string) A number of items (titles, menus, etc) now allow you to specify
X a pixmap file, rather than just a text string to display. Since it
X would be tedious to type in full pathnames for these files if they
X all lived in the same places, the directory(s) named by \fBpath\fP are
X searched if the pixmap file's pathname does not begin with a slash (/)
X or tilde (~) and is not found in the current directory.
X
X \fBpath\fP is a list of one or more directories to search, much like
X that used by the unix C-shell. The ~ notation used to designate your
X (or someone else's) home directory is supported, but wildcards are not.
X
X popup.background
X (string) background color to use for pop-up text.
X Default is \fBbackground\fP.
X
X popup.font
X (string) which font to use for popup window text.
X Default is 9x15
X
X popup.foreground
X (string) foreground color to use for pop-ip text.
X Default is \fBforeground\fP.
X
X title.background
X (string) background color to use for title pixmap.
X Default is \fBbackground\fP.
X
X title.boldFont
X (string) which font to use for titlebar labels if focus is and
X \fBhilite\fP is enabled. If this isn't set, and \fBhilite\fP
X is, the title text will be displayed with \fBtitle.font\fP in reverse video.
X Default is none.
X
X title.boldPixmap
X (string) the name of a pixmap file to load and tile titlebars with when
X the focus is in. If this is defined, and \fBhilite\fP is set, focus changes
X will cause title backgrounds to alternate between \fBtitle.pixmap\fP
X and \fBtitle.boldPixmap\fP. If \fBtitle.boldPixmap\fP is defined, but
X \fBtitle.pixmap\fP is not, a blank pixmap will be used in place of
X \fBtitle.pixmap\fP.
X Default is none.
X
X title.font
X (string) which font to use for titlebar labels. Used exclusively unless
X \fBtitle.boldFont\fP and \fBhilite\fP are set.
X Default is vtsingle.
X
X title.foreground
X (string) foreground color to use when drawing background (both normal and
X bold) pixmaps.
X Default is \fBforeground\fP.
X
X title.pixmap
X (string) the name of a pixmap file to load and tile titlebars with.
X This background is use exclusively unless the \fBtitle.boldPixmap\fP is
X defined and \fBhilite\fP is set.
X Default is none.
X
X title.text.background
X (string) background color to use when drawing title bar text.
X Default is \fBtitle.background\fP.
X
X title.text.foreground
X (string) foreground color to use when drawing title bar.
X Default is \fBtitle.foreground\fP.
X
X
X.SH SPECIAL RESOURCES
X.nf
X
X [name].showTitle
X (boolean) determines whether or not a given application really wants
X a title. The application's NAME and CLASS (in the WM_CLASS property)
X are checked against the string supplied for [name] (for example:
X Xclock*showTitle: off).
X
X Note that the \fItitle\fP variable is the final arbiter of whether
X titles bars are displayed. It is a NoOp to specify something
X like:
X
X xterm.showTitle: on
X
X If \fItitle\fP is off. In fact, using this mechanism to do anything
X but turn titles *off* for a given application is generally useless.
X This is because the set of applications that are known not to want
X titles is probably smaller than the (potentially infinite) set of
X applications that do or don't care either way.
X
X This resource is "special" as it is checked for under the application's
X name, not awm's; I.E. xterm.showTitle is not awm.xterm.showTitle as one
X might think.
X
X
X The following resources pertain only to the RTL Neaten package are are
X ignored if \fBawm\fP has not been compiled with that option (see the
X INSTALLATION file).
X
X neaten.absMinWidth
X (int) indicates the amount of space in pixels, that is used
X as the absolute minimum width of a window during the
X neaten operation.
X Default is 64.
X
X neaten.absMinHeight
X (int) indicates the amount of space in pixels, that is used
X as the absolute minimum height of a window during the
X neaten operation.
X Default is 64.
X
X neaten.retainSize
X (boolean) forces to windows to be at least their current size.
X Windows may overlap as a side effect.
X Default is True.
X
X neaten.fill
X (boolean) allows windows to grow to their maximum size during
X the neaten operation. Normally a window will grow only to
X the maximum of its desired (based on the WM_NORMAL_HINTS property)
X and current size.
X Default is True.
X
X neaten.fixTopOfStack
X (boolean) fixes the size and location of the window at the top of
X the window hierarchy. If necessary, this window will
X overlap even other windows which can not be tiled.
X Default is True.
X
X neaten.keepOpen
X (boolean) constrains all windows to remain open during the neaten
X operation. No windows will be iconized. This operation
X may cause windows to overlap.
X Default is True.
X
X neaten.usePriorities
X (boolean) assigns the windows priorities based on their stacking
X order (windows closer to the top in the stacking order
X are given higher priorities). Priorities are used when
X determining size and location of windows on the screen.
X Default is True.
X
X neaten.primaryIconPlacement
X (string) selects the side of the screen where icons are first
X placed. Legal values are: \fITop\fP, \fILeft\fP, \fIBottom\fP, \fIRight\fP and
X \fIClosest\fP (to its current position).
X Default is \fITop\fP.
X
X neaten.secondaryIconPlacement
X (string) determines where along the specified primary side
X the icon should be placed. Legal values are those for
X \fBneaten.primaryIconPlacement\fP plus \fICenter\fP.
X Not used if \fBneaten.primaryIconPlacement\fP is \fIClosest\fP
X Default is \fILeft\fP.
X
X.fi
X.bp
X.SH EXAMPLES
X.PP
The following sample startup file shows the default window
manager options:
X.EX
X# Global variables
X#
resetbindings
resetmenus
X#
X# Mouse button/key maps
X#
X# FUNCTION KEYS CONTEXT BUTTON MENU(if any)
X# ======== ==== ======= ====== ============
f.menu = meta : :left down :"WINDOW OPS"
f.menu = meta : :middle down :"EXTENDED WINDOW OPS"
f.move = meta :w|i :right down
f.circleup = meta :root :right down
X#
X# Menu specifications
X#
menu = "WINDOW OPS" {
X"(De)Iconify": f.iconify
Move: f.move
Resize: f.resize
Lower: f.lower
Raise: f.raise
X}
X
menu = "EXTENDED WINDOW OPS" {
Create Window: !"xterm &"
Iconify at New Position: f.lowericonify
XFocus Keyboard on Window: f.focus
XFreeze All Windows: f.pause
Unfreeze All Windows: f.continue
Circulate Windows Up: f.circleup
Circulate Windows Down: f.circledown
X}
X.EE
X.PP
X.SH RESTRICTIONS
X.PP
The color specifications have no effect on a monochrome system.
There's currently no way to specify a keysym in place of a button
X(up/down/delta) specification. This restriction will be removed in
the near future.
X.PP
X.SH FILES
X.PP
X $(LIBDIR)/rgb.txt
X $(LIBDIR)/font
X /usr/skel/.awmrc
X $(LIBDIR)/awm/system.awmrc
X $HOME/.awmrc
X.PP
X.SH SEE ALSO
X.PP
XX(1), X(8C)
X.SH AUTHOR
X.PP
X.ce 3
COPYRIGHT 1985, 1986
DIGITAL EQUIPMENT CORPORATION
MAYNARD, MASSACHUSETTS
ALL RIGHTS RESERVED.
X.LP
THE INFORMATION IN THIS SOFTWARE IS SUBJECT TO CHANGE WITHOUT NOTICE AND
SHOULD NOT BE CONSTRUED AS A COMMITMENT BY DIGITAL EQUIPMENT CORPORATION.
DIGITAL MAKES NO REPRESENTATIONS ABOUT THE SUITIBILITY OF THIS SOFTWARE FOR
ANY PURPOSE. IT IS SUPPLIED "AS IS" WITHOUT EXPRESS OR IMPLIED WARRANTY.
X.LP
IF THE SOFTWARE IS MODIFIED IN A MANNER CREATING DERIVATIVE COPYRIGHT RIGHTS,
APPROPRIATE LEGENDS MAY BE PLACED ON THE DERIVATIVE WORK IN ADDITION TO THAT
SET FORTH ABOVE.
X.LP
Permission to use, copy, modify, and distribute this software and its
documentation for any purpose and without fee is hereby granted, provided
that the above copyright notice appear in all copies and that both that
copyright notice and this permission notice appear in supporting documentation,
and that the name of Digital Equipment Corporation not be used in advertising
or publicity pertaining to distribution of the software without specific,
written prior permission.
X.PP
X.ce 3
Copyright 1988
Ardent Computer Corporation
Sunnyvale, Ca
X
All Rights Reserved
Permission to use, copy, modify, and distribute this software and its
documentation for any purpose and without fee is hereby granted,
provided that the above copyright notice appear in all copies and that
both that copyright notice and this permission notice appear in
supporting documentation, and that the name of Ardent Computer
Corporation or the author not be used in advertising or publicity
pertaining to distribution of the software without specific, written
prior permission.
X.PP
M. Gancarz,
DEC Ultrix Engineering Group, Merrimack, New Hampshire, using some algorithms
originally by Bob Scheifler, MIT Laboratory for Computer Science
X.PP
J. Hubbard,
U.C. Berkeley, Berkeley, Ca. Ardent Computer, Sunnyvale, Ca. Various modifications
and enhancements using code developed by M. Gancarz and Digitial Equipment Corp.
END_OF_FILE
if test 39430 -ne `wc -c <'awm.man'`; then
echo shar: \"'awm.man'\" unpacked with wrong size!
fi
# end of 'awm.man'
fi
echo shar: End of archive 8 \(of 8\).
cp /dev/null ark8isdone
MISSING=""
for I in 1 2 3 4 5 6 7 8 ; do
if test ! -f ark${I}isdone ; then
MISSING="${MISSING} ${I}"
fi
done
if test "${MISSING}" = "" ; then
echo You have unpacked all 8 archives.
rm -f ark[1-9]isdone
else
echo You still need to unpack the following archives:
echo " " ${MISSING}
fi
## End of shell archive.
exit 0