diff options
Diffstat (limited to 'jwm.1.in')
-rw-r--r-- | jwm.1.in | 1185 |
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) + |