First commit

This is the original state of the released tarball for JWM 1.8,
which will serve as my starting point for further modifications.

1 files changed, 1185 insertions, 0 deletions

diff --git a/jwm.1.in b/jwm.1.in
new file mode 100644
index 0000000..109960b
--- /dev/null
+++ b/jwm.1.in
@@ -0,0 +1,1185 @@
+./"
+./" groff -man -Tascii jwm.1
+./"
+
+.TH jwm 1 "@DATE@" "v@VERSION@"
+.SH NAME
+JWM - Joe's Window Manager
+
+.SH SYNOPSIS
+.BR jwm " [options]"
+.SH DESCRIPTION
+JWM is a window manager for the X11 Window System.
+
+.SH OPTIONS
+\fB\-display\fP \fIdisplay\fP
+.RS
+This option specifies the display to use; see \fBX\fP(1).
+.RE
+.P
+.B "-exit"
+.RS
+Exit JWM by sending _JWM_EXIT to the root window.
+.RE
+.P
+.B "-h"
+.RS
+Display a help message and exit.
+.RE
+.P
+.B "-p"
+.RS
+Parse the configuration file and exit.
+It is a good idea to use this after making modifications to the configuration
+file to ensure there are no errors.
+.RE
+.P
+.B "-restart"
+.RS
+Restart JWM by sending _JWM_RESTART to the root window.
+.RE
+.P
+.B "-v"
+.RS
+Display version information and exit.
+.RE
+
+.SH FILES
+.IP "@SYSCONF@/system.jwmrc"
+The default JWM configuration file.
+.IP "~/.jwmrc"
+Local configuration file. Copy the default configuration file to this
+location to make user-specific changes.
+
+.SH CONFIGURATION
+.B OVERVIEW
+.RS
+Configuration of JWM is done by editing ".jwmrc".  This file is XML
+making it easy to edit, either by hand or programmatically. The
+example.jwmrc gives an example configuration file.
+Before restarting JWM, it is a good idea to run "jwm -p" to make
+sure the configuration file is free of errors.  Otherwise you may end up
+without a root menu.
+.RE
+.P
+.B "ROOT MENU"
+.RS
+The root menu in JWM is the primary way of starting programs.
+It also provides a way to restart or exit the window manager.
+The outer most tag is \fBRootMenu\fP. The following attributes are
+supported:
+.P
+\fBonroot\fP \fIlist\fP
+.RS
+Determine which buttons on the root window activate the menu.
+This is a list of integers specifying buttons. The default is "123".
+Note that multiple root menus may be specified by using different
+buttons for different menus. The range of possible button values is
+\fB0\fP to \fB9\fP inclusive.
+.RE
+.P
+\fBheight\fP \fIint\fP
+.RS
+Height of each menu item in pixels. 0 indicates the largest menu item
+will determine the height. The default is 0.
+.RE
+.P
+\fBlabeled\fP \fIbool\fP
+.RS
+Determines if a label appears at the top of the menu. Default is false.
+.RE
+.P
+\fBlabel\fP \fIstring\fP
+.RS
+The label to display at the top of the menu. Default is "JWM".
+.RE
+.P
+Within the \fBRootMenu\fP tag, the following tags are supported:
+.P
+.B Menu
+.RS
+This tag creates a submenu item. Any of the tags allowed within the 
+\fBRootMenu\fP tag, including the \fBMenu\fP tag are allowed within this
+element. The following attributes are supported:
+.P
+\fBheight\fP \fIint\fP
+.RS
+Height of each menu item in pixels. 0 indicates the largest menu item
+will determine the height. The default is inherited from the parent menu.
+.RE
+.P
+\fBlabel\fP \fIstring\fP
+.RS
+The label to use. No default.
+.RE
+.P
+\fBicon\fP \fIstring\fP
+.RS
+The icon to use for this menu. No default.
+.RE
+.P
+\fBlabeled\fP \fIbool\fP
+.RS
+Determines if a label appears at the top of the menu. Default is false.
+.RE
+.RE
+.P
+.B Include
+.RS
+Include the contents of a file into the menu structure. The file must
+start with a "Menu" tag. The file is specified by the text of the tag.
+If the text starts with "exec:" then the output of a program is used.
+.RE
+.P
+.B Program
+.RS
+The \fBProgram\fP tag provides a way to start an external program. The text
+in this tag is the command used to start he program.
+The following attributes are supported:
+.P
+\fBlabel\fP \fIstring\fP
+.RS
+The label to display. Default is the text of the tag.
+.RE
+.P
+\fBicon\fP \fIstring\fP
+.RS
+The icon to use. No default.
+.RE
+.RE
+.P
+.B Separator
+.RS
+This tag simply puts a line in the menu allowing menu divisions.
+No text or attributes are used.
+.RE
+.P
+.B Desktops
+.RS
+Add a desktop menu. This will add a submenu with a list of desktops that
+can be used to change the current desktop.
+The following attributes are supported:
+.P
+\fBlabel\fP \fIstring\fP
+.RS
+The label to use for the menu. The default is "Desktops".
+.RE
+.P
+\fBicon\fP \fIstring\fP
+.RS
+The icon to use for this item. No default.
+.RE
+.RE
+.P
+.B SendTo
+.RS
+Add a "send to" menu to the menu. After selecting an item from this menu,
+a window may be selected to send that window to the selected desktop.
+The following attributes are supported
+.P
+\fBlabel\fP \fIstring\fP
+.RS
+The label to use. The default is "SendTo".
+.RE
+.P
+\fBicon\fP \fIstring\fP
+.RS
+The icon to use for this item. No default.
+.RE
+.RE
+.P
+.B Stick
+.RS
+Add a stick/unstick window operation to the menu. After selecting this
+item a window may be selected to toggle the sticky state of that window.
+The following attributes are supported
+.P
+\fBlabel\fP \fIstring\fP
+.RS
+The label to use. The default is "Stick".
+.RE
+.P
+\fBicon\fP \fIstring\fP
+.RS
+The icon to use for this item. No default.
+.RE
+.RE
+.P
+.B Maximize
+.RS
+Add a maximize window operation to the menu. After selecting this
+item a window may be selected to toggle the maximized state of that window.
+The following attributes are supported
+.P
+\fBlabel\fP \fIstring\fP
+.RS
+The label to use. The default is "Maximize".
+.RE
+.P
+\fBicon\fP \fIstring\fP
+.RS
+The icon to use for this item. No default.
+.RE
+.RE
+.P
+.B Minimize
+.RS
+Add a minimize window operation to the menu. After selecting this
+item a window may be selected to minimize that window.
+The following attributes are supported
+.P
+\fBlabel\fP \fIstring\fP
+.RS
+The label to use. The default is "Minimize".
+.RE
+.P
+\fBicon\fP \fIstring\fP
+.RS
+The icon to use for this item. No default.
+.RE
+.RE
+.P
+.B Shade
+.RS
+Add a shade/unshade window operation to the menu. After selecting this
+item a window may be selected to toggle the shaded status of that window.
+The following attributes are supported
+.P
+\fBlabel\fP \fIstring\fP
+.RS
+The label to use. The default is "Shade".
+.RE
+.P
+\fBicon\fP \fIstring\fP
+.RS
+The icon to use for this item. No default.
+.RE
+.RE
+.P
+.B Move
+.RS
+Add a move window operation to the menu. After selecting this
+item a window may be selected to move that window.
+The following attributes are supported
+.P
+\fBlabel\fP \fIstring\fP
+.RS
+The label to use. The default is "Move".
+.RE
+.P
+\fBicon\fP \fIstring\fP
+.RS
+The icon to use for this item. No default.
+.RE
+.RE
+.P
+.B Resize
+.RS
+Add a resize window operation to the menu. After selecting this
+item a window may be selected to resize that window.
+The following attributes are supported
+.P
+\fBlabel\fP \fIstring\fP
+.RS
+The label to use. The default is "Resize".
+.RE
+.P
+\fBicon\fP \fIstring\fP
+.RS
+The icon to use for this item. No default.
+.RE
+.RE
+.P
+.B Kill
+.RS
+Add a kill window operation to the menu. After selecting this
+item a window may be selected to kill that window.
+The following attributes are supported
+.P
+\fBlabel\fP \fIstring\fP
+.RS
+The label to use. The default is "Kill".
+.RE
+.P
+\fBicon\fP \fIstring\fP
+.RS
+The icon to use for this item. No default.
+.RE
+.RE
+.P
+.B Close
+.RS
+Add a close window operation to the menu. After selecting this
+item a window may be selected to close that window.
+The following attributes are supported
+.P
+\fBlabel\fP \fIstring\fP
+.RS
+The label to use. The default is "Close".
+.RE
+.P
+\fBicon\fP \fIstring\fP
+.RS
+The icon to use for this item. No default.
+.RE
+.RE
+.P
+.B Restart
+.RS
+This tag adds a menu item to restart the window manager.
+The following attributes are supported:
+.P
+\fBlabel\fP \fIstring\fP
+.RS
+The label to use. The default is "Restart".
+.RE
+.P
+\fBicon\fP \fIstring\fP
+.RS
+The icon to use. No default.
+.RE
+.RE
+.P
+.B Exit
+.RS
+This tag adds a menu item to exit the window manager. If text is
+present within this tag, it is interpreted as a command to run when JWM
+exits. This can be used to start another window manager.
+The following attributes are supported:
+.P
+\fBlabel\fP \fIstring\fP
+.RS
+The label to use. The default is "Exit".
+.RE
+.P
+\fBicon\fP \fIstring\fP
+.RS
+The icon to use. No default.
+.RE
+.P
+\fBconfirm\fP \fIbool\fP
+.RS
+Determine if a confirm dialog appears before exiting. Default is true.
+.RE
+.P
+Note that confirm dialogs can be disabled completely at the compile-time.
+.RE
+.RE
+
+.B TRAYS
+.RS
+One or more trays may be created via the \fBTray\fP tag.
+This tag supports the following attributes:
+.P
+\fBautohide\fP \fIbool\fP
+.RS
+Allows this tray to hide itself when not activated. Default is false.
+.RE
+.P
+\fBx\fP \fIint\fP
+.RS
+The x-coordinate of the tray. This may be negative to indicate an offset
+from the right of the screen.
+.RE
+.P
+\fBy\fP \fIint\fP
+.RS
+The y-coordinate of the tray. This may be negative to indicate an offset
+from the bottom of the screen.
+.RE
+.P
+\fBwidth\fP \fIint\fP
+.RS
+The width of the tray. 0 indicates that the tray should compute an
+optimal width depending on what it contains and the layout. 0 is the
+default.
+.RE
+.P
+\fBheight\fP \fIint\fP
+.RS
+The height of the tray. 0 indicates that the tray should compute an
+optimal height depending on what it contains and the layout. 0 is the
+default.
+.RE
+.P
+\fBborder\fP \fIint\fP
+.RS
+The width of the border. The default is 1. Valid values are between 0 and 32
+inclusive.
+.RE
+.P
+\fBlayer\fP \fIint\fP
+.RS
+The layer of the tray. The default is 8. Valid values are between 0 and
+12 inclusive.
+.RE
+.P
+\fBlayout\fP { \fBvertical\fP | \fBhorizontal\fP }
+.RS
+The layout of the tray. The default is horizontal.
+.RE
+.P
+\fBvalign\fP { \fBfixed\fP | \fBtop\fP | \fBcenter\fP | \fBbottom\fP }
+.RS
+The vertical alignment of the tray. The default is \fBfixed\fP.
+.RE
+.P
+\fBhalign\fP { \fBfixed\fP | \fBleft\fP | \fBcenter\fP | \fBright\fP }
+.RS
+The horizontal alignment of the tray. The default is \fBfixed\fP.
+.RE
+.P
+Within this tag the following tags are supported:
+.P
+.B Clock
+.RS
+Add a clock to the tray. The text of this tag is a command to run
+when the clock is clicked. This tag supports the following attributes:
+.P
+\fBformat\fP \fIstring\fP
+.RS
+The format of the clock. See \fBstrftime\fP(3).
+.RE
+.P
+\fBwidth\fP \fIint\fP
+.RS
+The width of the clock. 0 indicates that the width should be determined
+from the length of the text to be displayed.
+.RE
+.P
+\fBheight\fP \fIint\fP
+.RS
+The height of the clock. 0 indicates that the height should be determined
+from the font used.
+.RE
+.RE
+.P
+.B Dock
+.RS
+Add a dock for system notifications. This can be used by those programs
+that use the _NET_SYSTEM_TRAY_Sn selection. The size of the Dock is
+dynamic based on the size of the tray and the number of items contained.
+Only one Dock is allowed per instance of JWM.
+.RE
+.P
+.B Pager
+.RS
+Add a pager to the tray. This tag supports the following attributes:
+.P
+\fBwidth\fP \fIint\fP
+.RS
+The width of the pager. 0 indicates that the width should be determined
+from the tray. 0 is the default.
+.RE
+.P
+\fBheight\fP \fIint\fP
+.RS
+The height of the pager. 0 indicates that the height should be determined
+from the tray. 0 is the default.
+.RE
+.RE
+.P
+.B Swallow
+.RS
+Swallow a program into the tray. The text of this tag gives the
+command to run.
+This tag supports the following attributes:
+.P
+\fBname\fP \fIstring\fP
+.RS
+The name of the program to swallow. This attribute is required.
+.RE
+.P
+\fBwidth\fP \fIint\fP
+.RS
+The width of the swallowed program. 0 indicates that the width should
+be determined from the tray and size requested from the program. 0 is
+the default.
+.RE
+.P
+\fBheight\fP \fIint\fP
+.RS
+The height of the swallowed program. 0 indicates that the height should
+be determined from the tray and the size requested from the program. 0 is
+the default.
+.RE
+.RE
+.P
+.B TaskList
+.RS
+Add a task list to the tray.
+This tag supports the following attribute:
+.P
+\fBmaxwidth\fP \fIint\fP
+.RS
+The maximum width of an item in the task list. 0 indicates no maximum.
+The default is 0.
+.RE
+.RE
+.P
+.B TrayButton
+.RS
+Add a button to the tray. The text of this tag determines what action to
+take when the button is clicked. The following actions are supported:
+.P
+\fBroot:\fP\fIn\fP
+.RS
+Show root menu \fIn\fP.
+Note that the default TrayButton action is \fBroot:1\fP.
+.RE
+.P
+\fBexec:\fP \fIstring\fP
+.RS
+Execute a command.
+.RE
+.P
+\fBshowdesktop\fP
+.RS
+Minimize all windows on the current desktop.
+.RE
+.P
+This tag supports the following attributes:
+.P
+\fBlabel\fP \fIstring\fP
+.RS
+A label to display. No default.
+.RE
+.P
+\fBpopup\fP \fIstring\fP
+.RS
+A string to be displayed for a popup. This will default to the value
+specified for \fBlabel\fP, if provided. If neither \fBpopup\fP nor
+\fBlabel\fP are specified no popup will be shown.
+.RE
+.P
+\fBicon\fP \fIstring\fP
+.RS
+An icon to display. No default.
+.RE
+.RE
+.RE
+
+.B INCLUDES
+.RS
+Other configuration files may be included under the JWM tag via the 
+\fBInclude\fP tag.  The text of this tag specifies the location of an
+additional configuration file. The path may be relative to the loacation
+JWM was started, an absolute path, or a path referencing an environment
+variable (using '$'). The format of the configuration file is the same as
+the main configuration file.
+.RE
+
+.B "GROUP SETTINGS"
+.RS
+Program groups allow one to specify options which apply to a group of
+programs by name and/or class. A program group is created with the 
+\fBGroup\fP tag. As many program groups can be created as desired. Within the 
+\fBGroup\fP tag the following tags are supported:
+.P
+.B Name
+.RS
+The title of a program to match to be in this group. This field is case
+sensitive. a wild card, \fB*\fP, may be used.
+.RE
+.B Class
+.RS
+The window class for a program to match to be in this group. This field is
+case sensitive. A wild card, \fB*\fP, may be used.
+.RE
+.B Option
+.RS
+An option for this group. Possible options are given below:
+.P
+.B border
+.RS
+Causes windows in this group to have a border.
+.RE
+.P
+\fBdesktop:\fP\fI#\fP
+.RS
+The desktop on which windows in this group will be started.
+.RE
+.P
+\fBicon:\fP\fIimage.xpm\fP
+.RS
+The icon to be used for windows in this group.
+.RE
+.P
+.\fBlayer:\fP\fI#\fP
+.RS
+The layer on which windows in this group will be started.
+.RE
+.P
+.B maximized
+.RS
+Make windows in this group initially maximized.
+.RE
+.P
+.B minimized
+.RS
+Make windows in this group initially minimized.
+.RE
+.P
+.B noborder
+.RS
+Causes windows in this group to be displayed without a border.
+.RE
+.P
+.B nolist
+.RS
+Causes the tray to ignore windows in this group.
+.RE
+.P
+.B notitle
+.RS
+Causes windows in this group to be displayed without a title bar.
+.RE
+.P
+.B pignore
+.RS
+Ignore initial window position requested by program.
+.RE
+.P
+.B shaded
+.RS
+Make windows in this group initially shaded.
+.RE
+.P
+.B sticky
+.RS
+Make windows in this group sticky.
+.RE
+.P
+.B title
+.RS
+Causes windows in this group to have a title bar.
+.RE
+.RE
+.RE
+
+.B "BORDER STYLE"
+.RS
+The \fBBorderStyle\fP tag controls the look of window borders.
+Within this tag, the following tags are supported:
+.P
+.B Font
+.RS
+The font used for title bars. See Fonts section for more information
+.RE
+.P
+.B Width
+.RS
+The width of window borders in pixels. The default is 5, the minimum is 3,
+and the maximum is 32.
+.RE
+.P
+.B Height
+.RS
+The height of window title bars in pixels. The default is 21, the minimum
+is 2, and the maximum is 64.
+.RE
+.P
+.B Foreground
+.RS
+The color of text on inactive title bars. See the \fBCOLORS\fP section for
+more information.
+.RE
+.P
+.B Background
+.RS
+The border background color for inactive borders. See the \fBCOLORS\fP
+section for more information.
+.RE
+.P
+.B ActiveForeground
+.RS
+The color of text on active title bars. See the \fBCOLORS\fP section for
+more information.
+.RE
+.P
+.B ActiveBackground
+.RS
+The border background color for active borders. See the \fBCOLORS\fP
+section for more information.
+.RE
+.RE
+
+.B "TRAY STYLE"
+.RS
+The \fBTrayStyle\fP tag controls the look of trays.
+Within this tag the following tag is supported:
+.P
+.B Font
+.RS
+The default tray font to use. See the \fBFONTS\fP section for more
+information.
+.RE
+.P
+.B Foreground
+.RS
+The default foreground color. See the \fBCOLORS\fP section for
+more information.
+.RE
+.P
+.B Background
+.RS
+The default background color. See the \fBCOLORS\fP section for
+more information.
+.RE
+.RE
+
+.B "TASK LIST STYLE"
+.RS
+The \fBTaskListStyle\fP tag controls the look of task lists.
+This tag supports the following attribute:
+.P
+\fBinsert\fP \fImode\fP
+.RS
+This determines how new items are added to the task list. Valid options
+are \fBleft\fP and \fBright\fP. The default is \fBright\fP.
+.RE
+.P
+Within this tag the following tags are supported:
+.P
+.B Font
+.RS
+The font used for program names. See the \fBFONTS\fP section for more
+information.
+.RE
+.P
+.B Foreground
+.RS
+The foreground color of the task list. See the \fBCOLORS\fP section for
+more information.
+.RE
+.P
+.B Background
+.RS
+The background color of the task list. See the \fBCOLORS\fP section for
+more information.
+.RE
+.P
+.B ActiveForeground
+.RS
+The foreground color of an active item on the task list. See the \fBCOLORS\fP
+section for more information.
+.RE
+.P
+.B ActiveBackground
+.RS
+The background color of an active item on the task list. See the \fBCOLORS\fP
+section for more information.
+.RE
+.RE
+
+.B "CLOCK STYLE"
+.RS
+The \fBClockStyle\fP tag controls the look of clocks.
+Within this tag, the following tags are supported.
+.P
+.B Font
+.RS
+The font used. See the \fBFONTS\fP section for more information.
+.RE
+.P
+.B Foreground
+.RS
+The color of the text. See the \fBCOLORS\fP section for more information.
+.RE
+.P
+.B Background
+.RS
+The background color. See the \fBCOLORS\fP section for more information.
+.RE
+.RE
+
+.B "PAGER STYLE"
+.RS
+The \fBPagerStyle\fP tag controls the look of pagers.
+Within this tag, the following tags are supported:
+.P
+.B Outline
+.RS
+The color of the outline around windows shown in the pager. See the
+\fBCOLORS\fP section for more information.
+.RE
+.P
+.B Foreground
+.RS
+The color of inactive windows shown in the pager. See the \fBCOLORS\fP
+section for more information.
+.RE
+.P
+.B Background
+.RS
+The background color of inactive desktops shown in the pager. See the
+\fBCOLORS\fP section for more information.
+.RE
+.P
+.B ActiveForeground
+.RS
+The color of active windows shown in the pager. See the \fBCOLORS\fP section
+for more information.
+.RE
+.P
+.B ActiveBackground
+.RS
+The color of active desktops shown in the pager. See the \fBCOLORS\fP
+section for more information.
+.RE
+.RE
+
+.B "MENU STYLE"
+.RS
+The \fBMenuStyle\fP tag controls the look of the menus in JWM
+(this includes the root menu and window menus).
+Within this tag the following tags are supported:
+.P
+.B Font
+.RS
+The font used on menus See the \fBFONTS\fP section for more information.
+.RE
+.P
+.B Foreground
+.RS
+The text color of inactive menu items. See the \fBCOLORS\fP section for more
+information.
+.RE
+.P
+.B Background
+.RS
+The background color of inactive menu items. See the \fBCOLORS\fPsection for
+more information.
+.RE
+.P
+.B ActiveForeground
+.RS
+The text color of active menu items. See the \fBCOLORS\fP section for more
+information.
+.RE
+.P
+.B ActiveBackground
+.RS
+Text background color of active menu items. See the \fBCOLORS\fP section
+for more information.
+.RE
+.RE
+
+.B "POPUP STYLE"
+.RS
+The \fBPopupStyle\fP tag controls the look of popup windows such as those
+shown when the mouse sits over a task list item.
+This tag supports the following attributes:
+.P
+\fBdelay\fP \fIint\fP
+.RS
+The delay in milliseconds before popups activate.
+The default is 600.
+.RE
+.P
+\fBenabled\fP \fIbool\fP
+.RS
+Determine if popups are shown. Default is true.
+.RE
+.P
+Within this tag the following tags are supported:
+.P
+.B Font
+.RS
+The font to use. See the \fBFONTS\fP section for more information.
+.RE
+.P
+.B Outline
+.RS
+The color of the window outline. See the \fBCOLORS\fP section for more
+information.
+.RE
+.P
+.B Foreground
+.RS
+The text color. See the \fBCOLORS\fP section for more information.
+.RE
+.P
+.B Background
+.RS
+The background color. See the \fBCOLORS\fP section for more information.
+.RE
+.RE
+
+.B FONTS
+.RS
+Fonts for various parts of JWM are specified within a \fBFont\fP tag. The
+text of this tag determines the font to use.
+This can be either a standard X font string or, if compiled with XFT
+support, an XFT font string.
+.RE
+
+.B COLORS
+.RS
+Colors for various parts of JWM are specified within specific tags
+(discribed above). Colors may either be hex triplets in RGB format
+(for example, #FF0000 is red) or by a name recognized by the X server.
+.RE
+
+.B ICONS
+.RS
+Icons for windows that don't supply an icon via the _NET_WM_ICON hint are
+located by searching the icon search path(s) for an icon whose name
+(minus the ".xpm" or ".png" extension) matches the instance name of the
+window as returned in the WM_CLASS hint. If this lookup fails, a default
+icon is supplied. This icon will be displayed for the window on it's title
+bar and on the task list. Icons that are not an appropriate size will be
+scaled. Square icons work best.
+.P
+For menu items, the icon path is searched for a match. the icon specified for
+a menu item must be the exact name of the icon file with the extension.
+If no match is found, a blank area will appear where the icon should appear.
+If an icon is not specified for any menu item in a menu, no space will be
+allocated for icons.
+.P
+Zero or more \fBIconPath\fP tags may be specified. The text of this tag is
+assumed to be an absolute directory path to a directory containing XPM 
+and/or PNG icons.
+When searching for icons, if multiple paths are provided, they will be
+searched in order until a match is made.
+Note that icon, PNG, and XPM support are compile-time options.
+.RE
+
+.B "KEY BINDINGS"
+.RS
+Keyboard bindings in JWM are specified in \fBKey\fP tags.
+Either the \fBkey\fP or \fBkeycode\fP attributes must be specified
+to determine which key will cause an action. The optional
+attribute, \fBmask\fP, specifies what key mask, if any, must be in effect
+for the binding to match. Finally, the text of the \fBKey\fP tag is the
+action to perform.
+.P
+One or more of the following key masks may be specified for \fBmask\fP:
+.RS
+.IP \fBA\fP
+The "Alt" key.
+.IP \fBC\fP
+Control
+.IP \fBS\fP
+Shift
+.IP \fBH\fP
+Hyper
+.IP \fBM\fP
+Meta
+.IP \fBP\fP
+Super
+.RE
+.P
+The key specified in the \fBkey\fP attribute must contain a valid key
+string for \fBXStringToKeysym\fP(3). These values are usually what one would
+expect (for example, the escape key is called "Escape").
+.P
+Valid actions for a key binding are:
+.RS
+.IP \fBup\fP
+Move up. Not grabbed.
+.IP \fBdown\fP
+Move down. Not grabbed.
+.IP \fBright\fP
+Move right. Not grabbed.
+.IP \fBleft\fP
+Move left. Not grabbed.
+.IP \fBescape\fP
+Stop a move/resize or exit a menu. Not grabbed.
+.IP \fBselect\fP
+Make a menu selection. Not grabbed.
+.IP \fBnext\fP
+Move to the next window in the task list. Grabbed.
+.IP \fBnextstacked\fP
+Move to the next window in the stacking order. Grabbed.
+.IP \fBclose\fP
+Close the active window. Grabbed.
+.IP \fBminimize\fP
+Minimize the active window. Grabbed.
+.IP \fBmaximize\fP
+Maximize the active window. Grabbed.
+.IP \fBshade\fP
+Shade the active window. Grabbed.
+.IP \fBmove\fP
+Move the active window. Grabbed.
+.IP \fBresize\fP
+Resize the active window. Grabbed.
+.IP \fBroot:\fP\fIn\fP
+Show root menu \fIn\fP. Grabbed.
+.IP \fBwindow\fP
+Show the window menu for the active window. Grabbed.
+.IP \fBdesktop\fP
+Switch to the next desktop. Grabbed.
+.IP \fBdesktop#\fP
+Switch to a specific desktop. To use this, "#" must be specified in
+the key section. The number 1 to the number of desktops configured
+are then substituted for "#". Grabbed.
+.IP \fBexec:\fP\fIcommand\fP
+Execute \fIcommand\fP. Grabbed.
+.IP \fBrestart\fP
+Restart JWM. Grabbed.
+.RE
+.P
+Note that keys that are grabbed will not be available to applications other
+than JWM since JWM will interpret these. Also note that there are no
+default key bindings. Finally, it is possible to bind multiple key
+combinations to the same action.
+.RE
+
+.B "MOUSE BINDINGS"
+.RS
+Any button (other than the scroll wheel) on the root window will bring up
+the root menu unless otherwise specified  via the \fBonroot\fP attribute of
+\fBRootMenu\fP. Scrolling up on the root window switches to the previous
+desktop and scrolling down switches to the next desktop.
+.RE
+.P
+.RS
+The right button will show the window menu on the frame.
+.RE
+.P
+.RS
+The left button will resize if on the border or move if in the title bar.
+.RE
+.P
+.RS
+The middle button will move anywhere on the frame.
+.RE
+.P
+.RS
+A double click on the title bar of a window will toggle the maximized state
+of the window. Scrolling up over the title bar will shade the window and
+scrolling down will unshade the window.
+When a menu is open, the scroll wheel will move through menus.
+When over the pager, the scroll wheel will switch desktops.
+.RE
+
+.B DESKTOPS
+.RS
+Virtual desktops are controlled with the \fBDesktops\fP tag.
+Within this tag the following attribute is supported:
+.P
+\fBcount\fP \fIint\fP
+.RS
+The number of virtual desktops. The default is 4. Valid values are between
+1 and 8 inclusive.
+.RE
+.P
+Desktop names may be assigned via the \fBName\fP tag within the
+\fBDesktops\fP tag.
+.RE
+
+.B "OTHER SETTINGS"
+.P
+.RS
+The following tags may also be supplied:
+.P
+.B DoubleClickDelta
+.RS
+The number of pixels the mouse can move during a double click.
+The default is 2. Valid values are between 0 and 32 inclusive.
+.RE
+.P
+.B DoubleClickSpeed
+.RS
+The maximum number of milliseconds between clicks for a double click.
+The default is 400. Valid values are between 1 and 2000 inclusive.
+.RE
+.P
+.B FocusModel
+.RS
+The focus model to be used. The default is "sloppy". Valid values
+are "click" (click to focus) and "sloppy" (focus follows mouse).
+.RE
+.P
+.B MoveMode
+.RS
+The move mode. The default is "opaque". Valid values are
+"opaque" and "outline". The optional \fBcoordinates\fP attribute
+determines the location of the move status window. Possible values are:
+.RS
+.P
+.B off
+.RS
+Disable the status window.
+.RE
+.P
+.B corner
+.RS
+Place the status window in the corner of the screen.
+.RE
+.P
+.B window
+.RS
+Center the status window on the window being moved.
+.RE
+.P
+.B screen
+.RS
+Center the status window on the screen.
+.RE
+.RE
+.RE
+.P
+.B ResizeMode
+.RS
+The resize mode. The default is "opaque". Valid values are
+"opaque" and "outline". The optional \fBcoordinates\fP attribute
+determines the location of the move status window. Possible values are:
+.RS
+.P
+.B off
+.RS
+Disable the status window.
+.RE
+.P
+.B corner
+.RS
+Place the status window in the corner of the screen.
+.RE
+.P
+.B window
+.RS
+Center the status window on the window being resized.
+.RE
+.P
+.B screen
+.RS
+Center the status window on the screen.
+.RE
+.RE
+.RE
+.P
+.B SnapMode
+.RS
+The snap mode. The default is "border". Valid values are
+"none" (for no snapping), "screen" (for snapping to the edge of the screen),
+and "border" (for snapping to the borders of windows and the screen).
+An optional attribute, \fBdistance\fP,
+specifies the distance for snapping. The default is 5. Valid values
+are between 1 and 32 inclusive.
+.RE
+.P
+.B StartupCommand
+.RS
+A command to run when JWM starts.
+.RE
+.P
+.B ShutdownCommand
+.RS
+A command to run when JWM exits.
+.RE
+.P
+.B RestartCommand
+.RS
+A command to run when JWM restarts.
+.RE
+.RE
+.P
+
+.SH AUTHOR
+Joe Wingbermuehle <joewing@joewing.net>
+
+.SH "SEE ALSO"
+.BR X (1)
+