diff options
Diffstat (limited to '')
| -rw-r--r-- | upstream/debian-unstable/man1/icewm.1 | 675 |
1 files changed, 323 insertions, 352 deletions
diff --git a/upstream/debian-unstable/man1/icewm.1 b/upstream/debian-unstable/man1/icewm.1 index fed3c883..8e96ca5a 100644 --- a/upstream/debian-unstable/man1/icewm.1 +++ b/upstream/debian-unstable/man1/icewm.1 @@ -1,4 +1,5 @@ -.\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.43) +.\" -*- mode: troff; coding: utf-8 -*- +.\" Automatically generated by Pod::Man 5.01 (Pod::Simple 3.43) .\" .\" Standard preamble: .\" ======================================================================== @@ -15,29 +16,12 @@ .ft R .fi .. -.\" Set up some character translations and predefined strings. \*(-- will -.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left -.\" double quote, and \*(R" will give a right double quote. \*(C+ will -.\" give a nicer C++. Capital omega is used to do unbreakable dashes and -.\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff, -.\" nothing in troff, for use with C<>. -.tr \(*W- -.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' +.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>. .ie n \{\ -. ds -- \(*W- -. ds PI pi -. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch -. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch -. ds L" "" -. ds R" "" . ds C` "" . ds C' "" 'br\} .el\{\ -. ds -- \|\(em\| -. ds PI \(*p -. ds L" `` -. ds R" '' . ds C` . ds C' 'br\} @@ -68,85 +52,23 @@ . \} .\} .rr rF -.\" -.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2). -.\" Fear. Run. Save yourself. No user-serviceable parts. -. \" fudge factors for nroff and troff -.if n \{\ -. ds #H 0 -. ds #V .8m -. ds #F .3m -. ds #[ \f1 -. ds #] \fP -.\} -.if t \{\ -. ds #H ((1u-(\\\\n(.fu%2u))*.13m) -. ds #V .6m -. ds #F 0 -. ds #[ \& -. ds #] \& -.\} -. \" simple accents for nroff and troff -.if n \{\ -. ds ' \& -. ds ` \& -. ds ^ \& -. ds , \& -. ds ~ ~ -. ds / -.\} -.if t \{\ -. ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u" -. ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u' -. ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u' -. ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u' -. ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u' -. ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u' -.\} -. \" troff and (daisy-wheel) nroff accents -.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V' -.ds 8 \h'\*(#H'\(*b\h'-\*(#H' -.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#] -.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H' -.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u' -.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#] -.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#] -.ds ae a\h'-(\w'a'u*4/10)'e -.ds Ae A\h'-(\w'A'u*4/10)'E -. \" corrections for vroff -.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u' -.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u' -. \" for low resolution devices (crt and lpr) -.if \n(.H>23 .if \n(.V>19 \ -\{\ -. ds : e -. ds 8 ss -. ds o a -. ds d- d\h'-1'\(ga -. ds D- D\h'-1'\(hy -. ds th \o'bp' -. ds Th \o'LP' -. ds ae ae -. ds Ae AE -.\} -.rm #[ #] #H #V #F C .\" ======================================================================== .\" .IX Title "ICEWM 1" -.TH ICEWM 1 "2023-12-31" "icewm\ 3.4.5" "User Commands" +.TH ICEWM 1 2024-05-24 "icewm\ 3.5.0" "User Commands" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh -.SS "\s-1NAME\s0" +.SS NAME .IX Subsection "NAME" .Vb 1 \& icewm \- lightweight X11 window manager .Ve -.SS "\s-1SYNOPSIS\s0" +.SS SYNOPSIS .IX Subsection "SYNOPSIS" -\&\fBicewm\fR [\fI\s-1OPTIONS\s0\fR] -.SS "\s-1DESCRIPTION\s0" +\&\fBicewm\fR [\fIOPTIONS\fR] +.SS DESCRIPTION .IX Subsection "DESCRIPTION" \&\fBicewm\fR is a window manager for the X11 window system. It aims to be small, fast and familiar to new users. @@ -165,11 +87,11 @@ while keeping oversight. This is supported by a task bar and a pager. .PP The installation comes with several themes. Choose a theme via a menu. .PP -\&\fBicewm\fR is compliant with the \s-1ICCCM\s0 and \s-1EWMH\s0 window manager specifications. -.SS "\s-1PROGRAMS\s0" +\&\fBicewm\fR is compliant with the ICCCM and EWMH window manager specifications. +.SS PROGRAMS .IX Subsection "PROGRAMS" The \fBicewm\fR package includes several programs: -.IP "\fBicewm\fR\|(1)" 4 +.IP \fBicewm\fR\|(1) 4 .IX Item "icewm" The actual window manager. It positions application windows on screen and decorates them with borders. It gives input focus to the current @@ -177,7 +99,7 @@ active application. \fBicewm\fR supports different focus modes, which are explained below. It draws a small task bar at the bottom of the screen, that gives easy access to programs, to virtual desktops, to active applications, and to a small set of monitoring applets. -.IP "\fBicewmbg\fR\|(1)" 4 +.IP \fBicewmbg\fR\|(1) 4 .IX Item "icewmbg" The background setting application. It can assign plain background color or images in different formats to the X background. Each workspace can @@ -185,7 +107,7 @@ have its own background. It supports semitransparency. Semitransparent background image and colour can be configured. When the background image has changed then \fBicewmbg\fR\|(1) can be notified to update the background. Multi-head monitor setups are fully supported. See the \fBicewmbg\fR\|(1). -.IP "\fBicewm\-session\fR\|(1)" 4 +.IP \fBicewm\-session\fR\|(1) 4 .IX Item "icewm-session" \&\fBicewm\-session\fR\|(1) is the preferred program to start the IceWM system. It first loads additional environment variables from the optional @@ -195,53 +117,53 @@ On termination the \fIshutdown\fR script will be run first, then \&\fBicewm\-session\fR\|(1) will terminate \fBicewm\fR and \fBicewmbg\fR\|(1). \&\fBicewm\-session\fR\|(1) will also start the optional \fBicesound\fR\|(1) if you give it the \fB\-\-sound\fR option. See \fBicewm\-session\fR\|(1). -.IP "\fBicesh\fR\|(1)" 4 +.IP \fBicesh\fR\|(1) 4 .IX Item "icesh" A powerful tool to control window properties and to interact with the window manager. It is typically used in shell scripts. See \fBicesh\fR\|(1). -.IP "\fBicehelp\fR\|(1)" 4 +.IP \fBicehelp\fR\|(1) 4 .IX Item "icehelp" A small document browser that is used by \fBicewm\fR to display the \&'IceWM manual' and some man pages. -.IP "\fBicewmhint\fR\|(1)" 4 +.IP \fBicewmhint\fR\|(1) 4 .IX Item "icewmhint" A utility for passing IceWM-specific window options to \fBicewm\fR. The options are used to configure the first application that is started subsequently. See \fBicewmhint\fR\|(1). -.IP "\fBicesound\fR\|(1)" 4 +.IP \fBicesound\fR\|(1) 4 .IX Item "icesound" -Plays audio files on \s-1GUI\s0 events that are raised by \fBicewm\fR. -It supports \s-1ALSA, AO\s0 and \s-1OSS.\s0 See the \fBicesound\fR\|(1) man page. -.IP "\fBicewm\-menu\-fdo\fR\|(1)" 4 +Plays audio files on GUI events that are raised by \fBicewm\fR. +It supports ALSA, AO and OSS. See the \fBicesound\fR\|(1) man page. +.IP \fBicewm\-menu\-fdo\fR\|(1) 4 .IX Item "icewm-menu-fdo" Generate an \fBicewm\fR menu with executable desktop applications -according to \s-1XDG\s0 specifications. See the \fBicewm\-menu\-fdo\fR\|(1) man page. -.IP "\fBicewm\-set\-gnomewm\fR\|(1)" 4 +according to XDG specifications. See the \fBicewm\-menu\-fdo\fR\|(1) man page. +.IP \fBicewm\-set\-gnomewm\fR\|(1) 4 .IX Item "icewm-set-gnomewm" -Configures \s-1GNOME\s0 to start IceWM instead of its own \s-1WM.\s0 -.SS "\s-1OPTIONS\s0" +Configures GNOME to start IceWM instead of its own WM. +.SS OPTIONS .IX Subsection "OPTIONS" -.SS "\s-1COMMON OPTIONS\s0" +.SS "COMMON OPTIONS" .IX Subsection "COMMON OPTIONS" Each of the IceWM executables supports the following options: -.IP "\fB\-c\fR, \fB\-\-config\fR=\fI\s-1FILE\s0\fR" 4 +.IP "\fB\-c\fR, \fB\-\-config\fR=\fIFILE\fR" 4 .IX Item "-c, --config=FILE" -Use \fI\s-1FILE\s0\fR as the source of configuration options. By default \fBicewm\fR +Use \fIFILE\fR as the source of configuration options. By default \fBicewm\fR looks for a file named \fIpreferences\fR. This is a readable text file that can be modified with the help of a text editor. -.IP "\fB\-t\fR, \fB\-\-theme\fR=\fI\s-1NAME\s0\fR" 4 +.IP "\fB\-t\fR, \fB\-\-theme\fR=\fINAME\fR" 4 .IX Item "-t, --theme=NAME" -Use \fI\s-1NAME\s0\fR as the name of the \fBicewm\fR theme to use. A theme defines +Use \fINAME\fR as the name of the \fBicewm\fR theme to use. A theme defines the look and feel of \fBicewm\fR, like colors, fonts and buttons. -.IP "\fB\-d\fR, \fB\-\-display\fR=\fI\s-1DISPLAY\s0\fR" 4 +.IP "\fB\-d\fR, \fB\-\-display\fR=\fIDISPLAY\fR" 4 .IX Item "-d, --display=DISPLAY" -Connect to the X11 server on \fI\s-1DISPLAY\s0\fR. By default +Connect to the X11 server on \fIDISPLAY\fR. By default the environment variable \f(CW\*(C`DISPLAY\*(C'\fR is used. .IP "\fB\-o\fR, \fB\-\-output=FILE\fR" 4 .IX Item "-o, --output=FILE" -Redirect all output to \fI\s-1FILE\s0\fR. +Redirect all output to \fIFILE\fR. A leading tilde or environment variable is expanded. -.IP "\fB\-\-sync\fR" 4 +.IP \fB\-\-sync\fR 4 .IX Item "--sync" This option specifies to use a slower synchronous communication mode with the X11 server. This is irrelevant for normal use. @@ -252,17 +174,17 @@ some very brief explanation. .IP "\fB\-V\fR, \fB\-\-version\fR" 4 .IX Item "-V, --version" Shows the software release version for this program. -.SS "\s-1ICEWM OPTIONS\s0" +.SS "ICEWM OPTIONS" .IX Subsection "ICEWM OPTIONS" The \fBicewm\fR program supports some additional options: .IP "\fB\-a\fR, \fB\-\-alpha\fR" 4 .IX Item "-a, --alpha" Use a 32\-bit visual for translucency. This can also be set in the preferences file as \f(CW\*(C`Alpha=1\*(C'\fR. -.IP "\fB\-\-replace\fR" 4 +.IP \fB\-\-replace\fR 4 .IX Item "--replace" Instructs \fBicewm\fR to replace an existing window manager. Provided that -the window manager being replaced is \s-1ICCCM 2.0\s0 compliant, once it +the window manager being replaced is ICCCM 2.0 compliant, once it notices that it is to be replaced it will cease operations and typically stop execution. This allows \fBicewm\fR to establish itself as the only active window manager. @@ -270,16 +192,16 @@ active window manager. .IX Item "-r, --restart" Tell \fBicewm\fR to restart itself. This reloads the configuration from file. If no window manager is active, then it starts one. -.IP "\fB\-s\fR, \fB\-\-splash\fR=\fI\s-1IMAGE\s0\fR" 4 +.IP "\fB\-s\fR, \fB\-\-splash\fR=\fIIMAGE\fR" 4 .IX Item "-s, --splash=IMAGE" -Briefly show \fI\s-1IMAGE\s0\fR on startup in the center of the screen. +Briefly show \fIIMAGE\fR on startup in the center of the screen. This can also be set in the preferences file as Splash=\f(CW\*(C`image.jpg\*(C'\fR. -.IP "\fB\-\-configured\fR" 4 +.IP \fB\-\-configured\fR 4 .IX Item "--configured" Shows a list of configuration options that were enabled when \fBicewm\fR was compiled from source code. This can be helpful if one suspects some functionality may be missing. -.IP "\fB\-\-directories\fR" 4 +.IP \fB\-\-directories\fR 4 .IX Item "--directories" Gives a list of directories where \fBicewm\fR will look for configuration data. This list is printed in the actual order in which \fBicewm\fR uses @@ -288,26 +210,30 @@ it to search for configuration files. .IX Item "-l, --list-themes" \&\fBicewm\fR will search all the configuration directories for theme files and print a list of all found themes. +.IP "\fB\-i\fR, \fB\-\-install\fR=\fITHEME\fR" 4 +.IX Item "-i, --install=THEME" +Install \fITHEME\fR from icewm-extra and exit. When \fITHEME\fR is \fIlist\fR, +print a listing of available themes to install. .IP "\fB\-p\fR, \fB\-\-postpreferences\fR" 4 .IX Item "-p, --postpreferences" This gives a long list of all the internal \fBicewm\fR options with their actual values after \fBicewm\fR has processed all of the configuration and theme files. In some advanced scenarios this can be helpful to inspect which configuration was chosen or whether option formatting was correct. -.IP "\fB\-\-rewrite\-preferences\fR" 4 +.IP \fB\-\-rewrite\-preferences\fR 4 .IX Item "--rewrite-preferences" Overwrite an existing preferences file with an icewm default preferences, but preserve all modifications insofar they deviate from the defaults. -.IP "\fB\-\-extensions\fR" 4 +.IP \fB\-\-extensions\fR 4 .IX Item "--extensions" Give a list of the current X extensions, their versions and status. -.IP "\fB\-\-trace\fR=\fIconf\fR,\fIfont\fR,\fIicon\fR,\fIprog\fR,\fIsystray\fR" 4 +.IP \fB\-\-trace\fR=\fIconf\fR,\fIfont\fR,\fIicon\fR,\fIprog\fR,\fIsystray\fR 4 .IX Item "--trace=conf,font,icon,prog,systray" Enable tracing of the paths that are used to load configuration, fonts, icons, executed programs, and/or system tray applets. -.SS "\s-1USAGE\s0" +.SS USAGE .IX Subsection "USAGE" -.SS "\s-1TASKBAR\s0" +.SS TASKBAR .IX Subsection "TASKBAR" On startup \fBicewm\fR launches the task bar at the bottom of the screen. The task bar consists from left to right of the following components: @@ -360,17 +286,17 @@ accessed by right-clicking the bottom right corner of the taskbar. .PP The \fITray Applet\fR shows system tray objects. .PP -The \fI\s-1APM\s0 Applet\fR shows battery power status. +The \fIAPM Applet\fR shows battery power status. .PP The \fINet Applet\fR shows network activity. Network devices to monitor are given by the \f(CW\*(C`NetworkStatusDevice\*(C'\fR option. .PP The \fIMemory Applet\fR monitors memory usage. .PP -The \fI\s-1CPU\s0 Applet\fR monitors processor utilization. +The \fICPU Applet\fR monitors processor utilization. .PP The \fIMailbox Applet\fR monitors mailbox status changes. -See the section \s-1MAILBOX MONITORING\s0 below. +See the section MAILBOX MONITORING below. .PP The \fIClock Applet\fR shows the current time and date. It is configured by the \f(CW\*(C`TimeFormat\*(C'\fR option. @@ -380,7 +306,7 @@ The \fITask Bar Collapse\fR button collapses the task bar and hides it. Not all \fBicewm\fR applets may show up on the task bar. They must have been enabled during configuration of the \fBicewm\fR software. Their appearance is also controlled by options in the \fIpreferences\fR file. -.SS "\s-1INPUT FOCUS\s0" +.SS "INPUT FOCUS" .IX Subsection "INPUT FOCUS" Of all visible windows only one can be the active window. This is the window that has input focus. It is the primary receiver of keyboard @@ -448,7 +374,7 @@ ways by keyboard. By pressing \f(CW\*(C`Alt+Esc\*(C'\fR or \f(CW\*(C`Alt+Shift+ input focus is immediately changed to the next or previous window, which will be raised to make it fully visible. The other method involves the quick switch. -.SS "\s-1QUICK SWITCH\s0" +.SS "QUICK SWITCH" .IX Subsection "QUICK SWITCH" The \fBQuickSwitch\fR is a means to quickly and interactively change the input focus to another window. It is activated by pressing the @@ -475,7 +401,7 @@ The QuickSwitch has two distinct modes: vertical and horizontal. The window list can include all windows or be limited to the current workspace. There is an option to raise the selected candidate. See the many preferences available for the QuickSwitch. -.SS "\s-1WINDOW PLACEMENT\s0" +.SS "WINDOW PLACEMENT" .IX Subsection "WINDOW PLACEMENT" A second important task of a window manager is to place new windows on the screen. By default \fBicewm\fR chooses a placement with minimal @@ -486,7 +412,7 @@ also turn on \f(CW\*(C`ManualPlacement\*(C'\fR. Then new windows appear initial the top left corner and the mouse cursor changes into a fist. By moving the fist cursor to a suitable location and clicking the new window will appear at the mouse click location. -.SS "\s-1WINDOW LAYERS\s0" +.SS "WINDOW LAYERS" .IX Subsection "WINDOW LAYERS" Windows can overlap. Which window appears on top is determined by three features. Newer windows appear over older windows. By clicking on a @@ -496,7 +422,7 @@ menu. Click with the right mouse button on the window frame and select \&\fILayer\fR. From there choose one of seven window layers. These are ordered from higher to lower. Windows in higher layers appear over windows in lower layers. -.SS "\s-1TABBED WINDOWS\s0" +.SS "TABBED WINDOWS" .IX Subsection "TABBED WINDOWS" A window frame may contain multiple client windows. Only one client can be visible, while the others are hidden. This is called tabbing. This @@ -508,17 +434,17 @@ to merge the client of the upper window to the lower frame. Now the lower frame will have multiple clients, called tabs. The title bar will show a vertical bar with triple dots to indicate this. To change the current tab either: -.IP "\(bu" 4 +.IP \(bu 4 Click on the triple dots next to the vertical bar. -.IP "\(bu" 4 +.IP \(bu 4 Use \f(CW\*(C`KeyWinNext=Alt+F6\*(C'\fR to select the next tab. -.IP "\(bu" 4 +.IP \(bu 4 Use \f(CW\*(C`KeyWinPrev=Alt+Shift+F6\*(C'\fR for the previous tab. -.IP "\(bu" 4 +.IP \(bu 4 Use the QuickSwitch. -.IP "\(bu" 4 +.IP \(bu 4 Use the window list window. -.IP "\(bu" 4 +.IP \(bu 4 Use a submenu in the window menu. .PP To change the mouse binding for creating tabs, modify @@ -542,7 +468,7 @@ To open all chrome windows in the same frame add this to \f(CW\*(C`winoptions\*( .Vb 1 \& google\-chrome.frame: chrome .Ve -.SS "\s-1WORKSPACES\s0" +.SS WORKSPACES .IX Subsection "WORKSPACES" \&\fBicewm\fR supports multiple virtual desktops called workspaces. A workspace is like a screen where a subset of all application windows are @@ -574,7 +500,7 @@ to wait before a change of workspace occurs. To move an application window to a different workspace one can use a keyboard shortcut. Another option is to select the \fIMove To\fR submenu in the window menu of the window frame. -.SS "\s-1DRAG AND DROP\s0" +.SS "DRAG AND DROP" .IX Subsection "DRAG AND DROP" The task bar supports drag and drop operations. When a drag is in progress, the destination window can be activated by @@ -583,22 +509,75 @@ Alternatively, the current workspace can be changed by hovering the drag icon over the desired workspace button. When edge switching is enabled, the current workspace can also be changed by bringing the drag icon to the screen edge. -.SS "\s-1ADDRESS BAR\s0" +.SS "ADDRESS BAR" .IX Subsection "ADDRESS BAR" -If \fBEnableAddressBar\fR=1 then \fBKeySysAddressBar\fR=\f(CW\*(C`Alt+Ctrl+Space\*(C'\fR -activates the address bar in the task bar. -If \fBShowAddressBar\fR=1 it is always shown. This is a command-line in -the task bar where a shell command can be typed. -Pressing \f(CW\*(C`Enter\*(C'\fR will execute the command. -\&\fBAddressBarCommand\fR=\f(CW\*(C`/bin/sh\*(C'\fR will be used to execute the command. -On \f(CW\*(C`Control+Enter\*(C'\fR the command is executed in a terminal +The task bar contains a command-line prompt called the address bar, +if \fBEnableAddressBar\fR=1. It is always shown when \fBShowAddressBar\fR=1, +otherwise it is activated by \fBKeySysAddressBar\fR=\f(CW\*(C`Alt+Ctrl+Space\*(C'\fR. +In it a shell command can be typed, which is executed by the +\&\fBAddressBarCommand\fR=\f(CW\*(C`/bin/sh\*(C'\fR when pressing \f(CW\*(C`Enter\*(C'\fR. +On \f(CW\*(C`Control+Enter\*(C'\fR this command is executed in a new terminal as given by \fBTerminalCommand\fR. -The address bar maintains a history that is navigable by the \fIUp\fR -and \fIDown\fR keys. -It supports command completion using \f(CW\*(C`Tab\*(C'\fR or \f(CW\*(C`Ctrl+I\*(C'\fR. -A rich set of editing operations is supported, -including cut\-/copy\-/paste\-operations. -.SS "\s-1WINDOW LIST\s0" +.PP +Commands are executed relative to the working directory of icewm. +This can be shown by executing \f(CW\*(C`pwd\*(C'\fR. It can be changed using the \f(CW\*(C`cd\*(C'\fR +command. Without argument it defaults to the home directory. With one +argument it is changed. This argument is expanded when it starts with a +dollar or tilde. When it is equal to \f(CW\*(C`\-\*(C'\fR, it reverts to the previous +directory. +.PP +The address bar has a history that is navigable by \fIUp\fR and \fIDown\fR. +It supports file completion using \f(CW\*(C`Tab\*(C'\fR or \f(CW\*(C`Ctrl+I\*(C'\fR, cut/copy/paste +and these editing operations: +.IP "Ctrl+a: select all" 4 +.IX Item "Ctrl+a: select all" +.PD 0 +.IP "Ctrl+backslash: deselect all" 4 +.IX Item "Ctrl+backslash: deselect all" +.IP "Ctrl+u: delete selected or to line start" 4 +.IX Item "Ctrl+u: delete selected or to line start" +.IP "Ctrl+v: paste selected" 4 +.IX Item "Ctrl+v: paste selected" +.IP "Ctrl+w: delete selected or previous word" 4 +.IX Item "Ctrl+w: delete selected or previous word" +.IP "Ctrl+x: cut selection" 4 +.IX Item "Ctrl+x: cut selection" +.IP "Ctrl+c: copy selection" 4 +.IX Item "Ctrl+c: copy selection" +.IP "Ctrl+i: completion" 4 +.IX Item "Ctrl+i: completion" +.IP "Ctrl+Left: back a word" 4 +.IX Item "Ctrl+Left: back a word" +.IP "Ctrl+Right: forward a word" 4 +.IX Item "Ctrl+Right: forward a word" +.IP "Ctrl+Shift+Backspace: delete to beginning" 4 +.IX Item "Ctrl+Shift+Backspace: delete to beginning" +.IP "Ctrl+Shift+Delete: delete to end" 4 +.IX Item "Ctrl+Shift+Delete: delete to end" +.IP "Ctrl+Delete: delete word" 4 +.IX Item "Ctrl+Delete: delete word" +.IP "Ctrl+Backspace: delete previous word" 4 +.IX Item "Ctrl+Backspace: delete previous word" +.IP "Shift+Delete: cut selection" 4 +.IX Item "Shift+Delete: cut selection" +.IP "Shift+Insert: paste selected" 4 +.IX Item "Shift+Insert: paste selected" +.IP "Tab: completion" 4 +.IX Item "Tab: completion" +.IP "Left: move cursor left" 4 +.IX Item "Left: move cursor left" +.IP "Right: move cursor right" 4 +.IX Item "Right: move cursor right" +.IP "Home: move cursor to line start" 4 +.IX Item "Home: move cursor to line start" +.IP "End: move cursor to line end" 4 +.IX Item "End: move cursor to line end" +.IP "Delete: delete next character" 4 +.IX Item "Delete: delete next character" +.IP "Backspace: delete previous character" 4 +.IX Item "Backspace: delete previous character" +.PD +.SS "WINDOW LIST" .IX Subsection "WINDOW LIST" The window list window shows a list of all workspaces. For each workspace it shows the window titles of the windows that are mapped @@ -607,15 +586,15 @@ windows. These windows are mapped in all workspaces. .PP The window list window is normally hidden. Choose one of the following four methods to make it visible: -.IP "\(bu" 4 +.IP \(bu 4 Select the bottom window list menu entry. -.IP "\(bu" 4 +.IP \(bu 4 Press the \f(CW\*(C`KeySysWindowList=Ctrl+Alt+Esc\*(C'\fR key. -.IP "\(bu" 4 +.IP \(bu 4 Press the right Windows key if \f(CW\*(C`Win95Keys=1\*(C'\fR -.IP "\(bu" 4 +.IP \(bu 4 Press the \f(CW\*(C`DesktopWinListButton=2\*(C'\fR mouse button in the root window. -.IP "\(bu" 4 +.IP \(bu 4 Press the middle mouse button in a workspace button on the task bar. .PP A single-click on a window entry selects it. A group of windows can @@ -637,7 +616,7 @@ repeatedly pressing the first letter cycles over those windows. \&\f(CW\*(C`Home\*(C'\fR selects the first entry and \f(CW\*(C`End\*(C'\fR the last. \f(CW\*(C`PageUp\*(C'\fR and \&\f(CW\*(C`PageDown\*(C'\fR move up or down by ten entries. Combine this with the \&\f(CW\*(C`Shift\*(C'\fR key to extend a selection over the range of motion. -.SS "\s-1SYSTEM DIALOG\s0" +.SS "SYSTEM DIALOG" .IX Subsection "SYSTEM DIALOG" The system dialog offers quick access to a set of general controls. It can lock the screen, suspend the system, logout or cancel a pending @@ -645,10 +624,10 @@ logout, reboot the system, shutdown the system, show the window list, restart icewm, show the about dialog, reload the winoptions file or the keys file. It is activated by \fBKeySysDialog\fR=\f(CW\*(C`Ctrl+Alt+Del\*(C'\fR. To cancel it, hit the Escape key. -.SS "\s-1MAILBOX MONITORING\s0" +.SS "MAILBOX MONITORING" .IX Subsection "MAILBOX MONITORING" The task bar can show one or more icons to reflect the status of a -mailbox. The mailbox can be a local file or a remote \s-1POP\s0 or \s-1IMAP\s0 +mailbox. The mailbox can be a local file or a remote POP or IMAP account. For this a couple of options must be set. First, \&\fITaskBarShowMailboxStatus\fR must be enabled, which it is by default. Then the location of the mailbox must be set. Icewm first looks for @@ -656,7 +635,7 @@ Then the location of the mailbox must be set. Icewm first looks for environment variables \f(CW\*(C`MAILPATH\*(C'\fR and \f(CW\*(C`MAIL\*(C'\fR. \fIMailBoxPath\fR may contain a space-separated list of mailboxes, while \f(CW\*(C`MAILPATH\*(C'\fR may contain a colon-separated list of mailboxes. If a mailbox starts -with a slash \f(CW\*(C`/\*(C'\fR, then it is a local file, otherwise a \s-1URL.\s0 +with a slash \f(CW\*(C`/\*(C'\fR, then it is a local file, otherwise a URL. These are six examples of possible mailboxes: .PP .Vb 6 @@ -668,9 +647,9 @@ These are six examples of possible mailboxes: \& imaps://mathias:password@imap.gmail.com/INBOX .Ve .PP -The \s-1POP3S\s0 and \s-1IMAPS\s0 schemes use \f(CW\*(C`openssl\*(C'\fR for \s-1TLS/SSL\s0 encryption. +The POP3S and IMAPS schemes use \f(CW\*(C`openssl\*(C'\fR for TLS/SSL encryption. Note that for IceWM to access Gmail you must first configure -your Gmail account to enable \s-1POP3\s0 or \s-1IMAP\s0 access. +your Gmail account to enable POP3 or IMAP access. Make sure you have secure file permissions on your IceWM preferences file and the directory that contains it. .PP @@ -701,23 +680,23 @@ The color will indicate if the mail has been read or not. Hovering the mouse over the mailbox icon will show a tooltip with more details. A command can be also be run on new mail. Set the \fINewMailCommand\fR option. Its environment will have these variables set by IceWM: -.IP "\s-1ICEWM_MAILBOX\s0" 4 +.IP ICEWM_MAILBOX 4 .IX Item "ICEWM_MAILBOX" The mailbox index number of \fIMailBoxPath\fR starting from 1. -.IP "\s-1ICEWM_COUNT\s0" 4 +.IP ICEWM_COUNT 4 .IX Item "ICEWM_COUNT" The total number of messages in this mailbox. -.IP "\s-1ICEWM_UNREAD\s0" 4 +.IP ICEWM_UNREAD 4 .IX Item "ICEWM_UNREAD" The number of unread messages in this mailbox. -.SS "\s-1KEYBOARD LAYOUT SWITCHING\s0" +.SS "KEYBOARD LAYOUT SWITCHING" .IX Subsection "KEYBOARD LAYOUT SWITCHING" To control keyboard layouts on the task bar, define in \fIpreferences\fR the option \fBKeyboardLayouts\fR to a comma-separated list of your preferred keyboard layouts. For example: .PP .Vb 1 -\& KeyboardLayouts="de","fr","jp" +\& KeyboardLayouts = "de", "fr", "jp" .Ve .PP A keyboard layout can simply be a name. Usually this is a two-letter @@ -746,7 +725,7 @@ on the task bar will be updated to reflect this. Please note that for keyboard layout switching to work, the \&\f(CW\*(C`setxkbmap\*(C'\fR program must be installed. To see your current keyboard layout settings, do \f(CW\*(C`setxkbmap \-query\*(C'\fR. -.SS "\s-1KEYBOARD SHORTCUTS\s0" +.SS "KEYBOARD SHORTCUTS" .IX Subsection "KEYBOARD SHORTCUTS" \&\fBicewm\fR supports a large number of hotkeys to activate some behaviour with a single key combination. These are all configurable in the @@ -759,404 +738,394 @@ following modifiers: Alt, AltGr, Ctrl, Hyper, Meta, Shift, Super. Setting \fBModSuperIsCtrlAlt=1\fR makes the Super modifier an alias for Ctrl+Alt. .ie n .IP "\fBKeyWinRaise\fR=""Alt+F1""" 4 -.el .IP "\fBKeyWinRaise\fR=\f(CWAlt+F1\fR" 4 +.el .IP \fBKeyWinRaise\fR=\f(CWAlt+F1\fR 4 .IX Item "KeyWinRaise=Alt+F1" Raises the window that currently has input focus. .ie n .IP "\fBKeyWinOccupyAll\fR=""Alt+F2""" 4 -.el .IP "\fBKeyWinOccupyAll\fR=\f(CWAlt+F2\fR" 4 +.el .IP \fBKeyWinOccupyAll\fR=\f(CWAlt+F2\fR 4 .IX Item "KeyWinOccupyAll=Alt+F2" Makes the active window occupy all workspaces. .ie n .IP "\fBKeyWinLower\fR=""Alt+F3""" 4 -.el .IP "\fBKeyWinLower\fR=\f(CWAlt+F3\fR" 4 +.el .IP \fBKeyWinLower\fR=\f(CWAlt+F3\fR 4 .IX Item "KeyWinLower=Alt+F3" Lowers the window that currently has input focus. .ie n .IP "\fBKeyWinClose\fR=""Alt+F4""" 4 -.el .IP "\fBKeyWinClose\fR=\f(CWAlt+F4\fR" 4 +.el .IP \fBKeyWinClose\fR=\f(CWAlt+F4\fR 4 .IX Item "KeyWinClose=Alt+F4" Closes the active window. .ie n .IP "\fBKeyWinRestore\fR=""Alt+F5""" 4 -.el .IP "\fBKeyWinRestore\fR=\f(CWAlt+F5\fR" 4 +.el .IP \fBKeyWinRestore\fR=\f(CWAlt+F5\fR 4 .IX Item "KeyWinRestore=Alt+F5" Restores the active window to its visible state. .ie n .IP "\fBKeyWinNext\fR=""Alt+F6""" 4 -.el .IP "\fBKeyWinNext\fR=\f(CWAlt+F6\fR" 4 +.el .IP \fBKeyWinNext\fR=\f(CWAlt+F6\fR 4 .IX Item "KeyWinNext=Alt+F6" Switches focus to the next window. .ie n .IP "\fBKeyWinPrev\fR=""Alt+Shift+F6""" 4 -.el .IP "\fBKeyWinPrev\fR=\f(CWAlt+Shift+F6\fR" 4 +.el .IP \fBKeyWinPrev\fR=\f(CWAlt+Shift+F6\fR 4 .IX Item "KeyWinPrev=Alt+Shift+F6" Switches focus to the previous window. .ie n .IP "\fBKeyWinMove\fR=""Alt+F7""" 4 -.el .IP "\fBKeyWinMove\fR=\f(CWAlt+F7\fR" 4 +.el .IP \fBKeyWinMove\fR=\f(CWAlt+F7\fR 4 .IX Item "KeyWinMove=Alt+F7" Starts movement of the active window. .ie n .IP "\fBKeyWinSize\fR=""Alt+F8""" 4 -.el .IP "\fBKeyWinSize\fR=\f(CWAlt+F8\fR" 4 +.el .IP \fBKeyWinSize\fR=\f(CWAlt+F8\fR 4 .IX Item "KeyWinSize=Alt+F8" Starts resizing of the active window. .ie n .IP "\fBKeyWinMinimize\fR=""Alt+F9""" 4 -.el .IP "\fBKeyWinMinimize\fR=\f(CWAlt+F9\fR" 4 +.el .IP \fBKeyWinMinimize\fR=\f(CWAlt+F9\fR 4 .IX Item "KeyWinMinimize=Alt+F9" Iconifies the active window. .ie n .IP "\fBKeyWinMaximize\fR=""Alt+F10""" 4 -.el .IP "\fBKeyWinMaximize\fR=\f(CWAlt+F10\fR" 4 +.el .IP \fBKeyWinMaximize\fR=\f(CWAlt+F10\fR 4 .IX Item "KeyWinMaximize=Alt+F10" Maximizes the active window with borders. .ie n .IP "\fBKeyWinMaximizeVert\fR=""Alt+Shift+F10""" 4 -.el .IP "\fBKeyWinMaximizeVert\fR=\f(CWAlt+Shift+F10\fR" 4 +.el .IP \fBKeyWinMaximizeVert\fR=\f(CWAlt+Shift+F10\fR 4 .IX Item "KeyWinMaximizeVert=Alt+Shift+F10" Maximizes the active window vertically. .ie n .IP "\fBKeyWinMaximizeHoriz\fR=""undefined""" 4 -.el .IP "\fBKeyWinMaximizeHoriz\fR=\f(CWundefined\fR" 4 +.el .IP \fBKeyWinMaximizeHoriz\fR=\f(CWundefined\fR 4 .IX Item "KeyWinMaximizeHoriz=undefined" Maximizes the active window horizontally. .ie n .IP "\fBKeyWinFullscreen\fR=""Alt+F11""" 4 -.el .IP "\fBKeyWinFullscreen\fR=\f(CWAlt+F11\fR" 4 +.el .IP \fBKeyWinFullscreen\fR=\f(CWAlt+F11\fR 4 .IX Item "KeyWinFullscreen=Alt+F11" Maximizes the active window without borders. .ie n .IP "\fBKeyWinRollup\fR=""Alt+F12""" 4 -.el .IP "\fBKeyWinRollup\fR=\f(CWAlt+F12\fR" 4 +.el .IP \fBKeyWinRollup\fR=\f(CWAlt+F12\fR 4 .IX Item "KeyWinRollup=Alt+F12" Rolls up the active window. .ie n .IP "\fBKeyWinHide\fR=""Alt+Shift+F12""" 4 -.el .IP "\fBKeyWinHide\fR=\f(CWAlt+Shift+F12\fR" 4 +.el .IP \fBKeyWinHide\fR=\f(CWAlt+Shift+F12\fR 4 .IX Item "KeyWinHide=Alt+Shift+F12" Hides the active window. .ie n .IP "\fBKeyWinMenu\fR=""Alt+Space""" 4 -.el .IP "\fBKeyWinMenu\fR=\f(CWAlt+Space\fR" 4 +.el .IP \fBKeyWinMenu\fR=\f(CWAlt+Space\fR 4 .IX Item "KeyWinMenu=Alt+Space" Posts the window menu. .ie n .IP "\fBKeyWinArrangeNW\fR=""Ctrl+Alt+KP_7""" 4 -.el .IP "\fBKeyWinArrangeNW\fR=\f(CWCtrl+Alt+KP_7\fR" 4 +.el .IP \fBKeyWinArrangeNW\fR=\f(CWCtrl+Alt+KP_7\fR 4 .IX Item "KeyWinArrangeNW=Ctrl+Alt+KP_7" Moves the active window to the top left corner of the screen. .ie n .IP "\fBKeyWinArrangeN\fR=""Ctrl+Alt+KP_8""" 4 -.el .IP "\fBKeyWinArrangeN\fR=\f(CWCtrl+Alt+KP_8\fR" 4 +.el .IP \fBKeyWinArrangeN\fR=\f(CWCtrl+Alt+KP_8\fR 4 .IX Item "KeyWinArrangeN=Ctrl+Alt+KP_8" Moves the active window to the top middle of the screen. .ie n .IP "\fBKeyWinArrangeNE\fR=""Ctrl+Alt+KP_9""" 4 -.el .IP "\fBKeyWinArrangeNE\fR=\f(CWCtrl+Alt+KP_9\fR" 4 +.el .IP \fBKeyWinArrangeNE\fR=\f(CWCtrl+Alt+KP_9\fR 4 .IX Item "KeyWinArrangeNE=Ctrl+Alt+KP_9" Moves the active window to the top right of the screen. .ie n .IP "\fBKeyWinArrangeE\fR=""Ctrl+Alt+KP_6""" 4 -.el .IP "\fBKeyWinArrangeE\fR=\f(CWCtrl+Alt+KP_6\fR" 4 +.el .IP \fBKeyWinArrangeE\fR=\f(CWCtrl+Alt+KP_6\fR 4 .IX Item "KeyWinArrangeE=Ctrl+Alt+KP_6" Moves the active window to the middle right of the screen. .ie n .IP "\fBKeyWinArrangeSE\fR=""Ctrl+Alt+KP_3""" 4 -.el .IP "\fBKeyWinArrangeSE\fR=\f(CWCtrl+Alt+KP_3\fR" 4 +.el .IP \fBKeyWinArrangeSE\fR=\f(CWCtrl+Alt+KP_3\fR 4 .IX Item "KeyWinArrangeSE=Ctrl+Alt+KP_3" Moves the active window to the bottom right of the screen. .ie n .IP "\fBKeyWinArrangeS\fR=""Ctrl+Alt+KP_2""" 4 -.el .IP "\fBKeyWinArrangeS\fR=\f(CWCtrl+Alt+KP_2\fR" 4 +.el .IP \fBKeyWinArrangeS\fR=\f(CWCtrl+Alt+KP_2\fR 4 .IX Item "KeyWinArrangeS=Ctrl+Alt+KP_2" Moves the active window to the bottom middle of the screen. .ie n .IP "\fBKeyWinArrangeSW\fR=""Ctrl+Alt+KP_1""" 4 -.el .IP "\fBKeyWinArrangeSW\fR=\f(CWCtrl+Alt+KP_1\fR" 4 +.el .IP \fBKeyWinArrangeSW\fR=\f(CWCtrl+Alt+KP_1\fR 4 .IX Item "KeyWinArrangeSW=Ctrl+Alt+KP_1" Moves the active window to the bottom left of the screen. .ie n .IP "\fBKeyWinArrangeW\fR=""Ctrl+Alt+KP_4""" 4 -.el .IP "\fBKeyWinArrangeW\fR=\f(CWCtrl+Alt+KP_4\fR" 4 +.el .IP \fBKeyWinArrangeW\fR=\f(CWCtrl+Alt+KP_4\fR 4 .IX Item "KeyWinArrangeW=Ctrl+Alt+KP_4" Moves the active window to the middle left of the screen. .ie n .IP "\fBKeyWinArrangeC\fR=""Ctrl+Alt+KP_5""" 4 -.el .IP "\fBKeyWinArrangeC\fR=\f(CWCtrl+Alt+KP_5\fR" 4 +.el .IP \fBKeyWinArrangeC\fR=\f(CWCtrl+Alt+KP_5\fR 4 .IX Item "KeyWinArrangeC=Ctrl+Alt+KP_5" Moves the active window to the center of the screen. -.ie n .IP "\fBKeyWinTileLeft\fR=""""" 4 -.el .IP "\fBKeyWinTileLeft\fR=``''" 4 +.IP "\fBKeyWinTileLeft\fR=""""" 4 .IX Item "KeyWinTileLeft=""""" Let the active window occupy the left half of the screen. -.ie n .IP "\fBKeyWinTileRight\fR=""""" 4 -.el .IP "\fBKeyWinTileRight\fR=``''" 4 +.IP "\fBKeyWinTileRight\fR=""""" 4 .IX Item "KeyWinTileRight=""""" Let the active window occupy the right half of the screen. -.ie n .IP "\fBKeyWinTileTop\fR=""""" 4 -.el .IP "\fBKeyWinTileTop\fR=``''" 4 +.IP "\fBKeyWinTileTop\fR=""""" 4 .IX Item "KeyWinTileTop=""""" Let the active window occupy the top half of the screen. -.ie n .IP "\fBKeyWinTileBottom\fR=""""" 4 -.el .IP "\fBKeyWinTileBottom\fR=``''" 4 +.IP "\fBKeyWinTileBottom\fR=""""" 4 .IX Item "KeyWinTileBottom=""""" Let the active window occupy the bottom half of the screen. -.ie n .IP "\fBKeyWinTileTopLeft\fR=""""" 4 -.el .IP "\fBKeyWinTileTopLeft\fR=``''" 4 +.IP "\fBKeyWinTileTopLeft\fR=""""" 4 .IX Item "KeyWinTileTopLeft=""""" Let the active window occupy the top left quarter of the screen. -.ie n .IP "\fBKeyWinTileTopRight\fR=""""" 4 -.el .IP "\fBKeyWinTileTopRight\fR=``''" 4 +.IP "\fBKeyWinTileTopRight\fR=""""" 4 .IX Item "KeyWinTileTopRight=""""" Let the active window occupy the top right quarter of the screen. -.ie n .IP "\fBKeyWinTileBottomLeft\fR=""""" 4 -.el .IP "\fBKeyWinTileBottomLeft\fR=``''" 4 +.IP "\fBKeyWinTileBottomLeft\fR=""""" 4 .IX Item "KeyWinTileBottomLeft=""""" Let the active window occupy the bottom left quarter of the screen. -.ie n .IP "\fBKeyWinTileBottomRight\fR=""""" 4 -.el .IP "\fBKeyWinTileBottomRight\fR=``''" 4 +.IP "\fBKeyWinTileBottomRight\fR=""""" 4 .IX Item "KeyWinTileBottomRight=""""" Let the active window occupy the bottom right quarter of the screen. -.ie n .IP "\fBKeyWinTileCenter\fR=""""" 4 -.el .IP "\fBKeyWinTileCenter\fR=``''" 4 +.IP "\fBKeyWinTileCenter\fR=""""" 4 .IX Item "KeyWinTileCenter=""""" Let the active window occupy the center quarter of the screen. .ie n .IP "\fBKeyWinSmartPlace\fR=""Ctrl+Alt+Shift+KP_5""" 4 -.el .IP "\fBKeyWinSmartPlace\fR=\f(CWCtrl+Alt+Shift+KP_5\fR" 4 +.el .IP \fBKeyWinSmartPlace\fR=\f(CWCtrl+Alt+Shift+KP_5\fR 4 .IX Item "KeyWinSmartPlace=Ctrl+Alt+Shift+KP_5" Smart place the active window. .ie n .IP "\fBKeySysWinMenu\fR=""Shift+Esc""" 4 -.el .IP "\fBKeySysWinMenu\fR=\f(CWShift+Esc\fR" 4 +.el .IP \fBKeySysWinMenu\fR=\f(CWShift+Esc\fR 4 .IX Item "KeySysWinMenu=Shift+Esc" Posts the system window menu. .ie n .IP "\fBKeySysWinNext\fR=""Alt+Esc""" 4 -.el .IP "\fBKeySysWinNext\fR=\f(CWAlt+Esc\fR" 4 +.el .IP \fBKeySysWinNext\fR=\f(CWAlt+Esc\fR 4 .IX Item "KeySysWinNext=Alt+Esc" Give focus to the next window and raise it. .ie n .IP "\fBKeySysWinPrev\fR=""Alt+Shift+Esc""" 4 -.el .IP "\fBKeySysWinPrev\fR=\f(CWAlt+Shift+Esc\fR" 4 +.el .IP \fBKeySysWinPrev\fR=\f(CWAlt+Shift+Esc\fR 4 .IX Item "KeySysWinPrev=Alt+Shift+Esc" Give focus to the previous window and raise it. .ie n .IP "\fBKeySysDialog\fR=""Ctrl+Alt+Del""" 4 -.el .IP "\fBKeySysDialog\fR=\f(CWCtrl+Alt+Del\fR" 4 +.el .IP \fBKeySysDialog\fR=\f(CWCtrl+Alt+Del\fR 4 .IX Item "KeySysDialog=Ctrl+Alt+Del" Opens the IceWM system dialog in the center of the screen. .ie n .IP "\fBKeySysMenu\fR=""Ctrl+Esc""" 4 -.el .IP "\fBKeySysMenu\fR=\f(CWCtrl+Esc\fR" 4 +.el .IP \fBKeySysMenu\fR=\f(CWCtrl+Esc\fR 4 .IX Item "KeySysMenu=Ctrl+Esc" Activates the IceWM root menu in the lower left corner. .ie n .IP "\fBKeySysWindowList\fR=""Alt+Ctrl+Esc""" 4 -.el .IP "\fBKeySysWindowList\fR=\f(CWAlt+Ctrl+Esc\fR" 4 +.el .IP \fBKeySysWindowList\fR=\f(CWAlt+Ctrl+Esc\fR 4 .IX Item "KeySysWindowList=Alt+Ctrl+Esc" Opens the IceWM system window list in the center of the screen. .ie n .IP "\fBKeySysAddressBar\fR=""Alt+Ctrl+Space""" 4 -.el .IP "\fBKeySysAddressBar\fR=\f(CWAlt+Ctrl+Space\fR" 4 +.el .IP \fBKeySysAddressBar\fR=\f(CWAlt+Ctrl+Space\fR 4 .IX Item "KeySysAddressBar=Alt+Ctrl+Space" Opens the address bar in the task bar where a command can be typed. .ie n .IP "\fBKeySysWorkspacePrev\fR=""Alt+Ctrl+Left""" 4 -.el .IP "\fBKeySysWorkspacePrev\fR=\f(CWAlt+Ctrl+Left\fR" 4 +.el .IP \fBKeySysWorkspacePrev\fR=\f(CWAlt+Ctrl+Left\fR 4 .IX Item "KeySysWorkspacePrev=Alt+Ctrl+Left" Goes one workspace to the left. .ie n .IP "\fBKeySysWorkspaceNext\fR=""Alt+Ctrl+Right""" 4 -.el .IP "\fBKeySysWorkspaceNext\fR=\f(CWAlt+Ctrl+Right\fR" 4 +.el .IP \fBKeySysWorkspaceNext\fR=\f(CWAlt+Ctrl+Right\fR 4 .IX Item "KeySysWorkspaceNext=Alt+Ctrl+Right" Goes one workspace to the right. .ie n .IP "\fBKeySysWorkspaceLast\fR=""Alt+Ctrl+Down""" 4 -.el .IP "\fBKeySysWorkspaceLast\fR=\f(CWAlt+Ctrl+Down\fR" 4 +.el .IP \fBKeySysWorkspaceLast\fR=\f(CWAlt+Ctrl+Down\fR 4 .IX Item "KeySysWorkspaceLast=Alt+Ctrl+Down" Goes to the previous workspace. .ie n .IP "\fBKeySysWorkspacePrevTakeWin\fR=""Alt+Ctrl+Shift+Left""" 4 -.el .IP "\fBKeySysWorkspacePrevTakeWin\fR=\f(CWAlt+Ctrl+Shift+Left\fR" 4 +.el .IP \fBKeySysWorkspacePrevTakeWin\fR=\f(CWAlt+Ctrl+Shift+Left\fR 4 .IX Item "KeySysWorkspacePrevTakeWin=Alt+Ctrl+Shift+Left" Takes the active window one workspace to the left. .ie n .IP "\fBKeySysWorkspaceNextTakeWin\fR=""Alt+Ctrl+Shift+Right""" 4 -.el .IP "\fBKeySysWorkspaceNextTakeWin\fR=\f(CWAlt+Ctrl+Shift+Right\fR" 4 +.el .IP \fBKeySysWorkspaceNextTakeWin\fR=\f(CWAlt+Ctrl+Shift+Right\fR 4 .IX Item "KeySysWorkspaceNextTakeWin=Alt+Ctrl+Shift+Right" Takes the active window one workspace to the right. .ie n .IP "\fBKeySysWorkspaceLastTakeWin\fR=""Alt+Ctrl+Shift+Down""" 4 -.el .IP "\fBKeySysWorkspaceLastTakeWin\fR=\f(CWAlt+Ctrl+Shift+Down\fR" 4 +.el .IP \fBKeySysWorkspaceLastTakeWin\fR=\f(CWAlt+Ctrl+Shift+Down\fR 4 .IX Item "KeySysWorkspaceLastTakeWin=Alt+Ctrl+Shift+Down" Takes the active window to the previous workspace. .ie n .IP "\fBKeySysWorkspace1\fR=""Alt+Ctrl+1""" 4 -.el .IP "\fBKeySysWorkspace1\fR=\f(CWAlt+Ctrl+1\fR" 4 +.el .IP \fBKeySysWorkspace1\fR=\f(CWAlt+Ctrl+1\fR 4 .IX Item "KeySysWorkspace1=Alt+Ctrl+1" Goes to workspace 1. .ie n .IP "\fBKeySysWorkspace2\fR=""Alt+Ctrl+2""" 4 -.el .IP "\fBKeySysWorkspace2\fR=\f(CWAlt+Ctrl+2\fR" 4 +.el .IP \fBKeySysWorkspace2\fR=\f(CWAlt+Ctrl+2\fR 4 .IX Item "KeySysWorkspace2=Alt+Ctrl+2" Goes to workspace 2. .ie n .IP "\fBKeySysWorkspace3\fR=""Alt+Ctrl+3""" 4 -.el .IP "\fBKeySysWorkspace3\fR=\f(CWAlt+Ctrl+3\fR" 4 +.el .IP \fBKeySysWorkspace3\fR=\f(CWAlt+Ctrl+3\fR 4 .IX Item "KeySysWorkspace3=Alt+Ctrl+3" Goes to workspace 3. .ie n .IP "\fBKeySysWorkspace4\fR=""Alt+Ctrl+4""" 4 -.el .IP "\fBKeySysWorkspace4\fR=\f(CWAlt+Ctrl+4\fR" 4 +.el .IP \fBKeySysWorkspace4\fR=\f(CWAlt+Ctrl+4\fR 4 .IX Item "KeySysWorkspace4=Alt+Ctrl+4" Goes to workspace 4. .ie n .IP "\fBKeySysWorkspace5\fR=""Alt+Ctrl+5""" 4 -.el .IP "\fBKeySysWorkspace5\fR=\f(CWAlt+Ctrl+5\fR" 4 +.el .IP \fBKeySysWorkspace5\fR=\f(CWAlt+Ctrl+5\fR 4 .IX Item "KeySysWorkspace5=Alt+Ctrl+5" Goes to workspace 5. .ie n .IP "\fBKeySysWorkspace6\fR=""Alt+Ctrl+6""" 4 -.el .IP "\fBKeySysWorkspace6\fR=\f(CWAlt+Ctrl+6\fR" 4 +.el .IP \fBKeySysWorkspace6\fR=\f(CWAlt+Ctrl+6\fR 4 .IX Item "KeySysWorkspace6=Alt+Ctrl+6" Goes to workspace 6. .ie n .IP "\fBKeySysWorkspace7\fR=""Alt+Ctrl+7""" 4 -.el .IP "\fBKeySysWorkspace7\fR=\f(CWAlt+Ctrl+7\fR" 4 +.el .IP \fBKeySysWorkspace7\fR=\f(CWAlt+Ctrl+7\fR 4 .IX Item "KeySysWorkspace7=Alt+Ctrl+7" Goes to workspace 7. .ie n .IP "\fBKeySysWorkspace8\fR=""Alt+Ctrl+8""" 4 -.el .IP "\fBKeySysWorkspace8\fR=\f(CWAlt+Ctrl+8\fR" 4 +.el .IP \fBKeySysWorkspace8\fR=\f(CWAlt+Ctrl+8\fR 4 .IX Item "KeySysWorkspace8=Alt+Ctrl+8" Goes to workspace 8. .ie n .IP "\fBKeySysWorkspace9\fR=""Alt+Ctrl+9""" 4 -.el .IP "\fBKeySysWorkspace9\fR=\f(CWAlt+Ctrl+9\fR" 4 +.el .IP \fBKeySysWorkspace9\fR=\f(CWAlt+Ctrl+9\fR 4 .IX Item "KeySysWorkspace9=Alt+Ctrl+9" Goes to workspace 9. .ie n .IP "\fBKeySysWorkspace10\fR=""Alt+Ctrl+0""" 4 -.el .IP "\fBKeySysWorkspace10\fR=\f(CWAlt+Ctrl+0\fR" 4 +.el .IP \fBKeySysWorkspace10\fR=\f(CWAlt+Ctrl+0\fR 4 .IX Item "KeySysWorkspace10=Alt+Ctrl+0" Goes to workspace 10. .ie n .IP "\fBKeySysWorkspace11\fR=""Alt+Ctrl+minus""" 4 -.el .IP "\fBKeySysWorkspace11\fR=\f(CWAlt+Ctrl+minus\fR" 4 +.el .IP \fBKeySysWorkspace11\fR=\f(CWAlt+Ctrl+minus\fR 4 .IX Item "KeySysWorkspace11=Alt+Ctrl+minus" Goes to workspace 11. .ie n .IP "\fBKeySysWorkspace12\fR=""Alt+Ctrl+equal""" 4 -.el .IP "\fBKeySysWorkspace12\fR=\f(CWAlt+Ctrl+equal\fR" 4 +.el .IP \fBKeySysWorkspace12\fR=\f(CWAlt+Ctrl+equal\fR 4 .IX Item "KeySysWorkspace12=Alt+Ctrl+equal" Goes to workspace 12. .ie n .IP "\fBKeySysWorkspace1TakeWin\fR=""Alt+Ctrl+Shift+1""" 4 -.el .IP "\fBKeySysWorkspace1TakeWin\fR=\f(CWAlt+Ctrl+Shift+1\fR" 4 +.el .IP \fBKeySysWorkspace1TakeWin\fR=\f(CWAlt+Ctrl+Shift+1\fR 4 .IX Item "KeySysWorkspace1TakeWin=Alt+Ctrl+Shift+1" Takes the active window to workspace 1. .ie n .IP "\fBKeySysWorkspace2TakeWin\fR=""Alt+Ctrl+Shift+2""" 4 -.el .IP "\fBKeySysWorkspace2TakeWin\fR=\f(CWAlt+Ctrl+Shift+2\fR" 4 +.el .IP \fBKeySysWorkspace2TakeWin\fR=\f(CWAlt+Ctrl+Shift+2\fR 4 .IX Item "KeySysWorkspace2TakeWin=Alt+Ctrl+Shift+2" Takes the active window to workspace 2. .ie n .IP "\fBKeySysWorkspace3TakeWin\fR=""Alt+Ctrl+Shift+3""" 4 -.el .IP "\fBKeySysWorkspace3TakeWin\fR=\f(CWAlt+Ctrl+Shift+3\fR" 4 +.el .IP \fBKeySysWorkspace3TakeWin\fR=\f(CWAlt+Ctrl+Shift+3\fR 4 .IX Item "KeySysWorkspace3TakeWin=Alt+Ctrl+Shift+3" Takes the active window to workspace 3. .ie n .IP "\fBKeySysWorkspace4TakeWin\fR=""Alt+Ctrl+Shift+4""" 4 -.el .IP "\fBKeySysWorkspace4TakeWin\fR=\f(CWAlt+Ctrl+Shift+4\fR" 4 +.el .IP \fBKeySysWorkspace4TakeWin\fR=\f(CWAlt+Ctrl+Shift+4\fR 4 .IX Item "KeySysWorkspace4TakeWin=Alt+Ctrl+Shift+4" Takes the active window to workspace 4. .ie n .IP "\fBKeySysWorkspace5TakeWin\fR=""Alt+Ctrl+Shift+5""" 4 -.el .IP "\fBKeySysWorkspace5TakeWin\fR=\f(CWAlt+Ctrl+Shift+5\fR" 4 +.el .IP \fBKeySysWorkspace5TakeWin\fR=\f(CWAlt+Ctrl+Shift+5\fR 4 .IX Item "KeySysWorkspace5TakeWin=Alt+Ctrl+Shift+5" Takes the active window to workspace 5. .ie n .IP "\fBKeySysWorkspace6TakeWin\fR=""Alt+Ctrl+Shift+6""" 4 -.el .IP "\fBKeySysWorkspace6TakeWin\fR=\f(CWAlt+Ctrl+Shift+6\fR" 4 +.el .IP \fBKeySysWorkspace6TakeWin\fR=\f(CWAlt+Ctrl+Shift+6\fR 4 .IX Item "KeySysWorkspace6TakeWin=Alt+Ctrl+Shift+6" Takes the active window to workspace 6. .ie n .IP "\fBKeySysWorkspace7TakeWin\fR=""Alt+Ctrl+Shift+7""" 4 -.el .IP "\fBKeySysWorkspace7TakeWin\fR=\f(CWAlt+Ctrl+Shift+7\fR" 4 +.el .IP \fBKeySysWorkspace7TakeWin\fR=\f(CWAlt+Ctrl+Shift+7\fR 4 .IX Item "KeySysWorkspace7TakeWin=Alt+Ctrl+Shift+7" Takes the active window to workspace 7. .ie n .IP "\fBKeySysWorkspace8TakeWin\fR=""Alt+Ctrl+Shift+8""" 4 -.el .IP "\fBKeySysWorkspace8TakeWin\fR=\f(CWAlt+Ctrl+Shift+8\fR" 4 +.el .IP \fBKeySysWorkspace8TakeWin\fR=\f(CWAlt+Ctrl+Shift+8\fR 4 .IX Item "KeySysWorkspace8TakeWin=Alt+Ctrl+Shift+8" Takes the active window to workspace 8. .ie n .IP "\fBKeySysWorkspace9TakeWin\fR=""Alt+Ctrl+Shift+9""" 4 -.el .IP "\fBKeySysWorkspace9TakeWin\fR=\f(CWAlt+Ctrl+Shift+9\fR" 4 +.el .IP \fBKeySysWorkspace9TakeWin\fR=\f(CWAlt+Ctrl+Shift+9\fR 4 .IX Item "KeySysWorkspace9TakeWin=Alt+Ctrl+Shift+9" Takes the active window to workspace 9. .ie n .IP "\fBKeySysWorkspace10TakeWin\fR=""Alt+Ctrl+Shift+0""" 4 -.el .IP "\fBKeySysWorkspace10TakeWin\fR=\f(CWAlt+Ctrl+Shift+0\fR" 4 +.el .IP \fBKeySysWorkspace10TakeWin\fR=\f(CWAlt+Ctrl+Shift+0\fR 4 .IX Item "KeySysWorkspace10TakeWin=Alt+Ctrl+Shift+0" Takes the active window to workspace 10. .ie n .IP "\fBKeySysWorkspace11TakeWin\fR=""Alt+Ctrl+Shift+minus""" 4 -.el .IP "\fBKeySysWorkspace11TakeWin\fR=\f(CWAlt+Ctrl+Shift+minus\fR" 4 +.el .IP \fBKeySysWorkspace11TakeWin\fR=\f(CWAlt+Ctrl+Shift+minus\fR 4 .IX Item "KeySysWorkspace11TakeWin=Alt+Ctrl+Shift+minus" Takes the active window to workspace 11. .ie n .IP "\fBKeySysWorkspace12TakeWin\fR=""Alt+Ctrl+Shift+equal""" 4 -.el .IP "\fBKeySysWorkspace12TakeWin\fR=\f(CWAlt+Ctrl+Shift+equal\fR" 4 +.el .IP \fBKeySysWorkspace12TakeWin\fR=\f(CWAlt+Ctrl+Shift+equal\fR 4 .IX Item "KeySysWorkspace12TakeWin=Alt+Ctrl+Shift+equal" Takes the active window to workspace 12. .ie n .IP "\fBKeySysTileVertical\fR=""Alt+Shift+F2""" 4 -.el .IP "\fBKeySysTileVertical\fR=\f(CWAlt+Shift+F2\fR" 4 +.el .IP \fBKeySysTileVertical\fR=\f(CWAlt+Shift+F2\fR 4 .IX Item "KeySysTileVertical=Alt+Shift+F2" Tiles all windows from left to right maximized vertically. .ie n .IP "\fBKeySysTileHorizontal\fR=""Alt+Shift+F3""" 4 -.el .IP "\fBKeySysTileHorizontal\fR=\f(CWAlt+Shift+F3\fR" 4 +.el .IP \fBKeySysTileHorizontal\fR=\f(CWAlt+Shift+F3\fR 4 .IX Item "KeySysTileHorizontal=Alt+Shift+F3" Tiles all windows from top to bottom maximized horizontally. .ie n .IP "\fBKeySysCascade\fR=""Alt+Shift+F4""" 4 -.el .IP "\fBKeySysCascade\fR=\f(CWAlt+Shift+F4\fR" 4 +.el .IP \fBKeySysCascade\fR=\f(CWAlt+Shift+F4\fR 4 .IX Item "KeySysCascade=Alt+Shift+F4" Makes a horizontal cascade of all windows which are maximized vertically. .ie n .IP "\fBKeySysArrange\fR=""Alt+Shift+F5""" 4 -.el .IP "\fBKeySysArrange\fR=\f(CWAlt+Shift+F5\fR" 4 +.el .IP \fBKeySysArrange\fR=\f(CWAlt+Shift+F5\fR 4 .IX Item "KeySysArrange=Alt+Shift+F5" Rearranges the windows. .ie n .IP "\fBKeySysUndoArrange\fR=""Alt+Shift+F7""" 4 -.el .IP "\fBKeySysUndoArrange\fR=\f(CWAlt+Shift+F7\fR" 4 +.el .IP \fBKeySysUndoArrange\fR=\f(CWAlt+Shift+F7\fR 4 .IX Item "KeySysUndoArrange=Alt+Shift+F7" Undoes arrangement. .ie n .IP "\fBKeySysArrangeIcons\fR=""Alt+Shift+F8""" 4 -.el .IP "\fBKeySysArrangeIcons\fR=\f(CWAlt+Shift+F8\fR" 4 +.el .IP \fBKeySysArrangeIcons\fR=\f(CWAlt+Shift+F8\fR 4 .IX Item "KeySysArrangeIcons=Alt+Shift+F8" Rearranges icons. .ie n .IP "\fBKeySysMinimizeAll\fR=""Alt+Shift+F9""" 4 -.el .IP "\fBKeySysMinimizeAll\fR=\f(CWAlt+Shift+F9\fR" 4 +.el .IP \fBKeySysMinimizeAll\fR=\f(CWAlt+Shift+F9\fR 4 .IX Item "KeySysMinimizeAll=Alt+Shift+F9" Minimizes all windows. .ie n .IP "\fBKeySysHideAll\fR=""Alt+Shift+F11""" 4 -.el .IP "\fBKeySysHideAll\fR=\f(CWAlt+Shift+F11\fR" 4 +.el .IP \fBKeySysHideAll\fR=\f(CWAlt+Shift+F11\fR 4 .IX Item "KeySysHideAll=Alt+Shift+F11" Hides all windows. .ie n .IP "\fBKeySysShowDesktop\fR=""Alt+Ctrl+d""" 4 -.el .IP "\fBKeySysShowDesktop\fR=\f(CWAlt+Ctrl+d\fR" 4 +.el .IP \fBKeySysShowDesktop\fR=\f(CWAlt+Ctrl+d\fR 4 .IX Item "KeySysShowDesktop=Alt+Ctrl+d" Unmaps all windows to show the desktop. .ie n .IP "\fBKeySysCollapseTaskBar\fR=""Alt+Ctrl+h""" 4 -.el .IP "\fBKeySysCollapseTaskBar\fR=\f(CWAlt+Ctrl+h\fR" 4 +.el .IP \fBKeySysCollapseTaskBar\fR=\f(CWAlt+Ctrl+h\fR 4 .IX Item "KeySysCollapseTaskBar=Alt+Ctrl+h" Hides the task bar. .ie n .IP "\fBKeyTaskBarSwitchNext\fR=""undefined""" 4 -.el .IP "\fBKeyTaskBarSwitchNext\fR=\f(CWundefined\fR" 4 +.el .IP \fBKeyTaskBarSwitchNext\fR=\f(CWundefined\fR 4 .IX Item "KeyTaskBarSwitchNext=undefined" Switches to the next window in the task bar. .ie n .IP "\fBKeyTaskBarSwitchPrev\fR=""undefined""" 4 -.el .IP "\fBKeyTaskBarSwitchPrev\fR=\f(CWundefined\fR" 4 +.el .IP \fBKeyTaskBarSwitchPrev\fR=\f(CWundefined\fR 4 .IX Item "KeyTaskBarSwitchPrev=undefined" Switches to the previous window in the task bar. .ie n .IP "\fBKeyTaskBarMoveNext\fR=""undefined""" 4 -.el .IP "\fBKeyTaskBarMoveNext\fR=\f(CWundefined\fR" 4 +.el .IP \fBKeyTaskBarMoveNext\fR=\f(CWundefined\fR 4 .IX Item "KeyTaskBarMoveNext=undefined" Moves the task bar button of the current window right. .ie n .IP "\fBKeyTaskBarMovePrev\fR=""undefined""" 4 -.el .IP "\fBKeyTaskBarMovePrev\fR=\f(CWundefined\fR" 4 +.el .IP \fBKeyTaskBarMovePrev\fR=\f(CWundefined\fR 4 .IX Item "KeyTaskBarMovePrev=undefined" Moves the task bar button of the current window left. .ie n .IP "\fBKeySysWinListMenu\fR=""undefined""" 4 -.el .IP "\fBKeySysWinListMenu\fR=\f(CWundefined\fR" 4 +.el .IP \fBKeySysWinListMenu\fR=\f(CWundefined\fR 4 .IX Item "KeySysWinListMenu=undefined" Shows the window list menu. .ie n .IP "\fBKeySysKeyboardNext\fR=""undefined""" 4 -.el .IP "\fBKeySysKeyboardNext\fR=\f(CWundefined\fR" 4 +.el .IP \fBKeySysKeyboardNext\fR=\f(CWundefined\fR 4 .IX Item "KeySysKeyboardNext=undefined" Switch to the next keyboard layout in the KeyboardLayouts list. .ie n .IP "\fBKeySysSwitchNext\fR=""Alt+Tab""" 4 -.el .IP "\fBKeySysSwitchNext\fR=\f(CWAlt+Tab\fR" 4 +.el .IP \fBKeySysSwitchNext\fR=\f(CWAlt+Tab\fR 4 .IX Item "KeySysSwitchNext=Alt+Tab" -Opens the \f(CW\*(C`QuickSwitch\*(C'\fR popup (see \*(L"\s-1INPUT FOCUS\*(R"\s0) +Opens the \f(CW\*(C`QuickSwitch\*(C'\fR popup (see "INPUT FOCUS") and/or moves the selector in the \f(CW\*(C`QuickSwitch\*(C'\fR popup. .ie n .IP "\fBKeySysSwitchLast\fR=""Alt+Shift+Tab""" 4 -.el .IP "\fBKeySysSwitchLast\fR=\f(CWAlt+Shift+Tab\fR" 4 +.el .IP \fBKeySysSwitchLast\fR=\f(CWAlt+Shift+Tab\fR 4 .IX Item "KeySysSwitchLast=Alt+Shift+Tab" Works like \f(CW\*(C`KeySysSwitchNext\*(C'\fR but moving in the opposite direction. .ie n .IP "\fBKeySysSwitchClass\fR=""Alt+grave""" 4 -.el .IP "\fBKeySysSwitchClass\fR=\f(CWAlt+grave\fR" 4 +.el .IP \fBKeySysSwitchClass\fR=\f(CWAlt+grave\fR 4 .IX Item "KeySysSwitchClass=Alt+grave" Is like \f(CW\*(C`KeySysSwitchNext\*(C'\fR but only for windows -with the same \s-1WM_CLASS\s0 property as the currently focused window. -.SS "\s-1MOUSE BINDINGS\s0" +with the same WM_CLASS property as the currently focused window. +.SS "MOUSE BINDINGS" .IX Subsection "MOUSE BINDINGS" You can control windows by a modified mouse button press: .ie n .IP "\fBMouseWinMove\fR=""Alt+Pointer_Button1""" 4 -.el .IP "\fBMouseWinMove\fR=\f(CWAlt+Pointer_Button1\fR" 4 +.el .IP \fBMouseWinMove\fR=\f(CWAlt+Pointer_Button1\fR 4 .IX Item "MouseWinMove=Alt+Pointer_Button1" Moves the window under the mouse over the screen. .ie n .IP "\fBMouseWinSize\fR=""Alt+Pointer_Button3""" 4 -.el .IP "\fBMouseWinSize\fR=\f(CWAlt+Pointer_Button3\fR" 4 +.el .IP \fBMouseWinSize\fR=\f(CWAlt+Pointer_Button3\fR 4 .IX Item "MouseWinSize=Alt+Pointer_Button3" Resizes the window. Keep the key and button pressed. To enlarge the window move the mouse button away from the center. To shrink it move towards the centre. .ie n .IP "\fBMouseWinRaise\fR=""Ctrl+Alt+Pointer_Button1""" 4 -.el .IP "\fBMouseWinRaise\fR=\f(CWCtrl+Alt+Pointer_Button1\fR" 4 +.el .IP \fBMouseWinRaise\fR=\f(CWCtrl+Alt+Pointer_Button1\fR 4 .IX Item "MouseWinRaise=Ctrl+Alt+Pointer_Button1" Raises the window under the mouse. .ie n .IP "\fBMouseWinLower\fR=""Ctrl+Alt+Pointer_Button1""" 4 -.el .IP "\fBMouseWinLower\fR=\f(CWCtrl+Alt+Pointer_Button1\fR" 4 +.el .IP \fBMouseWinLower\fR=\f(CWCtrl+Alt+Pointer_Button1\fR 4 .IX Item "MouseWinLower=Ctrl+Alt+Pointer_Button1" Lowers the window under the mouse. If this is equal to \f(CW\*(C`MouseWinRaise\*(C'\fR and the window can be raised then \f(CW\*(C`MouseWinRaise\*(C'\fR takes preference over \f(CW\*(C`MouseWinLower\*(C'\fR. -.ie n .IP "\fBMouseWinTabbing\fR=""Shift+Pointer_Button2""" 4 -.el .IP "\fBMouseWinTabbing\fR=``Shift+Pointer_Button2''" 4 -.IX Item "MouseWinTabbing=Shift+Pointer_Button2" +.IP "\fBMouseWinTabbing\fR=""Shift+Pointer_Button2""" 4 +.IX Item "MouseWinTabbing=""Shift+Pointer_Button2""" Mouse binding to create tabs. Drag the title bar with this button over another title bar. When they start to flash, release the button to merge the frame tabs. @@ -1179,87 +1148,90 @@ Clicking on the desktop activates a menu. The middle button shows the window list (\f(CW\*(C`DesktopWinListButton=2\*(C'\fR). The right button shows the root menu (\f(CW\*(C`DesktopMenuButton=3\*(C'\fR). If you press \f(CW\*(C`Ctrl+Alt\*(C'\fR then the mouse wheel will focus all applications in turn. -.SS "\s-1SIGNALS\s0" +.SS SIGNALS .IX Subsection "SIGNALS" \&\fBicewm\fR supports the following signals: -.IP "\fB\s-1SIGHUP\s0\fR" 4 +.IP \fBSIGHUP\fR 4 .IX Item "SIGHUP" \&\fBicewm\fR will restart itself. It is a way to reload the configuration. -.IP "\fB\s-1SIGINT\s0\fR, \fB\s-1SIGTERM\s0\fR" 4 +.IP "\fBSIGINT\fR, \fBSIGTERM\fR" 4 .IX Item "SIGINT, SIGTERM" \&\fBicewm\fR will cease to manage application windows and terminate. -.IP "\fB\s-1SIGQUIT\s0\fR" 4 +.IP \fBSIGQUIT\fR 4 .IX Item "SIGQUIT" \&\fBicewm\fR will initiate the logout procedure. If a \f(CW\*(C`LogoutCommand\*(C'\fR preferences option was configured it will be executed. -.IP "\fB\s-1SIGUSR2\s0\fR" 4 +.IP \fBSIGUSR2\fR 4 .IX Item "SIGUSR2" Toggle the logging of X11 events, if \f(CW\*(C`logevents\*(C'\fR was configured. -.SS "\s-1ENVIRONMENT VARIABLES\s0" +.SS "ENVIRONMENT VARIABLES" .IX Subsection "ENVIRONMENT VARIABLES" -.IP "\fB\s-1ICEWM_PRIVCFG\s0\fR" 4 +.IP \fBICEWM_PRIVCFG\fR 4 .IX Item "ICEWM_PRIVCFG" The directory for user private configuration files. When this environment variable is not specified, the default directory is -\&\fI\f(CI$XDG_CONFIG_HOME\fI/icewm\fR when that directory exists, otherwise the -default value is \fI\f(CI$HOME\fI/.icewm\fR. -.IP "\fB\s-1DISPLAY\s0\fR" 4 +\&\fR\f(CI$XDG_CONFIG_HOME\fR\fI/icewm\fR when that directory exists, otherwise the +default value is \fI\fR\f(CI$HOME\fR\fI/.icewm\fR. +.IP \fBDISPLAY\fR 4 .IX Item "DISPLAY" The name of the X11 server. See \fBXorg\fR\|(1) or \fBXserver\fR\|(1). This value can be overridden by the \fB\-\-display\fR option. -.IP "\fB\s-1MAILPATH\s0\fR, \fB\s-1MAIL\s0\fR" 4 +.IP "\fBMAILPATH\fR, \fBMAIL\fR" 4 .IX Item "MAILPATH, MAIL" Gives the location of your mailbox. If the schema is omitted the local -\&\*(L"file\*(R" schema is assumed. This is used by the mailbox applet in the +"file" schema is assumed. This is used by the mailbox applet in the task bar to show the status of your mailbox. If the \f(CW\*(C`MailBoxPath\*(C'\fR option in the \fIpreferences\fR file is set, then that one takes precedence. -.SS "\s-1FILES\s0" +.SS FILES .IX Subsection "FILES" -.SS "\s-1CONFIGURATION DIRECTORIES\s0" +.SS "CONFIGURATION DIRECTORIES" .IX Subsection "CONFIGURATION DIRECTORIES" \&\fBicewm\fR looks for configuration files in the following directories, in the given order, until it finds one: -.IP "\fI\f(CI$ICEWM_PRIVCFG\fI/\fR" 4 +.ie n .IP \fR\fI$ICEWM_PRIVCFG\fR\fI/\fR 4 +.el .IP \fR\f(CI$ICEWM_PRIVCFG\fR\fI/\fR 4 .IX Item "$ICEWM_PRIVCFG/" -Contains user-specific configurations. When \fB\s-1ICEWM_PRIVCFG\s0\fR is +Contains user-specific configurations. When \fBICEWM_PRIVCFG\fR is specified, this directory takes precedence over -\&\fI\f(CI$XDG_CONFIG_HOME\fI/icewm\fR and \fI\f(CI$HOME\fI/.icewm\fR. -.IP "\fI\f(CI$XDG_CONFIG_HOME\fI/icewm/\fR" 4 +\&\fR\f(CI$XDG_CONFIG_HOME\fR\fI/icewm\fR and \fI\fR\f(CI$HOME\fR\fI/.icewm\fR. +.ie n .IP \fR\fI$XDG_CONFIG_HOME\fR\fI/icewm/\fR 4 +.el .IP \fR\f(CI$XDG_CONFIG_HOME\fR\fI/icewm/\fR 4 .IX Item "$XDG_CONFIG_HOME/icewm/" Contains user-specific configurations. When this directory exists it -take precedence over \fI\f(CI$HOME\fI/.icewm\fR. -.IP "\fI\f(CI$HOME\fI/.icewm/\fR" 4 +take precedence over \fR\f(CI$HOME\fR\fI/.icewm\fR. +.ie n .IP \fR\fI$HOME\fR\fI/.icewm/\fR 4 +.el .IP \fR\f(CI$HOME\fR\fI/.icewm/\fR 4 .IX Item "$HOME/.icewm/" Contains user-specific configurations. This is the historical default directory. -.IP "\fI/etc/X11/icewm/\fR" 4 +.IP \fI/etc/X11/icewm/\fR 4 .IX Item "/etc/X11/icewm/" Contains system-wide customized defaults. Please note that your local installation may have been configured to use a different system location. The output of \f(CW\*(C`icewm \-\-directories\*(C'\fR will show this location. -.IP "\fI/usr/share/icewm/\fR" 4 +.IP \fI/usr/share/icewm/\fR 4 .IX Item "/usr/share/icewm/" Default local installation settings. -.SS "\s-1CONFIGURATION FILES\s0" +.SS "CONFIGURATION FILES" .IX Subsection "CONFIGURATION FILES" -.IP "\fIenv\fR" 4 +.IP \fIenv\fR 4 .IX Item "env" \&\fBicewm\-session\fR\|(1) loads additional environment variables from the file -\&\fIenv\fR. Each line is subjected to \s-1POSIX\s0 shell expansion by +\&\fIenv\fR. Each line is subjected to POSIX shell expansion by \&\fBwordexp\fR\|(3). Comment lines starting by a hash-sign (\f(CW\*(C`#\*(C'\fR) are ignored. \&\fBicewm\-session\fR\|(1) will load those expanded lines that contain a name, followed by an equals sign, followed by the value (which may be empty). .Sp See \fBicewm\-env\fR\|(5). -.IP "\fIfocus_mode\fR" 4 +.IP \fIfocus_mode\fR 4 .IX Item "focus_mode" Defines the initial value for \f(CW\*(C`FocusMode\*(C'\fR. Its default value is \&\f(CW\*(C`FocusMode=1\*(C'\fR (Click-to-focus). This can be changed via the menu. \&\fBicewm\fR will save the Focus menu choice in this file. .Sp See \fBicewm\-focus_mode\fR\|(5). -.IP "\fIkeys\fR" 4 +.IP \fIkeys\fR 4 .IX Item "keys" Global keybindings to launch applications, which need not be window manager related. Each non-empty line starts with the word \f(CW\*(C`key\*(C'\fR. @@ -1274,7 +1246,7 @@ creates a hotkey to reload the \fBicewm\fR configuration: .Ve .Sp See \fBicewm\-keys\fR\|(5). -.IP "\fImenu\fR" 4 +.IP \fImenu\fR 4 .IX Item "menu" A menu of applications; usually customized by the user. \fBicewm\fR provides the \fBicewm\-menu\-fdo\fR\|(1) program to generate a default menu. @@ -1282,7 +1254,7 @@ Similar programs are \fBxdg_menu\fR\|(1), \fBmmaker\fR\|(1) (MenuMaker), \&\fBxde\-menu\fR\|(1), \fBxdgmenumaker\fR\|(1). .Sp See \fBicewm\-menu\fR\|(5). -.IP "\fIpreferences\fR" 4 +.IP \fIpreferences\fR 4 .IX Item "preferences" Contains general settings like paths, colors and fonts, but also options to control the \fBicewm\fR focus behaviour and the applets that are @@ -1291,7 +1263,7 @@ default \fIpreferences\fR file, which can be copied to the \fBicewm\fR user configuration directory and modified. .Sp See \fBicewm\-preferences\fR\|(5). -.IP "\fIprefoverride\fR" 4 +.IP \fIprefoverride\fR 4 .IX Item "prefoverride" Settings which override the settings from a theme. Some of the \fBicewm\fR configuration options from the preferences file that control the @@ -1301,14 +1273,14 @@ override this for a few specific options of your choosing. It is safe to leave this file empty initially. .Sp See \fBicewm\-prefoverride\fR\|(5). -.IP "\fIprograms\fR" 4 +.IP \fIprograms\fR 4 .IX Item "programs" An automatically generated menu of applications. This could be used by \&\fBwmconfig\fR\|(1), menu or similar programs to give easy access to all the desktop applications that are installed on the system. .Sp See \fBicewm\-programs\fR\|(5). -.IP "\fItheme\fR" 4 +.IP \fItheme\fR 4 .IX Item "theme" This file contains the name of the default theme. On startup \fBicewm\fR reads this file to obtain the theme name, unless \fBicewm\fR was started @@ -1325,7 +1297,7 @@ file, which replaces \fIdefault.theme\fR. If no theme file exists then \&\f(CW\*(C`Theme="default/default.theme"\*(C'\fR. .Sp See \fBicewm\-theme\fR\|(5). -.IP "\fItoolbar\fR" 4 +.IP \fItoolbar\fR 4 .IX Item "toolbar" Contains names of quick to launch applications with icons for the task bar. Each non-empty non-comment line starts with the keyword \fBprog\fR. @@ -1343,7 +1315,7 @@ with the \fIfirefox\fR icon that launches \fBfirefox\fR\|(1) when clicked: .Ve .Sp See \fBicewm\-toolbar\fR\|(5). -.IP "\fIwinoptions\fR" 4 +.IP \fIwinoptions\fR 4 .IX Item "winoptions" Contains settings to control window appearance and behaviour that are specific to applications or groups of applications. Options can control @@ -1352,7 +1324,7 @@ system tray and the workspaces. Also its layer, geometry, whether it can be moved, resized and closed. .Sp See \fBicewm\-winoptions\fR\|(5). -.IP "\fIstartup\fR" 4 +.IP \fIstartup\fR 4 .IX Item "startup" Contains commands to be executed on \fBicewm\fR startup. This is an executable script with commands to tweak X11 settings and launch some @@ -1360,7 +1332,7 @@ applications that need to be active whenever \fBicewm\fR is started. It is run by \fBicewm\-session\fR\|(1) when \fBicewm\fR starts. .Sp See \fBicewm\-startup\fR\|(5). -.IP "\fIshutdown\fR" 4 +.IP \fIshutdown\fR 4 .IX Item "shutdown" Contains commands to be executed on \fBicewm\fR shutdown. This is an executable script with commands to be executed in the last stage of @@ -1369,58 +1341,57 @@ the \fIstartup\fR script. It is run by \fBicewm\-session\fR\|(1) when \fBicewm\ terminates. .Sp See \fBicewm\-shutdown\fR\|(5). -.SS "\s-1CONFIGURATION SUBDIRECTORIES\s0" +.SS "CONFIGURATION SUBDIRECTORIES" .IX Subsection "CONFIGURATION SUBDIRECTORIES" -.IP "\fIcursors\fR" 4 +.IP \fIcursors\fR 4 .IX Item "cursors" -May contain cursor icons in the \s-1XPM\s0 image format. These overrule cursors +May contain cursor icons in the XPM image format. These overrule cursors provided by a theme. There are 3 direction cursors: \fIleft.xpm\fR, \&\fIright.xpm\fR, \fImove.xpm\fR, 8 resize cursors: \fIsizeR.xpm\fR, \fIsizeTR.xpm\fR, \&\fIsizeT.xpm\fR, \fIsizeTL.xpm\fR, \fIsizeL.xpm\fR, \fIsizeBL.xpm\fR, \fIsizeB.xpm\fR, \&\fIsizeBR.xpm\fR, and 4 scroll cursors: \fIscrollL.xpm\fR, \fIscrollR.xpm\fR, \&\fIscrollU.xpm\fR, and \fIscrollD.xpm\fR. -By default an \s-1XPM\s0 header defines four dimensions: width, height, colors +By default an XPM header defines four dimensions: width, height, colors and chars-per-pixel. For cursors this must be extended to six. The last two are the \fIx\-hotspot\fR and the \fIy\-hotspot\fR. These define which point -in the \s-1XPM\s0 image is the sensitive point for the mouse pointer. -.IP "\fIicons\fR" 4 +in the XPM image is the sensitive point for the mouse pointer. +.IP \fIicons\fR 4 .IX Item "icons" -Contains icons that are used to identify applications. Usually these -files are in the \s-1XPM\s0 format, but the \s-1PNG\s0 and \s-1SVG\s0 image formats are also -supported. The names of icon files may follow a specific naming -pattern, like \fIapp_32x32.xpm\fR. They start with a base name, usually -this is just a single word. Then follows an underscore, followed by a -size specification in the format \f(CW\*(C`SIZExSIZE\*(C'\fR. This is followed by a -dot and the file extension, where the extension denotes the icon image -format. Common sizes are 16, 32 and 48 for small, large and huge icons. +Contains icons for applications and keyboard layouts. These can be in +XPM, PNG or SVG format. The filename of an \fIapplication icon\fR may +follow a specific naming pattern, like \fIapp_32x32.xpm\fR. They start +with a base name, which usually is just a single word. Then follows +an underscore, followed by a size specification, as in \f(CW\*(C`SIZExSIZE\*(C'\fR. +This is followed by a dot and the file extension, where the extension +denotes the icon image format. Common sizes are 16, 32 and 48. This depends on the respective \f(CW\*(C`IconSize\*(C'\fR preferences options. -.IP "\fIledclock\fR" 4 +.IP \fIledclock\fR 4 .IX Item "ledclock" -Pictures of digits for the \s-1LED\s0 clock which is displayed in the +Pictures of digits for the LED clock which is displayed in the bottom-right corner of the task bar. These can be seen when the \&\f(CW\*(C`TaskBarShowClock\*(C'\fR and \f(CW\*(C`TaskBarClockLeds\*(C'\fR options are both set to 1. -.IP "\fImailbox\fR" 4 +.IP \fImailbox\fR 4 .IX Item "mailbox" Icons that are used to display different states of the mailbox applet in the task bar. There are five states and each has its own icon: \&\fImail.xpm\fR, \fInewmail.xpm\fR, \fIunreadmail.xpm\fR, \fInomail.xpm\fR, \&\fIerrmail.xpm\fR. -.IP "\fIsounds\fR" 4 +.IP \fIsounds\fR 4 .IX Item "sounds" -Audio files that are played by \fBicesound\fR\|(1) on \s-1GUI\s0 events. These +Audio files that are played by \fBicesound\fR\|(1) on GUI events. These are: \fIstartup.wav\fR, \fIshutdown.wav\fR, \fIrestart.wav\fR, \fIlaunchApp.wav\fR, \&\fIworkspaceChange.wav\fR, \fIwindowOpen.wav\fR, \fIwindowClose.wav\fR, \&\fIdialogOpen.wav\fR, \fIdialogClose.wav\fR, \fIwindowMax.wav\fR, \&\fIwindowRestore.wav\fR, \fIwindowMin.wav\fR, \fIwindowHide.wav\fR, \&\fIwindowRollup.wav\fR, \fIwindowMoved.wav\fR, \fIwindowSized.wav\fR, \&\fIwindowLower.wav\fR. -.IP "\fItaskbar\fR" 4 +.IP \fItaskbar\fR 4 .IX Item "taskbar" Pictures to customize the look of the task bar. These include: \&\fItaskbarbg.xpm\fR, \fItaskbuttonactive.xpm\fR, \fItaskbuttonbg.xpm\fR, \&\fItaskbuttonminimized.xpm\fR, \fItoolbuttonbg.xpm\fR, \&\fIworkspacebuttonactive.xpm\fR, \fIworkspacebuttonbg.xpm\fR. -.IP "\fIthemes\fR" 4 +.IP \fIthemes\fR 4 .IX Item "themes" A directory to store themes. Each theme is stored in its own sub-directory in the \fIthemes\fR directory. A theme contains at least a @@ -1429,12 +1400,12 @@ additional files that have a \fI.theme\fR file name extension and that contain tweaks of the \fIdefault.theme\fR file. How to create a theme is explained in the IceWM Theme Creation Howto. -.IP "\fIworkspace\fR" 4 +.IP \fIworkspace\fR 4 .IX Item "workspace" If \f(CW\*(C`PagerShowPreview\*(C'\fR is disabled, icewm looks in the \f(CW\*(C`workspace\*(C'\fR directory for images to draw on a workspace button. The image filename should have the name of the workspace. The image extension is optional. -.SS "\s-1OPACITY\s0" +.SS OPACITY .IX Subsection "OPACITY" IceWM supports window opacity and transparency in connection with an external compositor like \fBcompton\fR\|(1) or \fBpicom\fR\|(1). @@ -1446,19 +1417,19 @@ The opacity can also be set in the \fBicewm\-winoptions\fR\|(5) file. \&\fBicesh\fR\|(1) can control the opacity level of running applications. .PP The _NET_WM_WINDOW_TYPE properties that \fBicewm\fR sets on its windows -are \fI\s-1DIALOG\s0\fR, \fI\s-1NOTIFICATION\s0\fR, \fI\s-1POPUP_MENU\s0\fR and \fI\s-1TOOLTIP\s0\fR. The output -of \f(CW\*(C`icesh windows\*(C'\fR shows their \s-1WM_CLASS\s0 values. These can be helpful +are \fIDIALOG\fR, \fINOTIFICATION\fR, \fIPOPUP_MENU\fR and \fITOOLTIP\fR. The output +of \f(CW\*(C`icesh windows\*(C'\fR shows their WM_CLASS values. These can be helpful to configure compton. -.SS "\s-1EXAMPLES\s0" +.SS EXAMPLES .IX Subsection "EXAMPLES" Examples of the above configuration files can be found in the default installation path or in the system-wide defaults. See the output of \&\f(CW\*(C`icewm \-\-directories\*(C'\fR for their locations. -.SS "\s-1CONFORMING TO\s0" +.SS "CONFORMING TO" .IX Subsection "CONFORMING TO" -\&\s-1ICCCM 2.0:\s0 partial. NetWM/EWMH: extensive. -See the file \fI\s-1COMPLIANCE\s0\fR in the distribution for full details. -.SS "\s-1SEE ALSO\s0" +ICCCM 2.0: partial. NetWM/EWMH: extensive. +See the file \fICOMPLIANCE\fR in the distribution for full details. +.SS "SEE ALSO" .IX Subsection "SEE ALSO" \&\fBicehelp\fR\|(1), \&\fBicesh\fR\|(1), @@ -1488,16 +1459,16 @@ See the file \fI\s-1COMPLIANCE\s0\fR in the distribution for full details. \&\fBxprop\fR\|(1), \&\fBxwininfo\fR\|(1), \&\fBwmctrl\fR\|(1). -.SS "\s-1BUGS\s0" +.SS BUGS .IX Subsection "BUGS" Please report bugs at <https://github.com/bbidulock/icewm/issues>. -.SS "\s-1AUTHOR\s0" +.SS AUTHOR .IX Subsection "AUTHOR" Brian Bidulock <mailto:bidulock@openss7.org>. .PP See \fB\-\-copying\fR for full copyright notice and copying permissions. -.SS "\s-1LICENSE\s0" +.SS LICENSE .IX Subsection "LICENSE" -\&\fBIceWM\fR is licensed under the \s-1GNU\s0 Library General Public License. -See the \fI\s-1COPYING\s0\fR file in the distribution or use the \fB\-\-copying\fR flag +\&\fBIceWM\fR is licensed under the GNU Library General Public License. +See the \fICOPYING\fR file in the distribution or use the \fB\-\-copying\fR flag to display copying permissions. |