|
|
|
@ -37,14 +37,14 @@ |
|
|
|
.if n .sp 1 |
|
|
|
.if t .sp .5 |
|
|
|
.. |
|
|
|
.TH TWM 1 __xorgversion__ |
|
|
|
.TH TWMRUINED 1 __xorgversion__ |
|
|
|
.SH NAME |
|
|
|
twm \- Tab Window Manager for the X Window System |
|
|
|
twmruined \- No longer quite the Tab Window Manager |
|
|
|
.SH SYNTAX |
|
|
|
\fBtwm \fP[ \fB\-display\fP \fIdpy\fP ] [ \fB\-s\fP ] |
|
|
|
\fBtwmruined \fP[ \fB\-display\fP \fIdpy\fP ] [ \fB\-s\fP ] |
|
|
|
[ \fB\-f\fP \fIinitfile\fP ] [ \fB\-v\fP ] |
|
|
|
.SH DESCRIPTION |
|
|
|
\fITwm\fP is a window manager for the X Window System. It provides |
|
|
|
\fITwmruined\fP is a window manager for the X Window System based on twm. It provides |
|
|
|
titlebars, shaped windows, |
|
|
|
several forms of icon management, user-defined macro functions, |
|
|
|
click-to-type and pointer-driven keyboard focus, and user-specified |
|
|
|
@ -52,8 +52,8 @@ key and pointer button bindings. |
|
|
|
.PP |
|
|
|
This program is usually started by the user's session manager or |
|
|
|
startup script. When used from \fIxdm(__appmansuffix__)\fP or \fIxinit(__appmansuffix__)\fP without |
|
|
|
a session manager, \fItwm\fP is frequently executed in the foreground |
|
|
|
as the last client. When run this way, exiting \fItwm\fP causes the |
|
|
|
a session manager, \fItwmruined\fP is frequently executed in the foreground |
|
|
|
as the last client. When run this way, exiting \fItwmruined\fP causes the |
|
|
|
session to be terminated (i.e., logged out). |
|
|
|
.PP |
|
|
|
By default, application windows are surrounded by a ``frame'' with a |
|
|
|
@ -80,7 +80,7 @@ region, dragging a window outline to the new location, and then releasing |
|
|
|
when the outline is in the desired position. Just |
|
|
|
clicking in the title or highlight region raises the window without moving it. |
|
|
|
.PP |
|
|
|
When new windows are created, \fItwm\fP will honor any size and location |
|
|
|
When new windows are created, \fItwmruined\fP will honor any size and location |
|
|
|
information requested by the user (usually through \fI-geometry\fP |
|
|
|
command line argument or resources for the individual applications). |
|
|
|
Otherwise, an outline of the window's default size, its titlebar, and lines |
|
|
|
@ -95,7 +95,7 @@ described above. Clicking pointer Button3 (usually the right pointer button) |
|
|
|
will give the window its current position but attempt to make it long enough |
|
|
|
to touch the bottom the screen. |
|
|
|
.SH OPTIONS |
|
|
|
\fITwm\fP accepts the following command line options: |
|
|
|
\fITwmruined\fP accepts the following command line options: |
|
|
|
.PP |
|
|
|
.TP 8 |
|
|
|
.B \-display \fIdpy\fP |
|
|
|
@ -104,47 +104,47 @@ This option specifies the X server to use. |
|
|
|
.B \-s |
|
|
|
This option indicates that only the default screen (as specified by |
|
|
|
\fB\-display\fP or by the \fBDISPLAY\fP environment variable) should be |
|
|
|
managed. By default, \fItwm\fP will attempt to manage |
|
|
|
managed. By default, \fItwmruined\fP will attempt to manage |
|
|
|
all screens on the display. |
|
|
|
.TP 8 |
|
|
|
.B \-f \fIfilename\fP |
|
|
|
This option specifies the name of the startup file to use. By default, |
|
|
|
\fItwm\fP will look in the user's home directory for files |
|
|
|
named \fI.twmrc.num\fP (where \fInum\fP is a screen number) or \fI.twmrc\fP. |
|
|
|
\fItwmruined\fP will look in the user's home directory for files |
|
|
|
named \fI.twmruinedrc.num\fP (where \fInum\fP is a screen number) or \fI.twmruinedrc\fP. |
|
|
|
.TP 8 |
|
|
|
.B \-v |
|
|
|
This option indicates that \fItwm\fP should print error messages whenever |
|
|
|
This option indicates that \fItwmruined\fP should print error messages whenever |
|
|
|
an unexpected X Error event is received. This can be useful when debugging |
|
|
|
applications but can be distracting in regular use. |
|
|
|
.SH CUSTOMIZATION |
|
|
|
.PP |
|
|
|
Much of \fItwm\fP's appearance and behavior can be controlled by providing |
|
|
|
Much of \fItwmruined\fP's appearance and behavior can be controlled by providing |
|
|
|
a startup file in one of the following locations (searched in order for |
|
|
|
each screen being managed when \fItwm\fP begins): |
|
|
|
each screen being managed when \fItwmruined\fP begins): |
|
|
|
.TP 8 |
|
|
|
.B "$HOME/.twmrc.\fIscreennumber\fP" |
|
|
|
.B "$HOME/.twmruinedrc.\fIscreennumber\fP" |
|
|
|
The \fIscreennumber\fP is a small positive number (e.g. 0, 1, etc.) |
|
|
|
representing the screen number (e.g. the last number in the DISPLAY environment |
|
|
|
variable \fIhost:displaynum.screennum\fP) that would be used to contact that |
|
|
|
screen of the display. This is intended for displays with multiple screens of |
|
|
|
differing visual types. |
|
|
|
.TP 8 |
|
|
|
.B "$HOME/.twmrc" |
|
|
|
.B "$HOME/.twmruinedrc" |
|
|
|
This is the usual name for an individual user's startup file. |
|
|
|
.TP 8 |
|
|
|
.B __datadir__/X11/twm/system.twmrc |
|
|
|
If neither of the preceding files are found, \fItwm\fP will look in this |
|
|
|
.B __datadir__/X11/twmruined/system.twmruinedrc |
|
|
|
If neither of the preceding files are found, \fItwmruined\fP will look in this |
|
|
|
file for a |
|
|
|
default configuration. This is often tailored by the site administrator to |
|
|
|
provide convenient menus or familiar bindings for novice users. |
|
|
|
.PP |
|
|
|
If no startup files are found, \fItwm\fP will use the built-in defaults |
|
|
|
described above. The only resource used by \fItwm\fP is |
|
|
|
If no startup files are found, \fItwmruined\fP will use the built-in defaults |
|
|
|
described above. The only resource used by \fItwmruined\fP is |
|
|
|
\fIbitmapFilePath\fP for a colon-separated list of directories to search |
|
|
|
when looking for bitmap files (for more information, see the \fIAthena |
|
|
|
Widgets\fP manual and \fIxrdb(__appmansuffix__)\fP). |
|
|
|
.PP |
|
|
|
\fITwm\fP startup files are logically broken up into three types of |
|
|
|
\fITwmruined\fP startup files are logically broken up into three types of |
|
|
|
specifications: \fIVariables\fP, \fIBindings\fP, \fIMenus\fP. The |
|
|
|
\fIVariables\fP section must come first and is used to describe the |
|
|
|
fonts, colors, cursors, border widths, icon and window placement, highlighting, |
|
|
|
@ -163,7 +163,7 @@ of a string causes the remainder of the line in which the character appears to |
|
|
|
be treated as a comment. |
|
|
|
.SH VARIABLES |
|
|
|
.PP |
|
|
|
Many of the aspects of \fItwm\fP's user interface are controlled by variables |
|
|
|
Many of the aspects of \fItwmruined\fP's user interface are controlled by variables |
|
|
|
that may be set in the user's startup file. Some of the options are |
|
|
|
enabled or disabled simply by the presence of a particular keyword. Other |
|
|
|
options require keywords, numbers, strings, or lists of all of these. |
|
|
|
@ -205,7 +205,7 @@ or \fB:delete\fP (both refer to the X logo), |
|
|
|
and \fB:question\fP (the question mark used for non-existent |
|
|
|
bitmap files). |
|
|
|
.PP |
|
|
|
The following variables may be specified at the top of a \fItwm\fP startup |
|
|
|
The following variables may be specified at the top of a \fItwmruined\fP startup |
|
|
|
file. Lists of Window name prefix strings are indicated by \fIwin-list\fP. |
|
|
|
Optional arguments are shown in square brackets: |
|
|
|
.IP "\fBAutoRaise\fP { \fIwin-list\fP }" 8 |
|
|
|
@ -223,7 +223,7 @@ same amount. This allows the resizing of windows that extend off |
|
|
|
the edge of the screen. |
|
|
|
If the pointer is |
|
|
|
in the center of the window, or if the resize is begun by pressing a |
|
|
|
titlebutton, \fItwm\fP will still wait for the pointer to cross a window |
|
|
|
titlebutton, \fItwmruined\fP will still wait for the pointer to cross a window |
|
|
|
edge (to prevent accidents). This option is |
|
|
|
particularly useful for people who like the press-drag-release method of |
|
|
|
sweeping out window sizes. |
|
|
|
@ -258,7 +258,7 @@ per-window colors to be specified. The default is "black". |
|
|
|
.IP "\fBBorderWidth\fP \fIpixels\fP" 8 |
|
|
|
This variable specifies the width in pixels of the border surrounding |
|
|
|
all client window frames if \fBClientBorderWidth\fP has not been specified. |
|
|
|
This value is also used to set the border size of windows created by \fItwm\fP |
|
|
|
This value is also used to set the border size of windows created by \fItwmruined\fP |
|
|
|
(such as the icon manager). The default is 2. |
|
|
|
.IP "\fBButtonIndent\fP \fIpixels\fP" 8 |
|
|
|
This variable specifies the amount by which titlebuttons should be |
|
|
|
@ -320,7 +320,7 @@ of time when invoking \fBf.move\fP will cause the window to be moved only |
|
|
|
in a horizontal or vertical direction. Setting this value to 0 will disable |
|
|
|
constrained moves. The default is 400 milliseconds. |
|
|
|
.IP "\fBCursors\fP { \fIcursor-list\fP }" 8 |
|
|
|
This variable specifies the glyphs that \fItwm\fP should use for various |
|
|
|
This variable specifies the glyphs that \fItwmruined\fP should use for various |
|
|
|
pointer cursors. Each cursor |
|
|
|
may be defined either from the \fBcursor\fP font or from two bitmap files. |
|
|
|
Shapes from the \fBcursor\fP font may be specified directly as: |
|
|
|
@ -591,7 +591,7 @@ This variable specifies the number of pixels the pointer |
|
|
|
must move before the \fBf.move\fP function starts working. Also |
|
|
|
see the \fBf.deltastop\fP function. The default is zero pixels. |
|
|
|
.IP "\fBNoBackingStore\fP" 8 |
|
|
|
This variable indicates that \fItwm\fP's menus should not request backing |
|
|
|
This variable indicates that \fItwmruined\fP's menus should not request backing |
|
|
|
store to minimize repainting of menus. This is typically |
|
|
|
used with servers that can repaint faster than they can handle backing store. |
|
|
|
.IP "\fBNoCaseSensitive\fP" 8 |
|
|
|
@ -603,7 +603,7 @@ This variable indicates that \fItwm\fP should not supply the default |
|
|
|
titlebuttons and bindings. This option should only be used if the startup |
|
|
|
file contains a completely new set of bindings and definitions. |
|
|
|
.IP "\fBNoGrabServer\fP" 8 |
|
|
|
This variable indicates that \fItwm\fP should not grab the server |
|
|
|
This variable indicates that \fItwmruined\fP should not grab the server |
|
|
|
when popping up menus and moving opaque windows. |
|
|
|
.IP "\fBNoHighlight\fP [{ \fIwin-list\fP }]" 8 |
|
|
|
This variable indicates that borders should not be highlighted to track the |
|
|
|
@ -649,11 +649,11 @@ optional \fIwin-list\fP is given, only those windows will not have titlebars. |
|
|
|
\fBMakeTitle\fP may be used with this option to force titlebars to be put |
|
|
|
on specific windows. |
|
|
|
.IP "\fBNoTitleFocus\fP" 8 |
|
|
|
This variable indicates that \fItwm\fP should not set keyboard input focus to |
|
|
|
each window as it is entered. Normally, \fItwm\fP sets the focus |
|
|
|
This variable indicates that \fItwmruined\fP should not set keyboard input focus to |
|
|
|
each window as it is entered. Normally, \fItwmruined\fP sets the focus |
|
|
|
so that focus and key events from the titlebar and |
|
|
|
icon managers are delivered to the application. If the pointer is moved |
|
|
|
quickly and \fItwm\fP is slow to respond, input can be directed to the old |
|
|
|
quickly and \fItwmruined\fP is slow to respond, input can be directed to the old |
|
|
|
window instead of the new. This option is typically |
|
|
|
used to prevent this ``input lag'' and to |
|
|
|
work around bugs in older applications that have problems with focus events. |
|
|
|
@ -682,7 +682,7 @@ may be specified: |
|
|
|
.EE |
|
|
|
The default for \fITitleHighlight\fP is to use an even stipple pattern. |
|
|
|
.IP "\fBPriority\fP \fIpriority\fP" 8 |
|
|
|
This variable sets \fItwm\fP's priority. \fIpriority\fP should be an |
|
|
|
This variable sets \fItwmruined\fP's priority. \fIpriority\fP should be an |
|
|
|
unquoted, signed number (e.g. 999). This variable has an effect only |
|
|
|
if the server supports the SYNC extension. |
|
|
|
.IP "\fBRandomPlacement\fP" 8 |
|
|
|
@ -694,7 +694,7 @@ This variable specifies the font to be used for in the dimensions window when |
|
|
|
resizing windows. The default is "fixed". |
|
|
|
.IP "\fBRestartPreviousState\fP" 8 |
|
|
|
This variable indicates that |
|
|
|
\fItwm\fP should attempt to use the WM_STATE property on client windows |
|
|
|
\fItwmruined\fP should attempt to use the WM_STATE property on client windows |
|
|
|
to tell which windows should be iconified and which should be left visible. |
|
|
|
This is typically used to try to regenerate the state that the screen |
|
|
|
was in before the previous window manager was shutdown. |
|
|
|
@ -722,14 +722,14 @@ This would place on the root window 3 pixel values for borders and titlebars, |
|
|
|
as well as the three color strings, all taken from the default colormap. |
|
|
|
.IP "\fBShowIconManager\fP" 8 |
|
|
|
This variable indicates that the icon manager window should be displayed when |
|
|
|
\fItwm\fP is started. It can always be brought up using the |
|
|
|
\fItwmruined\fP is started. It can always be brought up using the |
|
|
|
\fBf.showiconmgr\fP function. |
|
|
|
.IP "\fBSortIconManager\fP" 8 |
|
|
|
This variable indicates that entries in the icon manager should be |
|
|
|
sorted alphabetically rather than by simply appending new windows to |
|
|
|
the end. |
|
|
|
.IP "\fBSqueezeTitle\fP [{ \fIsqueeze-list\fP }] " 8 |
|
|
|
This variable indicates that \fItwm\fP should attempt to use the SHAPE |
|
|
|
This variable indicates that \fItwmruined\fP should attempt to use the SHAPE |
|
|
|
extension to make titlebars occupy only as much screen space as they need, |
|
|
|
rather than extending all the way across the top of the window. |
|
|
|
The optional \fIsqueeze-list\fP |
|
|
|
@ -795,12 +795,12 @@ used as the default icon. This bitmap will be used as the icon of all |
|
|
|
clients which do not provide an icon bitmap and are not listed |
|
|
|
in the \fBIcons\fP list. |
|
|
|
.IP "\fBUsePPosition\fP \fIstring\fP" 8 |
|
|
|
This variable specifies whether or not \fItwm\fP should honor |
|
|
|
This variable specifies whether or not \fItwmruined\fP should honor |
|
|
|
program-requested locations (given by the \fBPPosition\fP flag in the |
|
|
|
WM_NORMAL_HINTS property) in the absence of a user-specified position. |
|
|
|
The argument \fIstring\fP may have one of three values: \fB"off"\fP |
|
|
|
(the default) |
|
|
|
indicating that \fItwm\fP |
|
|
|
indicating that \fItwmruined\fP |
|
|
|
should ignore the program-supplied position, |
|
|
|
\fB"on"\fP indicating that the position |
|
|
|
should be used, and |
|
|
|
@ -826,7 +826,7 @@ variety of |
|
|
|
of distinguishable colors when exclusive-or'ed with the contents of the |
|
|
|
user's typical screen. Setting this variable to 1 often gives nice results |
|
|
|
if adjacent colors in the default colormap are distinct. By default, |
|
|
|
\fItwm\fP will attempt to cause temporary lines to appear at the opposite |
|
|
|
\fItwmruined\fP will attempt to cause temporary lines to appear at the opposite |
|
|
|
end of the colormap from the graphics. |
|
|
|
.IP "\fBZoom\fP [ \fIcount\fP ]" 8 |
|
|
|
This variable indicates that outlines suggesting movement of a window |
|
|
|
@ -921,11 +921,11 @@ use the following bindings: |
|
|
|
"Up" = m : all : f.upiconmgr |
|
|
|
"Down" = m | s : all : f.downiconmgr |
|
|
|
.EE |
|
|
|
\fITwm\fP provides many more window manipulation primitives than can be |
|
|
|
\fITwmruined\fP provides many more window manipulation primitives than can be |
|
|
|
conveniently stored in a titlebar, menu, or set of key bindings. Although |
|
|
|
a small set of defaults are supplied (unless the \fBNoDefaults\fP is |
|
|
|
specified), most users will want to have their most common operations |
|
|
|
bound to key and button strokes. To do this, \fItwm\fP associates names |
|
|
|
bound to key and button strokes. To do this, \fItwmruined\fP associates names |
|
|
|
with each of the primitives and provides \fIuser-defined functions\fP for |
|
|
|
building higher level primitives and \fImenus\fP for interactively selecting |
|
|
|
among groups of functions. |
|
|
|
@ -968,7 +968,7 @@ This function lowers the top-most window that occludes another window. |
|
|
|
This function raises the bottom-most window that is occluded by another window. |
|
|
|
.IP "\fBf.colormap\fP \fIstring\fP" 8 |
|
|
|
This function rotates the colormaps (obtained from the WM_COLORMAP_WINDOWS |
|
|
|
property on the window) that \fItwm\fP will display when the pointer |
|
|
|
property on the window) that \fItwmruined\fP will display when the pointer |
|
|
|
is in this window. The argument \fIstring\fP may have one of the following |
|
|
|
values: \fB"next"\fP, \fB"prev"\fP, and \fB"default"\fP. It should be noted |
|
|
|
here that in general, the installed colormap is determined by keyboard focus. |
|
|
|
@ -1087,8 +1087,8 @@ the numeric value of the argument \fIstring\fP, which should be a signed |
|
|
|
integer in double quotes (e.g. "999" ). This function has an effect only |
|
|
|
if the server supports the SYNC extension. |
|
|
|
.IP "\fBf.quit\fP" 8 |
|
|
|
This function causes \fItwm\fP to restore the window's borders and exit. If |
|
|
|
\fItwm\fP is the first client invoked from \fIxdm\fP, this will result in a |
|
|
|
This function causes \fItwmruined\fP to restore the window's borders and exit. If |
|
|
|
\fItwmruined\fP is the first client invoked from \fIxdm\fP, this will result in a |
|
|
|
server reset. |
|
|
|
.IP "\fBf.raise\fP" 8 |
|
|
|
This function raises the selected window. |
|
|
|
@ -1103,9 +1103,9 @@ This function displays an outline of the selected window. Crossing a border |
|
|
|
rubber band until the invoking button is released. To abort a resize, |
|
|
|
press another button before releasing the first button. |
|
|
|
.IP "\fBf.restart\fP" 8 |
|
|
|
This function kills and restarts \fItwm\fP. |
|
|
|
This function kills and restarts \fItwmruined\fP. |
|
|
|
.IP "\fBf.startwm\fP \fIstring\fP" 8 |
|
|
|
This function kills \fItwm\fP and starts another window manager, as |
|
|
|
This function kills \fItwmruined\fP and starts another window manager, as |
|
|
|
specified by \fIstring\fP. |
|
|
|
.IP "\fBf.righticonmgr\fI" 8 |
|
|
|
This function is similar to \fBf.nexticonmgr\fP except that wrapping does |
|
|
|
@ -1127,17 +1127,17 @@ This function sorts the entries in the current icon manager alphabetically. |
|
|
|
See the variable \fBSortIconManager\fP. |
|
|
|
.\".IP "\fBf.source\fP \fIstring\fP" 8 |
|
|
|
.\"This function assumes \fIstring\fP is a file name. The file is read |
|
|
|
.\"and parsed as a \fItwm\fP startup file. |
|
|
|
.\"and parsed as a \fItwmruined\fP startup file. |
|
|
|
.\"This |
|
|
|
.\"function is intended to be used only to re-build pull-down menus. None |
|
|
|
.\"of the \fItwm\fP variables are changed. |
|
|
|
.\"of the \fItwmruined\fP variables are changed. |
|
|
|
.IP "\fBf.title\fP" 8 |
|
|
|
This function provides a centered, unselectable item in a menu definition. It |
|
|
|
should not be used in any other context. |
|
|
|
.IP "\fBf.topzoom\fP" 8 |
|
|
|
This variable is similar to the \fBf.bottomzoom\fP function except that |
|
|
|
the selected window is only resized to the top half of the display. |
|
|
|
.\".IP "\fBf.twmrc\fP" 8 |
|
|
|
.\".IP "\fBf.twmruinedrc\fP" 8 |
|
|
|
.\"This function causes the startup customization file to be re-read. This |
|
|
|
.\"function is exactly like the \fBf.source\fP function without having to |
|
|
|
.\"specify the filename. |
|
|
|
@ -1148,7 +1148,7 @@ when a focused window is no longer desired. |
|
|
|
This function warps the pointer to the previous row in the current icon |
|
|
|
manager, wrapping to the last row in the same column if necessary. |
|
|
|
.\".IP "\fBf.version\fI" 8 |
|
|
|
.\"This function causes the \fItwm\fP version window to be displayed. This |
|
|
|
.\"This function causes the \fItwmruined\fP version window to be displayed. This |
|
|
|
.\"window will be displayed until a pointer button is pressed or the |
|
|
|
.\"pointer is moved from one window to another. |
|
|
|
.IP "\fBf.vlzoom\fP" 8 |
|
|
|
@ -1218,7 +1218,7 @@ The \fIfunction\fP portion of the menu entry is one of the functions, |
|
|
|
including any user-defined functions, or additional menus. |
|
|
|
.PP |
|
|
|
There is a special menu named \fBTwmWindows\fP which contains the names of |
|
|
|
all of the client and \fItwm\fP-supplied windows. Selecting an entry will |
|
|
|
all of the client and \fItwmruined\fP-supplied windows. Selecting an entry will |
|
|
|
cause the |
|
|
|
\fBWindowFunction\fP to be executed on that window. If \fBWindowFunction\fP |
|
|
|
hasn't been set, the window will be deiconified and raised. |
|
|
|
@ -1261,9 +1261,9 @@ they may be lost if they are iconified and no bindings to |
|
|
|
.SH FILES |
|
|
|
.PP |
|
|
|
.nf |
|
|
|
.I $HOME/.twmrc.<screen number> |
|
|
|
.I $HOME/.twmrc |
|
|
|
.I __projectroot__/lib/X11/twm/system.twmrc |
|
|
|
.I $HOME/.twmruinedrc.<screen number> |
|
|
|
.I $HOME/.twmruinedrc |
|
|
|
.I __projectroot__/lib/X11/twmruined/system.twmruinedrc |
|
|
|
.fi |
|
|
|
.SH "ENVIRONMENT VARIABLES" |
|
|
|
.IP "DISPLAY" 8 |
|
|
|
@ -1271,7 +1271,7 @@ This variable is used to determine which X server to use. It is also set |
|
|
|
during \fBf.exec\fP so that programs come up on the proper screen. |
|
|
|
.IP "HOME" 8 |
|
|
|
This variable is used as the prefix for files that begin with a tilde and |
|
|
|
for locating the \fItwm\fP startup file. |
|
|
|
for locating the \fItwmruined\fP startup file. |
|
|
|
.SH "SEE ALSO" |
|
|
|
.PP |
|
|
|
X(__miscmansuffix__), Xserver(__appmansuffix__), xdm(__appmansuffix__), xrdb(__appmansuffix__) |
