Debian Codegraph @

upstream/fedora-44/man1/icewm.1

raw
1 .\" -*- mode: troff; coding: utf-8 -*-
2 .\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.47)
3 .\"
4 .\" Standard preamble:
5 .\" ========================================================================
6 .de Sp \" Vertical space (when we can't use .PP)
7 .if t .sp .5v
8 .if n .sp
9 ..
10 .de Vb \" Begin verbatim text
11 .ft CW
12 .nf
13 .ne \\$1
14 ..
15 .de Ve \" End verbatim text
16 .ft R
17 .fi
18 ..
19 .\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
20 .ie n \{\
21 . ds C` ""
22 . ds C' ""
23 'br\}
24 .el\{\
25 . ds C`
26 . ds C'
27 'br\}
28 .\"
29 .\" Escape single quotes in literal strings from groff's Unicode transform.
30 .ie \n(.g .ds Aq \(aq
31 .el .ds Aq '
32 .\"
33 .\" If the F register is >0, we'll generate index entries on stderr for
34 .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
35 .\" entries marked with X<> in POD. Of course, you'll have to process the
36 .\" output yourself in some meaningful fashion.
37 .\"
38 .\" Avoid warning from groff about undefined register 'F'.
39 .de IX
40 ..
41 .nr rF 0
42 .if \n(.g .if rF .nr rF 1
43 .if (\n(rF:(\n(.g==0)) \{\
44 . if \nF \{\
45 . de IX
46 . tm Index:\\$1\t\\n%\t"\\$2"
47 ..
48 . if !\nF==2 \{\
49 . nr % 0
50 . nr F 2
51 . \}
52 . \}
53 .\}
54 .rr rF
55 .\"
56 .\" Required to disable full justification in groff 1.23.0.
57 .if n .ds AD l
58 .\" ========================================================================
59 .\"
60 .IX Title "ICEWM 1"
61 .TH ICEWM 1 2026-01-16 "icewm\ 4.0.0" "User Commands"
62 .\" For nroff, turn off justification. Always turn off hyphenation; it makes
63 .\" way too many mistakes in technical documents.
64 .if n .ad l
65 .nh
66 .SS NAME
67 .IX Subsection "NAME"
68 .Vb 1
69 \& icewm \- lightweight X11 window manager
70 .Ve
71 .SS SYNOPSIS
72 .IX Subsection "SYNOPSIS"
73 \&\fBicewm\fR [\fIOPTIONS\fR]
74 .SS DESCRIPTION
75 .IX Subsection "DESCRIPTION"
76 \&\fBicewm\fR is a small and fast window manager for the X11 window system. It
77 is best started by \fBicewm\-session\fR\|(1), which also starts \fBicewmbg\fR\|(1).
78 .PP
79 \&\fBicewm\fR is called \fIre\-parenting\fR, because it draws frames around
80 application windows. Drag this frame with the mouse, to move or resize
81 a window.
82 .PP
83 Because windows may overlap, \fBicewm\fR is also a stacking window manager.
84 Many windows may exist, some hidden behind others.
85 .PP
86 \&\fBicewm\fR supports a configurable number of virtual desktops. These are
87 called workspaces. Related windows are grouped on a dedicated workspace.
88 By switching between workspaces, the user can attend to different tasks,
89 while keeping oversight. This is supported by a task bar and a pager.
90 .PP
91 The installation comes with several themes. Choose a theme via a menu.
92 Install extra themes automatically with the \fB\-\-install\fR option.
93 .PP
94 \&\fBicewm\fR is compliant with the ICCCM and EWMH window manager specifications.
95 .SS PROGRAMS
96 .IX Subsection "PROGRAMS"
97 The \fBicewm\fR package includes several programs:
98 .IP \fBicewm\fR\|(1) 4
99 .IX Item "icewm"
100 The actual window manager. It positions application windows on screen
101 and decorates them with borders. It gives input focus to the current
102 active application. \fBicewm\fR supports different focus modes, which are
103 explained below. It draws a small task bar at the bottom of the screen,
104 that gives easy access to programs, to virtual desktops, to active
105 applications, and to a small set of monitoring applets.
106 .IP \fBicewmbg\fR\|(1) 4
107 .IX Item "icewmbg"
108 The background setting application. It can assign plain background color
109 or images in different formats to the X background. Each workspace can
110 have its own background. It supports semitransparency. Semitransparent
111 background image and colour can be configured. When the background image
112 has changed then \fBicewmbg\fR\|(1) can be notified to update the background.
113 Multi\-head monitor setups are fully supported. See the \fBicewmbg\fR\|(1).
114 .IP \fBicewm\-session\fR\|(1) 4
115 .IX Item "icewm-session"
116 \&\fBicewm\-session\fR\|(1) is the preferred program to start the IceWM system.
117 It first loads additional environment variables from the optional
118 \&\fIenv\fR file. Then it starts \fBicewmbg\fR\|(1) and \fBicewm\fR. It also runs
119 the \fIstartup\fR script and implements basic session management.
120 On termination the \fIshutdown\fR script will be run first, then
121 \&\fBicewm\-session\fR\|(1) will terminate \fBicewm\fR and \fBicewmbg\fR\|(1).
122 \&\fBicewm\-session\fR\|(1) will also start the optional \fBicesound\fR\|(1)
123 if you give it the \fB\-\-sound\fR option. See \fBicewm\-session\fR\|(1).
124 .IP \fBicesh\fR\|(1) 4
125 .IX Item "icesh"
126 A powerful tool to control window properties and to interact with the
127 window manager. It is typically used in shell scripts. See \fBicesh\fR\|(1).
128 .IP \fBicehelp\fR\|(1) 4
129 .IX Item "icehelp"
130 A small document browser that is used by \fBicewm\fR to display the
131 \&\*(AqIceWM manual\*(Aq and some man pages.
132 .IP \fBicewmhint\fR\|(1) 4
133 .IX Item "icewmhint"
134 A utility for passing IceWM\-specific window options to \fBicewm\fR.
135 The options are used to configure the first application that is started
136 subsequently. See \fBicewmhint\fR\|(1).
137 .IP \fBicesound\fR\|(1) 4
138 .IX Item "icesound"
139 Plays audio files on GUI events that are raised by \fBicewm\fR.
140 It supports ALSA, AO and OSS. See the \fBicesound\fR\|(1) man page.
141 .IP \fBicewm\-menu\-fdo\fR\|(1) 4
142 .IX Item "icewm-menu-fdo"
143 Generate an \fBicewm\fR menu with executable desktop applications
144 according to XDG specifications. See the \fBicewm\-menu\-fdo\fR\|(1) man page.
145 .IP \fBicewm\-set\-gnomewm\fR\|(1) 4
146 .IX Item "icewm-set-gnomewm"
147 Configures GNOME to start IceWM instead of its own WM.
148 .SS OPTIONS
149 .IX Subsection "OPTIONS"
150 .SS "COMMON OPTIONS"
151 .IX Subsection "COMMON OPTIONS"
152 Each of the IceWM executables supports the following options:
153 .IP "\fB\-c\fR, \fB\-\-config\fR=\fIFILE\fR" 4
154 .IX Item "-c, --config=FILE"
155 Use \fIFILE\fR as the source of configuration options. By default \fBicewm\fR
156 looks for a file named \fIpreferences\fR. This is a readable text file
157 that can be modified with the help of a text editor.
158 .IP "\fB\-t\fR, \fB\-\-theme\fR=\fINAME\fR" 4
159 .IX Item "-t, --theme=NAME"
160 Use \fINAME\fR as the name of the \fBicewm\fR theme to use. A theme defines
161 the look and feel of \fBicewm\fR, like colors, fonts and buttons.
162 .IP "\fB\-d\fR, \fB\-\-display\fR=\fIDISPLAY\fR" 4
163 .IX Item "-d, --display=DISPLAY"
164 Connect to the X11 server on \fIDISPLAY\fR. By default
165 the environment variable \f(CW\*(C`DISPLAY\*(C'\fR is used.
166 .IP "\fB\-o\fR, \fB\-\-output=FILE\fR" 4
167 .IX Item "-o, --output=FILE"
168 Redirect all output to \fIFILE\fR.
169 A leading tilde or environment variable is expanded.
170 .IP \fB\-\-sync\fR 4
171 .IX Item "--sync"
172 This option specifies to use a slower synchronous communication mode
173 with the X11 server. This is irrelevant for normal use.
174 .IP "\fB\-h\fR, \fB\-\-help\fR" 4
175 .IX Item "-h, --help"
176 Gives a complete list of all the available command\-line options with
177 some very brief explanation.
178 .IP "\fB\-V\fR, \fB\-\-version\fR" 4
179 .IX Item "-V, --version"
180 Shows the software release version for this program.
181 .SS "ICEWM OPTIONS"
182 .IX Subsection "ICEWM OPTIONS"
183 The \fBicewm\fR program supports some additional options:
184 .IP "\fB\-a\fR, \fB\-\-alpha\fR" 4
185 .IX Item "-a, --alpha"
186 Use a 32\-bit visual for translucency. This can also be set in
187 the preferences file as \f(CW\*(C`Alpha=1\*(C'\fR.
188 .IP \fB\-\-replace\fR 4
189 .IX Item "--replace"
190 Instructs \fBicewm\fR to replace an existing window manager. Provided that
191 the window manager being replaced is ICCCM 2.0 compliant, once it
192 notices that it is to be replaced it will cease operations and typically
193 stop execution. This allows \fBicewm\fR to establish itself as the only
194 active window manager.
195 .IP "\fB\-r\fR, \fB\-\-restart\fR" 4
196 .IX Item "-r, --restart"
197 Tell \fBicewm\fR to restart itself. This reloads the configuration from
198 file. If no window manager is active, then it starts one.
199 .IP "\fB\-s\fR, \fB\-\-splash\fR=\fIIMAGE\fR" 4
200 .IX Item "-s, --splash=IMAGE"
201 Briefly show \fIIMAGE\fR on startup in the center of the screen.
202 This can also be set in the preferences file as Splash=\f(CW\*(C`image.jpg\*(C'\fR.
203 .IP \fB\-\-configured\fR 4
204 .IX Item "--configured"
205 Shows a list of configuration options that were enabled when \fBicewm\fR
206 was compiled from source code. This can be helpful if one suspects some
207 functionality may be missing.
208 .IP \fB\-\-directories\fR 4
209 .IX Item "--directories"
210 Gives a list of directories where \fBicewm\fR will look for configuration
211 data. This list is printed in the actual order in which \fBicewm\fR uses
212 it to search for configuration files.
213 .IP "\fB\-l\fR, \fB\-\-list\-themes\fR" 4
214 .IX Item "-l, --list-themes"
215 \&\fBicewm\fR will search all the configuration directories for theme files
216 and print a list of all found themes.
217 .IP "\fB\-i\fR, \fB\-\-install\fR=\fITHEME\fR" 4
218 .IX Item "-i, --install=THEME"
219 Install \fITHEME\fR from icewm\-extra and exit. When \fITHEME\fR is \fIlist\fR,
220 print a listing of available themes to install. This option requires
221 the presence of the \fIlzip\fR, \fItar\fR and \fIwget\fR or \fIcurl\fR commands.
222 .IP "\fB\-p\fR, \fB\-\-postpreferences\fR" 4
223 .IX Item "-p, --postpreferences"
224 This gives a long list of all the internal \fBicewm\fR options with their
225 actual values after \fBicewm\fR has processed all of the configuration and
226 theme files. In some advanced scenarios this can be helpful to inspect
227 which configuration was chosen or whether option formatting was correct.
228 .IP \fB\-\-rewrite\-preferences\fR 4
229 .IX Item "--rewrite-preferences"
230 Overwrite an existing preferences file with an icewm default preferences,
231 but preserve all modifications insofar they deviate from the defaults.
232 .IP \fB\-\-extensions\fR 4
233 .IX Item "--extensions"
234 Give a list of the current X extensions, their versions and status.
235 .IP \fB\-\-trace\fR=\fIconf\fR,\fIfont\fR,\fIicon\fR,\fIprog\fR,\fIsystray\fR 4
236 .IX Item "--trace=conf,font,icon,prog,systray"
237 Enable tracing of the paths that are used to load configuration,
238 fonts, icons, executed programs, and/or system tray applets.
239 .SS USAGE
240 .IX Subsection "USAGE"
241 .SS TASKBAR
242 .IX Subsection "TASKBAR"
243 On startup \fBicewm\fR launches the task bar at the bottom of the screen.
244 The task bar consists from left to right of the following components:
245 .PP
246 The \fIMenu\fR button in the lower left corner gives access to the \fBicewm\fR
247 root menu. This menu has sub\-menus to start applications, to control
248 \&\fBicewm\fR settings, and the \fBicewm\fR \fILogout\fR menu.
249 .PP
250 The \fIShow Desktop\fR button unmaps all application windows to fully
251 uncover the desktop.
252 .PP
253 The \fIWindow List Menu\fR button gives access to a menu with a list of
254 active windows for the current workspace and a list of workspaces
255 with sub\-menus for their active application windows.
256 .PP
257 The \fIToolbar\fR is a list of icons for applications that are defined in
258 the toolbar configuration file.
259 .PP
260 The \fIWorkspace Pane\fR shows one button for each workspace. The current
261 workspace is indicated by a pressed button. Clicking another workspace
262 switches to that workspace. Press left mouse, then the Shift key, then
263 release the left mouse, takes the current window to that workspace.
264 Press left, then Alt, then release left, moves only the focused window
265 to other workspace, without changing the current workspace.
266 .PP
267 The workspaces are defined in the \fIpreferences\fR file. To change a name
268 for only this session, double\-click, edit the name and hit Enter.
269 When \f(CW\*(C`PagerShowPreview\*(C'\fR is turned on, a small graphical window summary
270 for each workspace is shown. They support drag\-and\-drop: dragging a
271 Firefox tab to a workspace button changes the current workspace.
272 Then releasing it moves that tab to a new window in that workspace.
273 .PP
274 The \fITask Pane\fR consists of a list of wide buttons for each application
275 that is running on the current workspace, or all workspaces if
276 \&\f(CW\*(C`TaskBarShowAllWindows=1\*(C'\fR. Each task button shows the
277 application icon and the application title. The active application is
278 indicated by a pressed button. This is the application that has input
279 focus. Clicking another button activates that application: it is
280 brought to the foreground and receives input focus. Clicking the button
281 of an active application minimizes it. To minimize an inactive application,
282 click its button while \f(CW\*(C`Ctrl\*(C'\fR is down.
283 .PP
284 The window buttons can be dragged with the left mouse button to rearrange
285 their order. A window can be closed with \f(CW\*(C`Alt\*(C'\fR + middle button, lowered
286 with \f(CW\*(C`Ctrl\*(C'\fR + middle button, or brought to the current workspace with
287 \&\f(CW\*(C`Shift\*(C'\fR + middle button when \f(CW\*(C`TaskBarShowAllWindows=1\*(C'\fR.
288 .PP
289 If there are not many application buttons then a stretch of plain task
290 bar is visible. Clicking on it with the right mouse button gives the
291 task bar menu. Even with a full task pane, this menu can be usually
292 accessed by right\-clicking the bottom right corner of the taskbar.
293 .PP
294 The \fITray Applet\fR shows system tray objects.
295 .PP
296 The \fIAPM Applet\fR shows battery power status.
297 .PP
298 The \fINet Applet\fR shows network activity. Network devices to monitor
299 are given by the \f(CW\*(C`NetworkStatusDevice\*(C'\fR option.
300 .PP
301 The \fIMemory Applet\fR monitors memory usage.
302 .PP
303 The \fICPU Applet\fR monitors processor utilization.
304 .PP
305 The \fIMailbox Applet\fR monitors mailbox status changes.
306 See the section MAILBOX MONITORING below.
307 .PP
308 The \fIClock Applet\fR shows the current time and date. It is configured
309 by the \f(CW\*(C`TimeFormat\*(C'\fR option.
310 .PP
311 The \fITask Bar Collapse\fR button collapses the task bar and hides it.
312 .PP
313 Not all \fBicewm\fR applets may show up on the task bar. They must have
314 been enabled during configuration of the \fBicewm\fR software. Their
315 appearance is also controlled by options in the \fIpreferences\fR file.
316 .SS "INPUT FOCUS"
317 .IX Subsection "INPUT FOCUS"
318 Of all visible windows only one can be the active window. This is the
319 window that has input focus. It is the primary receiver of keyboard
320 and mouse events and hence one can interact with the application that
321 created that window. A primary task of a window manager is to allow the
322 user to switch input focus between different windows. The primary means
323 to do this is the mouse pointer. By moving the mouse pointer over the
324 screen to another window, and perhaps also by clicking on a window,
325 input focus can be directed.
326 .PP
327 The \f(CW\*(C`FocusMode\*(C'\fR option controls the way \fBicewm\fR gives input focus to
328 applications. It is initialized by the \fIfocus_mode\fR configuration
329 file. The focus mode is set via the \fIFocus\fR menu. \fBicewm\fR supports
330 six focus models:
331 .IP "\fB1. Click\-to\-focus\fR" 4
332 .IX Item "1. Click-to-focus"
333 The default focus mode. In this mode changing input focus requires to
334 click a window with the left mouse button. The window is raised if
335 needed. When an application requests focus its task pane button
336 flashes. This gives the option to honor this request or to ignore it.
337 When a new application window appears it automatically receives focus.
338 Also when a hidden application raises to the front it receives focus.
339 .IP "\fB2. Sloppy\-mouse\-focus\fR" 4
340 .IX Item "2. Sloppy-mouse-focus"
341 Sets input focus merely by moving the mouse pointer over a window. It
342 is called sloppy, because if the mouse then leaves the window and moves
343 to the desktop background the input focus remains with the last active
344 window. When a window receives focus it is raised. When an application
345 requests focus its task pane button flashes. A new application or an
346 application that raises to the front automatically receives focus.
347 .IP "\fB3. Explicit\-focus\fR" 4
348 .IX Item "3. Explicit-focus"
349 Focus is even more user\-controlled than \fBClick\-to\-focus\fR. When a
350 window receives focus it is not raised by default, unless the frame
351 border is clicked. No flashing occurs when an application requests
352 focus. When a new application window appears it does not receive focus.
353 Only by explicit clicking on a window is focus directed.
354 .IP "\fB4. Strict\-mouse\-focus\fR" 4
355 .IX Item "4. Strict-mouse-focus"
356 Like \fBSloppy\fR but focus remains with the last window. New applications
357 don\*(Aqt receive focus and are mapped behind other windows. When an
358 application raises to the front it still does not get focus.
359 .IP "\fB5. Quiet\-sloppy\-focus\fR" 4
360 .IX Item "5. Quiet-sloppy-focus"
361 Like \fBSloppy\fR but no disturbing flashing occurs on the task bar when an
362 application requests focus.
363 .IP "\fB6. Custom\-mode\fR" 4
364 .IX Item "6. Custom-mode"
365 A focus mode that is defined by the following ten options:
366 \&\f(CW\*(C`ClickToFocus\*(C'\fR,
367 \&\f(CW\*(C`FocusOnAppRaise\*(C'\fR,
368 \&\f(CW\*(C`RequestFocusOnAppRaise\*(C'\fR,
369 \&\f(CW\*(C`RaiseOnFocus\*(C'\fR,
370 \&\f(CW\*(C`RaiseOnClickClient\*(C'\fR,
371 \&\f(CW\*(C`FocusChangesWorkspace\*(C'\fR,
372 \&\f(CW\*(C`FocusOnMap\*(C'\fR,
373 \&\f(CW\*(C`FocusOnMapTransient\*(C'\fR,
374 \&\f(CW\*(C`FocusOnMapTransientActive\*(C'\fR,
375 \&\f(CW\*(C`MapInactiveOnTop\*(C'\fR.
376 .Sp
377 All non\-Custom focus modes override these ten options.
378 .PP
379 Apart from the mouse, \fBicewm\fR supports changing input focus in two
380 ways by keyboard. By pressing \f(CW\*(C`Alt+Esc\*(C'\fR or \f(CW\*(C`Alt+Shift+Esc\*(C'\fR,
381 input focus is immediately changed to the next or previous window,
382 which will be raised to make it fully visible. The other method
383 involves the quick switch.
384 .SS "QUICK SWITCH"
385 .IX Subsection "QUICK SWITCH"
386 The \fBQuickSwitch\fR is a means to quickly and interactively change
387 the input focus to another window. It is activated by pressing the
388 \&\f(CW\*(C`Alt+Tab\*(C'\fR or \f(CW\*(C`Alt+Shift+Tab\*(C'\fR key combination. A window pops up
389 in the centre of the screen with a list of windows to choose from.
390 A narrow band indicates a selection: the candidate window that will
391 be activated to receive input focus when the Alt key is released.
392 .PP
393 The selection can be changed by repeatedly pressing the Tab key, while
394 keeping the Alt key down. If a Shift key is also down, the direction of
395 traversal is reversed. Or use the scroll wheel of the mouse. Or use
396 one of the digit keys to select the corresponding window from the list.
397 By pressing the first letter of the application class name, the next
398 such application is selected. All navigation keys are also supported.
399 .PP
400 To make a selected window the active window, just release the Alt key,
401 or hit the Return key, or click on it. To cancel the QuickSwitch,
402 press Escape or click outside of the QuickSwitch window.
403 .PP
404 A selected window can be closed by Delete, \f(CW\*(C`Alt+F4\*(C'\fR, or the middle
405 mouse button. The right mouse button opens the system menu for the
406 selected window. While the QuickSwitch window is up, one can still
407 change workspace with the usual workspace hotkeys.
408 .PP
409 The QuickSwitch has three distinct modes: vertical, horizontal and
410 preview. The window list can include all windows or be limited to
411 the current workspace. There is an option to raise the selected
412 candidate. See the many preferences available for the QuickSwitch.
413 .PP
414 The preview mode shows a small preview window for every application
415 window that has been shown earlier by icewm. When the preview quick
416 switch is active, this preview is continuously updated. This mode works
417 best with a desktop background manager that updates the \f(CW\*(C`_XROOTPMAP_ID\*(C'\fR
418 property on the root window, such as \fBicewmbg\fR\|(1), \fBnitrogen\fR\|(1),
419 \&\fBhsetroot\fR\|(1) or \fBfeh\fR\|(1).
420 .SS "WINDOW PLACEMENT"
421 .IX Subsection "WINDOW PLACEMENT"
422 A second important task of a window manager is to place new windows on
423 the screen. By default \fBicewm\fR chooses a placement with minimal
424 overlap, but this is determined by the \f(CW\*(C`SmartPlacement\*(C'\fR option in the
425 \&\fIpreferences\fR file. If \f(CW\*(C`SmartPlacement\*(C'\fR is turned off then windows
426 are placed in sequence from left to right and top to bottom. One can
427 also turn on \f(CW\*(C`ManualPlacement\*(C'\fR. Then new windows appear initially in
428 the top left corner and the mouse cursor changes into a fist. By moving
429 the fist cursor to a suitable location and clicking the new window will
430 appear at the mouse click location.
431 .SS "WINDOW LAYERS"
432 .IX Subsection "WINDOW LAYERS"
433 Windows can overlap. Which window appears on top is determined by three
434 features. Newer windows appear over older windows. By clicking on a
435 window it is raised to the top. But both are overruled by the window
436 layer. Windows can be placed in different layers via the \fILayers\fR
437 menu. Click with the right mouse button on the window frame and select
438 \&\fILayer\fR. From there choose one of seven window layers. These are
439 ordered from higher to lower. Windows in higher layers appear over
440 windows in lower layers.
441 .PP
442 There are 16 layers in total, but most are seldom or never used. They
443 are numbered from zero for the lowest layer to fifteen for the topmost.
444 Their names with their layer number are: Desktop (0), Below (2), Normal
445 (4), OnTop (6), Dock (8), AboveDock (10), Menu (12), Fullscreen (14) and
446 AboveAll (15). By default every window appears in the \fINormal\fR layer.
447 Then \fIBelow\fR and \fIOnTop\fR are used frequently to position windows below
448 or above most others. Icewm menus appear in the \fIMenu\fR layer and the
449 \&\fIFullscreen\fR layer is reserved for windows in the fullscreen mode. The
450 default layer for each application can be set with a \fIwinoption\fR.
451 .PP
452 Windows placed in the \fIDock\fR layer can be set to be always visible by
453 setting the \f(CW\*(C`LimitByDockLayer\*(C'\fR preference to 1. Then other windows are
454 preferably not placed over such windows, unless they have explicit
455 positioning information to do so. Maximized windows also don\*(Aqt overlap
456 with these \fIDockLayer\fR windows. The \fIDoNotCover\fR winoption is similar.
457 .SS "DOCKED APPLICATIONS"
458 .IX Subsection "DOCKED APPLICATIONS"
459 Icewm has native support for Window Maker dockapps.
460 It has a Dock container called \fBDockApps\fR, which appears automatically
461 when dockapps are started. The position and layer of this container are
462 controlled by the \f(CW\*(C`DockApps\*(C'\fR preference. It is a space separated list
463 of keywords. The keywords \f(CW\*(C`right, left, center, down, high\*(C'\fR control the
464 position, while \f(CW\*(C`above, dock, ontop, normal, below, desktop\*(C'\fR set the
465 layer. When \fBDockApps\fR is set to the empty string, support for dockapps
466 is disabled. The dockapps in the container can be controlled using the
467 mouse when the \fBCtrl\fR key is pressed down. Drag with the left mouse
468 button, close with the middle mouse button, select a menu with the right
469 mouse button and rotate with the scroll wheel.
470 .PP
471 If maximizing a window should not overlap the \fIDockApps\fR container, put
472 it in the \fIdock\fR layer and set the preference \fBLimitByDockLayer=1\fR.
473 .SS "TABBED WINDOWS"
474 .IX Subsection "TABBED WINDOWS"
475 A window frame may contain multiple client windows. Only one client can
476 be visible, while the others are hidden. This is called tabbing. This
477 can be helpful to reduce the number of visible windows. To create a tab,
478 drag the title bar with the middle mouse button, while holding down a
479 shift key, onto the title bar of another frame. The two title bars will
480 start to flash to indicate that they can merge. Release the mouse button
481 to merge the client of the upper window to the lower frame. Now the
482 lower frame will have multiple clients, called tabs. The title bar will
483 show a vertical bar with triple dots to indicate this.
484 To change the current tab either:
485 .IP \(bu 4
486 Click on the triple dots next to the vertical bar.
487 .IP \(bu 4
488 Use \f(CW\*(C`KeyWinNext=Alt+F6\*(C'\fR to select the next tab.
489 .IP \(bu 4
490 Use \f(CW\*(C`KeyWinPrev=Alt+Shift+F6\*(C'\fR for the previous tab.
491 .IP \(bu 4
492 Use the QuickSwitch.
493 .IP \(bu 4
494 Use the window list window.
495 .IP \(bu 4
496 Use a submenu in the window menu.
497 .PP
498 To change the mouse binding for creating tabs, modify
499 \&\fBMouseWinTabbing\fR=\f(CW\*(C`Shift+Pointer_Button2\*(C'\fR. Another
500 useful setting is \fBMouseWinTabbing\fR=\f(CW\*(C`Pointer_Button1\*(C'\fR.
501 .PP
502 \&\f(CW\*(C`Alt+F4\*(C'\fR closes all tabs. To close just the active tab add to \f(CW\*(C`keys\*(C'\fR:
503 .PP
504 .Vb 1
505 \& key "Ctrl+Shift+F4" icesh \-f close
506 .Ve
507 .PP
508 To move the active tab to its own window frame by key, add to \f(CW\*(C`keys\*(C'\fR:
509 .PP
510 .Vb 1
511 \& key "Alt+u" icesh \-f untab
512 .Ve
513 .PP
514 To open all chrome windows in the same frame add this to \f(CW\*(C`winoptions\*(C'\fR:
515 .PP
516 .Vb 1
517 \& google\-chrome.frame: chrome
518 .Ve
519 .SS WORKSPACES
520 .IX Subsection "WORKSPACES"
521 \&\fBicewm\fR supports multiple virtual desktops called workspaces. A
522 workspace is like a screen where a subset of all application windows are
523 mapped. Thanks to multiple workspaces we can more easily manage a
524 large number of applications. The number of workspaces and their names
525 are configurable in the \fIpreferences\fR file through the
526 \&\f(CW\*(C`WorkspaceNames\*(C'\fR option. By default four workspaces are created
527 with the names 1, 2, 3 and 4 thus:
528 .PP
529 .Vb 1
530 \& WorkspaceNames=" 1 ", " 2 ", " 3 ", " 4 "
531 .Ve
532 .PP
533 This syntax is typical for \fBicewm\fR options that receive multiple
534 values. It is a list of comma\-separated values each of which can be
535 quoted.
536 .PP
537 The workspaces are visible on the toolbar. One can switch to a
538 different workspace by pressing the workspace button in the toolbar,
539 but after becoming familiar with the \*(Aqkeyboard shortcuts\*(Aq below one will
540 want to use a hotkey to choose a workspace. If the \f(CW\*(C`EdgeSwitch\*(C'\fR
541 options is enabled in the \fIpreferences\fR file (with sub\-options
542 \&\f(CW\*(C`HorizontalEdgeSwitch\*(C'\fR and \f(CW\*(C`VerticalEdgeSwitch\*(C'\fR) then one can move to
543 the next or previous workspace by moving the mouse to the edge of the
544 screen. The \f(CW\*(C`ContinuousEdgeSwitch\*(C'\fR option enables continuous movement
545 to subsequent workspaces. The \f(CW\*(C`EdgeSwitchDelay\*(C'\fR option says how long
546 to wait before a change of workspace occurs.
547 .PP
548 To move an application window to a different workspace one can use a
549 keyboard shortcut. Another option is to select the \fIMove To\fR submenu
550 in the window menu of the window frame.
551 .SS "DRAG AND DROP"
552 .IX Subsection "DRAG AND DROP"
553 The task bar supports drag and drop operations. When a drag
554 is in progress, the destination window can be activated by
555 hovering the drag icon over the task button for that window.
556 Alternatively, the current workspace can be changed by
557 hovering the drag icon over the desired workspace button.
558 When edge switching is enabled, the current workspace can
559 also be changed by bringing the drag icon to the screen edge.
560 .SS "ADDRESS BAR"
561 .IX Subsection "ADDRESS BAR"
562 The task bar contains a command\-line prompt called the address bar,
563 if \fBEnableAddressBar\fR=1. It is always shown when \fBShowAddressBar\fR=1,
564 otherwise it is activated by \fBKeySysAddressBar\fR=\f(CW\*(C`Alt+Ctrl+space\*(C'\fR.
565 In it a shell command can be typed. On \fIEnter\fR it is executed by the
566 \&\fBAddressBarCommand\fR=\f(CW\*(C`/bin/sh\*(C'\fR. On \fIControl+Enter\fR this command is
567 executed in a new terminal as given by \fBTerminalCommand\fR.
568 \&\fIEscape\fR cancels editing the address bar command.
569 .PP
570 Commands are executed relative to the working directory of icewm.
571 This is shown by \f(CW\*(C`pwd\*(C'\fR. Change it with \f(CW\*(C`cd\*(C'\fR. Without argument \f(CW\*(C`cd\*(C'\fR
572 defaults to the home directory. With one argument it is changed.
573 This argument is expanded when it starts with a dollar or tilde.
574 When it is equal to \f(CW\*(C`\-\*(C'\fR, it reverts to the previous directory.
575 .PP
576 The address bar has a history that is navigable by \fIUp\fR and \fIDown\fR.
577 This history is saved in a file \fIahistory\fR in your icewm directory
578 and restored when icewm starts.
579 .PP
580 Completion is supported using \fITab\fR or \fICtrl+I\fR. The leading command
581 is completed from directories in your PATH, while file arguments are
582 expanded from the location in the file system. In addition usernames
583 and environment variables can also be expanded. For example, \f(CW\*(C`echo $TMP\*(C'\fR
584 and \fITab\fR may expand to \f(CW\*(C`echo $TMPDIR\*(C'\fR and \f(CW\*(C`echo ~ro\*(C'\fR and \fITab\fR may
585 expand to \f(CW\*(C`echo ~root\*(C'\fR.
586 .PP
587 The address bar implements cut/copy/paste and these editing operations:
588 .IP "Ctrl+a: select all" 4
589 .IX Item "Ctrl+a: select all"
590 .PD 0
591 .IP "Ctrl+backslash: deselect all" 4
592 .IX Item "Ctrl+backslash: deselect all"
593 .IP "Ctrl+u: delete selected or to line start" 4
594 .IX Item "Ctrl+u: delete selected or to line start"
595 .IP "Ctrl+v: paste selected" 4
596 .IX Item "Ctrl+v: paste selected"
597 .IP "Ctrl+w: delete selected or previous word" 4
598 .IX Item "Ctrl+w: delete selected or previous word"
599 .IP "Ctrl+x: cut selection" 4
600 .IX Item "Ctrl+x: cut selection"
601 .IP "Ctrl+c: copy selection" 4
602 .IX Item "Ctrl+c: copy selection"
603 .IP "Ctrl+i: completion" 4
604 .IX Item "Ctrl+i: completion"
605 .IP "Ctrl+Left: back a word" 4
606 .IX Item "Ctrl+Left: back a word"
607 .IP "Ctrl+Right: forward a word" 4
608 .IX Item "Ctrl+Right: forward a word"
609 .IP "Ctrl+Shift+Backspace: delete to beginning" 4
610 .IX Item "Ctrl+Shift+Backspace: delete to beginning"
611 .IP "Ctrl+Shift+Delete: delete to end" 4
612 .IX Item "Ctrl+Shift+Delete: delete to end"
613 .IP "Ctrl+Delete: delete word" 4
614 .IX Item "Ctrl+Delete: delete word"
615 .IP "Ctrl+Backspace: delete previous word" 4
616 .IX Item "Ctrl+Backspace: delete previous word"
617 .IP "Shift+Delete: cut selection" 4
618 .IX Item "Shift+Delete: cut selection"
619 .IP "Shift+Insert: paste selected" 4
620 .IX Item "Shift+Insert: paste selected"
621 .IP "Tab: completion" 4
622 .IX Item "Tab: completion"
623 .IP "Left: move cursor left" 4
624 .IX Item "Left: move cursor left"
625 .IP "Right: move cursor right" 4
626 .IX Item "Right: move cursor right"
627 .IP "Home: move cursor to line start" 4
628 .IX Item "Home: move cursor to line start"
629 .IP "End: move cursor to line end" 4
630 .IX Item "End: move cursor to line end"
631 .IP "Delete: delete next character" 4
632 .IX Item "Delete: delete next character"
633 .IP "Backspace: delete previous character" 4
634 .IX Item "Backspace: delete previous character"
635 .PD
636 .SS "WINDOW LIST"
637 .IX Subsection "WINDOW LIST"
638 The window list window shows a list of all workspaces. For each
639 workspace it shows the window titles of the windows that are mapped
640 on it. The bottom entry reads \f(CW\*(C`All Workspaces\*(C'\fR. It holds the sticky
641 windows. These windows are mapped in all workspaces.
642 .PP
643 The window list window is normally hidden. Choose one of the following
644 four methods to make it visible:
645 .IP \(bu 4
646 Select the bottom window list menu entry.
647 .IP \(bu 4
648 Press the \f(CW\*(C`KeySysWindowList=Ctrl+Alt+Esc\*(C'\fR key.
649 .IP \(bu 4
650 Press the right Windows key if \f(CW\*(C`Win95Keys=1\*(C'\fR
651 .IP \(bu 4
652 Press the \f(CW\*(C`DesktopWinListButton=2\*(C'\fR mouse button in the root window.
653 .IP \(bu 4
654 Press the middle mouse button in a workspace button on the task bar.
655 .PP
656 A single\-click on a window entry selects it. A group of windows can
657 be selected by \f(CW\*(C`Shift+Pointer_Button1\*(C'\fR or by dragging with the left
658 mouse button. Use \f(CW\*(C`Ctrl+Pointer_Button1\*(C'\fR to individually select
659 windows in a multi\-selection. A right mouse click over a selection
660 will popup the system menu for this selection. To close the selected
661 windows, press \f(CW\*(C`Delete\*(C'\fR. Press \f(CW\*(C`Shift+Delete\*(C'\fR to forcefully kill them.
662 Right mouse click below the sticky windows for a menu with window
663 arranging actions.
664 .PP
665 Double\-click on a workspace to switch to it. Double\-click on a window
666 to activate it. Or navigate by arrow keys and press Enter.
667 The space bar toggles a selection of a window. \f(CW\*(C`Ctrl+a\*(C'\fR and \f(CW\*(C`Ctrl+/\*(C'\fR
668 will select the entire list of windows. \f(CW\*(C`Ctrl+\e\e\*(C'\fR deselects everything.
669 Press the first letter of a window title to navigate to it and select
670 it. If titles of multiple windows start with the same letter then
671 repeatedly pressing the first letter cycles over those windows.
672 \&\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
673 \&\f(CW\*(C`PageDown\*(C'\fR move up or down by ten entries. Combine this with the
674 \&\f(CW\*(C`Shift\*(C'\fR key to extend a selection over the range of motion.
675 .SS "SYSTEM DIALOG"
676 .IX Subsection "SYSTEM DIALOG"
677 The system dialog offers quick access to a set of general controls.
678 It can lock the screen, suspend the system, logout or cancel a pending
679 logout, reboot the system, shutdown the system, show the window list,
680 restart icewm, show the about dialog, reload the winoptions file or
681 the keys file. It is activated by \fBKeySysDialog\fR=\f(CW\*(C`Ctrl+Alt+Del\*(C'\fR.
682 To cancel it, hit the Escape key.
683 .SS "MAILBOX MONITORING"
684 .IX Subsection "MAILBOX MONITORING"
685 The task bar can show one or more icons to reflect the status of a
686 mailbox. The mailbox can be a local file or a remote POP or IMAP
687 account. For this a couple of options must be set. First,
688 \&\fITaskBarShowMailboxStatus\fR must be enabled, which it is by default.
689 Then the location of the mailbox must be set. Icewm first looks for
690 \&\fIMailBoxPath\fR in preferences. If this is unset, it looks at the
691 environment variables \f(CW\*(C`MAILPATH\*(C'\fR and \f(CW\*(C`MAIL\*(C'\fR. \fIMailBoxPath\fR may
692 contain a space\-separated list of mailboxes, while \f(CW\*(C`MAILPATH\*(C'\fR may
693 contain a colon\-separated list of mailboxes. If a mailbox starts
694 with a slash \f(CW\*(C`/\*(C'\fR, then it is a local file, otherwise a URL.
695 These are six examples of possible mailboxes:
696 .PP
697 .Vb 6
698 \& file:///var/spool/mail/captnmark
699 \& file:///home/captnmark/Maildir/
700 \& pop3://markus:%2f%40%[email protected]/
701 \& pop3s://markus:[email protected]/
702 \& imap://mathias@localhost/INBOX.Maillisten.icewm\-user
703 \& imaps://mathias:[email protected]/INBOX
704 .Ve
705 .PP
706 The POP3S and IMAPS schemes use \f(CW\*(C`openssl\*(C'\fR for TLS/SSL encryption.
707 Note that for IceWM to access Gmail you must first configure
708 your Gmail account to enable POP3 or IMAP access.
709 Make sure you have secure file permissions on your IceWM
710 preferences file and the directory that contains it.
711 .PP
712 Reserved characters in the password, like \fIslash\fR, \fIat\fR and \fIcolon\fR
713 can be specified using escape sequences with a hexadecimal encoding
714 like \f(CW%2f\fR for the slash or \f(CW%40\fR for the at sign.
715 For example, to hex\-encode \f(CW\*(C`!p@a%s&s~\*(C'\fR use this Perl snippet:
716 .PP
717 .Vb 2
718 \& perl \-e \*(Aqforeach(split("", $ARGV[0])) { printf "%%%02x", ord($_); };
719 \& print "\en";\*(Aq \*(Aq!p@a%s&s~\*(Aq
720 .Ve
721 .PP
722 Which will print:
723 .PP
724 .Vb 1
725 \& %21%40%23%24%25%5e%26%2a%7e
726 .Ve
727 .PP
728 This is the hex\-encoded password. However, it is unwise to store a
729 password in your preferences. Consider a wallet extension for IceWM.
730 .PP
731 IceWM will check a mailbox periodically. The period in seconds can
732 be set by the \fIMailCheckDelay\fR option, which is 30 seconds by default.
733 .PP
734 Whenever new mail arrives, the mailbox icon will be highlighted.
735 The color will indicate if the mail has been read or not. Hovering
736 the mouse over the mailbox icon will show a tooltip with more details.
737 A command can be also be run on new mail. Set the \fINewMailCommand\fR
738 option. Its environment will have these variables set by IceWM:
739 .IP ICEWM_MAILBOX 4
740 .IX Item "ICEWM_MAILBOX"
741 The mailbox index number of \fIMailBoxPath\fR starting from 1.
742 .IP ICEWM_COUNT 4
743 .IX Item "ICEWM_COUNT"
744 The total number of messages in this mailbox.
745 .IP ICEWM_UNREAD 4
746 .IX Item "ICEWM_UNREAD"
747 The number of unread messages in this mailbox.
748 .SS "KEYBOARD LAYOUT SWITCHING"
749 .IX Subsection "KEYBOARD LAYOUT SWITCHING"
750 To control keyboard layouts on the task bar, define in \fIpreferences\fR
751 the option \fBKeyboardLayouts\fR to a comma\-separated list of your
752 preferred keyboard layouts. For example:
753 .PP
754 .Vb 1
755 \& KeyboardLayouts = "de", "fr", "jp"
756 .Ve
757 .PP
758 A keyboard layout can simply be a name. Usually this is a two\-letter
759 country code. See the directory \fI/usr/share/X11/xkb/symbols\fR for
760 a list of available keyboard layouts for your system. If it is
761 enclosed in double quotes, it can also be a space\-separated list of
762 command\-line arguments to an invocation of the \f(CW\*(C`setxkbmap\*(C'\fR program.
763 .PP
764 The first layout is the default. It will be installed when icewm starts.
765 The task bar will show the current keyboard layout. If an icon can
766 be found for the first two letters of the layout, then that icon
767 will be shown. Otherwise the first two letters of the name of the
768 layout will be shown.
769 .PP
770 Click on the current keyboard layout to cycle through all the
771 available keyboard layouts, or use the \fBKeySysKeyboardNext\fR key.
772 Click with the right mouse button to open a menu of all available
773 keyboard layouts.
774 .PP
775 It is also possible to configure a default keyboard layout for
776 each program individually in the \fBicewm\-winoptions\fR\|(5) file.
777 Whenever such a program receives input focus, icewm will install
778 this configured keyboard layout automatically. The keyboard status
779 on the task bar will be updated to reflect this.
780 .PP
781 Please note that for keyboard layout switching to work, the
782 \&\f(CW\*(C`setxkbmap\*(C'\fR program must be installed. To see your current
783 keyboard layout settings, do \f(CW\*(C`setxkbmap \-query\*(C'\fR.
784 .SS "KEYBOARD SHORTCUTS"
785 .IX Subsection "KEYBOARD SHORTCUTS"
786 \&\fBicewm\fR supports a large number of hotkeys to activate some behaviour
787 with a single key combination. These are all configurable in the
788 \&\fIpreferences\fR file. Here we give their preferences name, followed by
789 their default value in double quotes, and a short descriptions of their
790 effect.
791 .PP
792 Note that all use one or more key modifiers. Icewm supports the
793 following modifiers: Alt, AltGr, Ctrl, Hyper, Meta, Shift, Super.
794 Setting \fBModSuperIsCtrlAlt=1\fR makes the Super modifier an alias
795 for Ctrl+Alt.
796 .ie n .IP "\fBKeyWinRaise\fR=""Alt+F1""" 4
797 .el .IP \fBKeyWinRaise\fR=\f(CWAlt+F1\fR 4
798 .IX Item "KeyWinRaise=Alt+F1"
799 Raises the window that currently has input focus.
800 .ie n .IP "\fBKeyWinOccupyAll\fR=""Alt+F2""" 4
801 .el .IP \fBKeyWinOccupyAll\fR=\f(CWAlt+F2\fR 4
802 .IX Item "KeyWinOccupyAll=Alt+F2"
803 Makes the active window occupy all workspaces.
804 .ie n .IP "\fBKeyWinLower\fR=""Alt+F3""" 4
805 .el .IP \fBKeyWinLower\fR=\f(CWAlt+F3\fR 4
806 .IX Item "KeyWinLower=Alt+F3"
807 Lowers the window that currently has input focus.
808 .ie n .IP "\fBKeyWinClose\fR=""Alt+F4""" 4
809 .el .IP \fBKeyWinClose\fR=\f(CWAlt+F4\fR 4
810 .IX Item "KeyWinClose=Alt+F4"
811 Closes the active window.
812 .ie n .IP "\fBKeyWinRestore\fR=""Alt+F5""" 4
813 .el .IP \fBKeyWinRestore\fR=\f(CWAlt+F5\fR 4
814 .IX Item "KeyWinRestore=Alt+F5"
815 Restores the active window to its visible state.
816 .ie n .IP "\fBKeyWinNext\fR=""Alt+F6""" 4
817 .el .IP \fBKeyWinNext\fR=\f(CWAlt+F6\fR 4
818 .IX Item "KeyWinNext=Alt+F6"
819 Switches focus to the next window.
820 .ie n .IP "\fBKeyWinPrev\fR=""Alt+Shift+F6""" 4
821 .el .IP \fBKeyWinPrev\fR=\f(CWAlt+Shift+F6\fR 4
822 .IX Item "KeyWinPrev=Alt+Shift+F6"
823 Switches focus to the previous window.
824 .ie n .IP "\fBKeyWinMove\fR=""Alt+F7""" 4
825 .el .IP \fBKeyWinMove\fR=\f(CWAlt+F7\fR 4
826 .IX Item "KeyWinMove=Alt+F7"
827 Starts movement of the active window.
828 .ie n .IP "\fBKeyWinSize\fR=""Alt+F8""" 4
829 .el .IP \fBKeyWinSize\fR=\f(CWAlt+F8\fR 4
830 .IX Item "KeyWinSize=Alt+F8"
831 Starts resizing of the active window.
832 .ie n .IP "\fBKeyWinMinimize\fR=""Alt+F9""" 4
833 .el .IP \fBKeyWinMinimize\fR=\f(CWAlt+F9\fR 4
834 .IX Item "KeyWinMinimize=Alt+F9"
835 Iconifies the active window.
836 .ie n .IP "\fBKeyWinMaximize\fR=""Alt+F10""" 4
837 .el .IP \fBKeyWinMaximize\fR=\f(CWAlt+F10\fR 4
838 .IX Item "KeyWinMaximize=Alt+F10"
839 Maximizes the active window with borders.
840 .ie n .IP "\fBKeyWinMaximizeVert\fR=""Alt+Shift+F10""" 4
841 .el .IP \fBKeyWinMaximizeVert\fR=\f(CWAlt+Shift+F10\fR 4
842 .IX Item "KeyWinMaximizeVert=Alt+Shift+F10"
843 Maximizes the active window vertically.
844 .ie n .IP "\fBKeyWinMaximizeHoriz\fR=""undefined""" 4
845 .el .IP \fBKeyWinMaximizeHoriz\fR=\f(CWundefined\fR 4
846 .IX Item "KeyWinMaximizeHoriz=undefined"
847 Maximizes the active window horizontally.
848 .ie n .IP "\fBKeyWinFullscreen\fR=""Alt+F11""" 4
849 .el .IP \fBKeyWinFullscreen\fR=\f(CWAlt+F11\fR 4
850 .IX Item "KeyWinFullscreen=Alt+F11"
851 Maximizes the active window without borders.
852 .ie n .IP "\fBKeyWinRollup\fR=""Alt+F12""" 4
853 .el .IP \fBKeyWinRollup\fR=\f(CWAlt+F12\fR 4
854 .IX Item "KeyWinRollup=Alt+F12"
855 Rolls up the active window.
856 .ie n .IP "\fBKeyWinHide\fR=""Alt+Shift+F12""" 4
857 .el .IP \fBKeyWinHide\fR=\f(CWAlt+Shift+F12\fR 4
858 .IX Item "KeyWinHide=Alt+Shift+F12"
859 Hides the active window.
860 .ie n .IP "\fBKeyWinMenu\fR=""Alt+space""" 4
861 .el .IP \fBKeyWinMenu\fR=\f(CWAlt+space\fR 4
862 .IX Item "KeyWinMenu=Alt+space"
863 Posts the window menu.
864 .ie n .IP "\fBKeyWinArrangeNW\fR=""Ctrl+Alt+KP_7""" 4
865 .el .IP \fBKeyWinArrangeNW\fR=\f(CWCtrl+Alt+KP_7\fR 4
866 .IX Item "KeyWinArrangeNW=Ctrl+Alt+KP_7"
867 Moves the active window to the top left corner of the screen.
868 .ie n .IP "\fBKeyWinArrangeN\fR=""Ctrl+Alt+KP_8""" 4
869 .el .IP \fBKeyWinArrangeN\fR=\f(CWCtrl+Alt+KP_8\fR 4
870 .IX Item "KeyWinArrangeN=Ctrl+Alt+KP_8"
871 Moves the active window to the top middle of the screen.
872 .ie n .IP "\fBKeyWinArrangeNE\fR=""Ctrl+Alt+KP_9""" 4
873 .el .IP \fBKeyWinArrangeNE\fR=\f(CWCtrl+Alt+KP_9\fR 4
874 .IX Item "KeyWinArrangeNE=Ctrl+Alt+KP_9"
875 Moves the active window to the top right of the screen.
876 .ie n .IP "\fBKeyWinArrangeE\fR=""Ctrl+Alt+KP_6""" 4
877 .el .IP \fBKeyWinArrangeE\fR=\f(CWCtrl+Alt+KP_6\fR 4
878 .IX Item "KeyWinArrangeE=Ctrl+Alt+KP_6"
879 Moves the active window to the middle right of the screen.
880 .ie n .IP "\fBKeyWinArrangeSE\fR=""Ctrl+Alt+KP_3""" 4
881 .el .IP \fBKeyWinArrangeSE\fR=\f(CWCtrl+Alt+KP_3\fR 4
882 .IX Item "KeyWinArrangeSE=Ctrl+Alt+KP_3"
883 Moves the active window to the bottom right of the screen.
884 .ie n .IP "\fBKeyWinArrangeS\fR=""Ctrl+Alt+KP_2""" 4
885 .el .IP \fBKeyWinArrangeS\fR=\f(CWCtrl+Alt+KP_2\fR 4
886 .IX Item "KeyWinArrangeS=Ctrl+Alt+KP_2"
887 Moves the active window to the bottom middle of the screen.
888 .ie n .IP "\fBKeyWinArrangeSW\fR=""Ctrl+Alt+KP_1""" 4
889 .el .IP \fBKeyWinArrangeSW\fR=\f(CWCtrl+Alt+KP_1\fR 4
890 .IX Item "KeyWinArrangeSW=Ctrl+Alt+KP_1"
891 Moves the active window to the bottom left of the screen.
892 .ie n .IP "\fBKeyWinArrangeW\fR=""Ctrl+Alt+KP_4""" 4
893 .el .IP \fBKeyWinArrangeW\fR=\f(CWCtrl+Alt+KP_4\fR 4
894 .IX Item "KeyWinArrangeW=Ctrl+Alt+KP_4"
895 Moves the active window to the middle left of the screen.
896 .ie n .IP "\fBKeyWinArrangeC\fR=""Ctrl+Alt+KP_5""" 4
897 .el .IP \fBKeyWinArrangeC\fR=\f(CWCtrl+Alt+KP_5\fR 4
898 .IX Item "KeyWinArrangeC=Ctrl+Alt+KP_5"
899 Moves the active window to the center of the screen.
900 .IP "\fBKeyWinTileLeft\fR=""""" 4
901 .IX Item "KeyWinTileLeft="""""
902 Let the active window occupy the left half of the screen.
903 .IP "\fBKeyWinTileRight\fR=""""" 4
904 .IX Item "KeyWinTileRight="""""
905 Let the active window occupy the right half of the screen.
906 .IP "\fBKeyWinTileTop\fR=""""" 4
907 .IX Item "KeyWinTileTop="""""
908 Let the active window occupy the top half of the screen.
909 .IP "\fBKeyWinTileBottom\fR=""""" 4
910 .IX Item "KeyWinTileBottom="""""
911 Let the active window occupy the bottom half of the screen.
912 .IP "\fBKeyWinTileTopLeft\fR=""""" 4
913 .IX Item "KeyWinTileTopLeft="""""
914 Let the active window occupy the top left quarter of the screen.
915 .IP "\fBKeyWinTileTopRight\fR=""""" 4
916 .IX Item "KeyWinTileTopRight="""""
917 Let the active window occupy the top right quarter of the screen.
918 .IP "\fBKeyWinTileBottomLeft\fR=""""" 4
919 .IX Item "KeyWinTileBottomLeft="""""
920 Let the active window occupy the bottom left quarter of the screen.
921 .IP "\fBKeyWinTileBottomRight\fR=""""" 4
922 .IX Item "KeyWinTileBottomRight="""""
923 Let the active window occupy the bottom right quarter of the screen.
924 .IP "\fBKeyWinTileCenter\fR=""""" 4
925 .IX Item "KeyWinTileCenter="""""
926 Let the active window occupy the center quarter of the screen.
927 .ie n .IP "\fBKeyWinSmartPlace\fR=""Ctrl+Alt+Shift+KP_5""" 4
928 .el .IP \fBKeyWinSmartPlace\fR=\f(CWCtrl+Alt+Shift+KP_5\fR 4
929 .IX Item "KeyWinSmartPlace=Ctrl+Alt+Shift+KP_5"
930 Smart place the active window.
931 .ie n .IP "\fBKeySysWinMenu\fR=""Shift+Esc""" 4
932 .el .IP \fBKeySysWinMenu\fR=\f(CWShift+Esc\fR 4
933 .IX Item "KeySysWinMenu=Shift+Esc"
934 Posts the system window menu.
935 .ie n .IP "\fBKeySysWinNext\fR=""Alt+Esc""" 4
936 .el .IP \fBKeySysWinNext\fR=\f(CWAlt+Esc\fR 4
937 .IX Item "KeySysWinNext=Alt+Esc"
938 Give focus to the next window and raise it.
939 .ie n .IP "\fBKeySysWinPrev\fR=""Alt+Shift+Esc""" 4
940 .el .IP \fBKeySysWinPrev\fR=\f(CWAlt+Shift+Esc\fR 4
941 .IX Item "KeySysWinPrev=Alt+Shift+Esc"
942 Give focus to the previous window and raise it.
943 .ie n .IP "\fBKeySysDialog\fR=""Ctrl+Alt+Del""" 4
944 .el .IP \fBKeySysDialog\fR=\f(CWCtrl+Alt+Del\fR 4
945 .IX Item "KeySysDialog=Ctrl+Alt+Del"
946 Opens the IceWM system dialog in the center of the screen.
947 .ie n .IP "\fBKeySysMenu\fR=""Ctrl+Esc""" 4
948 .el .IP \fBKeySysMenu\fR=\f(CWCtrl+Esc\fR 4
949 .IX Item "KeySysMenu=Ctrl+Esc"
950 Activates the IceWM root menu in the lower left corner.
951 .ie n .IP "\fBKeySysWindowList\fR=""Alt+Ctrl+Esc""" 4
952 .el .IP \fBKeySysWindowList\fR=\f(CWAlt+Ctrl+Esc\fR 4
953 .IX Item "KeySysWindowList=Alt+Ctrl+Esc"
954 Opens the IceWM system window list in the center of the screen.
955 .ie n .IP "\fBKeySysAddressBar\fR=""Alt+Ctrl+space""" 4
956 .el .IP \fBKeySysAddressBar\fR=\f(CWAlt+Ctrl+space\fR 4
957 .IX Item "KeySysAddressBar=Alt+Ctrl+space"
958 Opens the address bar in the task bar where a command can be typed.
959 .ie n .IP "\fBKeySysWorkspacePrev\fR=""Alt+Ctrl+Left""" 4
960 .el .IP \fBKeySysWorkspacePrev\fR=\f(CWAlt+Ctrl+Left\fR 4
961 .IX Item "KeySysWorkspacePrev=Alt+Ctrl+Left"
962 Goes one workspace to the left.
963 .ie n .IP "\fBKeySysWorkspaceNext\fR=""Alt+Ctrl+Right""" 4
964 .el .IP \fBKeySysWorkspaceNext\fR=\f(CWAlt+Ctrl+Right\fR 4
965 .IX Item "KeySysWorkspaceNext=Alt+Ctrl+Right"
966 Goes one workspace to the right.
967 .ie n .IP "\fBKeySysWorkspaceLast\fR=""Alt+Ctrl+Down""" 4
968 .el .IP \fBKeySysWorkspaceLast\fR=\f(CWAlt+Ctrl+Down\fR 4
969 .IX Item "KeySysWorkspaceLast=Alt+Ctrl+Down"
970 Goes to the previous workspace.
971 .ie n .IP "\fBKeySysWorkspacePrevTakeWin\fR=""Alt+Ctrl+Shift+Left""" 4
972 .el .IP \fBKeySysWorkspacePrevTakeWin\fR=\f(CWAlt+Ctrl+Shift+Left\fR 4
973 .IX Item "KeySysWorkspacePrevTakeWin=Alt+Ctrl+Shift+Left"
974 Takes the active window one workspace to the left.
975 .ie n .IP "\fBKeySysWorkspaceNextTakeWin\fR=""Alt+Ctrl+Shift+Right""" 4
976 .el .IP \fBKeySysWorkspaceNextTakeWin\fR=\f(CWAlt+Ctrl+Shift+Right\fR 4
977 .IX Item "KeySysWorkspaceNextTakeWin=Alt+Ctrl+Shift+Right"
978 Takes the active window one workspace to the right.
979 .ie n .IP "\fBKeySysWorkspaceLastTakeWin\fR=""Alt+Ctrl+Shift+Down""" 4
980 .el .IP \fBKeySysWorkspaceLastTakeWin\fR=\f(CWAlt+Ctrl+Shift+Down\fR 4
981 .IX Item "KeySysWorkspaceLastTakeWin=Alt+Ctrl+Shift+Down"
982 Takes the active window to the previous workspace.
983 .ie n .IP "\fBKeySysWorkspace1\fR=""Alt+Ctrl+1""" 4
984 .el .IP \fBKeySysWorkspace1\fR=\f(CWAlt+Ctrl+1\fR 4
985 .IX Item "KeySysWorkspace1=Alt+Ctrl+1"
986 Goes to workspace 1.
987 .ie n .IP "\fBKeySysWorkspace2\fR=""Alt+Ctrl+2""" 4
988 .el .IP \fBKeySysWorkspace2\fR=\f(CWAlt+Ctrl+2\fR 4
989 .IX Item "KeySysWorkspace2=Alt+Ctrl+2"
990 Goes to workspace 2.
991 .ie n .IP "\fBKeySysWorkspace3\fR=""Alt+Ctrl+3""" 4
992 .el .IP \fBKeySysWorkspace3\fR=\f(CWAlt+Ctrl+3\fR 4
993 .IX Item "KeySysWorkspace3=Alt+Ctrl+3"
994 Goes to workspace 3.
995 .ie n .IP "\fBKeySysWorkspace4\fR=""Alt+Ctrl+4""" 4
996 .el .IP \fBKeySysWorkspace4\fR=\f(CWAlt+Ctrl+4\fR 4
997 .IX Item "KeySysWorkspace4=Alt+Ctrl+4"
998 Goes to workspace 4.
999 .ie n .IP "\fBKeySysWorkspace5\fR=""Alt+Ctrl+5""" 4
1000 .el .IP \fBKeySysWorkspace5\fR=\f(CWAlt+Ctrl+5\fR 4
1001 .IX Item "KeySysWorkspace5=Alt+Ctrl+5"
1002 Goes to workspace 5.
1003 .ie n .IP "\fBKeySysWorkspace6\fR=""Alt+Ctrl+6""" 4
1004 .el .IP \fBKeySysWorkspace6\fR=\f(CWAlt+Ctrl+6\fR 4
1005 .IX Item "KeySysWorkspace6=Alt+Ctrl+6"
1006 Goes to workspace 6.
1007 .ie n .IP "\fBKeySysWorkspace7\fR=""Alt+Ctrl+7""" 4
1008 .el .IP \fBKeySysWorkspace7\fR=\f(CWAlt+Ctrl+7\fR 4
1009 .IX Item "KeySysWorkspace7=Alt+Ctrl+7"
1010 Goes to workspace 7.
1011 .ie n .IP "\fBKeySysWorkspace8\fR=""Alt+Ctrl+8""" 4
1012 .el .IP \fBKeySysWorkspace8\fR=\f(CWAlt+Ctrl+8\fR 4
1013 .IX Item "KeySysWorkspace8=Alt+Ctrl+8"
1014 Goes to workspace 8.
1015 .ie n .IP "\fBKeySysWorkspace9\fR=""Alt+Ctrl+9""" 4
1016 .el .IP \fBKeySysWorkspace9\fR=\f(CWAlt+Ctrl+9\fR 4
1017 .IX Item "KeySysWorkspace9=Alt+Ctrl+9"
1018 Goes to workspace 9.
1019 .ie n .IP "\fBKeySysWorkspace10\fR=""Alt+Ctrl+0""" 4
1020 .el .IP \fBKeySysWorkspace10\fR=\f(CWAlt+Ctrl+0\fR 4
1021 .IX Item "KeySysWorkspace10=Alt+Ctrl+0"
1022 Goes to workspace 10.
1023 .ie n .IP "\fBKeySysWorkspace11\fR=""Alt+Ctrl+minus""" 4
1024 .el .IP \fBKeySysWorkspace11\fR=\f(CWAlt+Ctrl+minus\fR 4
1025 .IX Item "KeySysWorkspace11=Alt+Ctrl+minus"
1026 Goes to workspace 11.
1027 .ie n .IP "\fBKeySysWorkspace12\fR=""Alt+Ctrl+equal""" 4
1028 .el .IP \fBKeySysWorkspace12\fR=\f(CWAlt+Ctrl+equal\fR 4
1029 .IX Item "KeySysWorkspace12=Alt+Ctrl+equal"
1030 Goes to workspace 12.
1031 .ie n .IP "\fBKeySysWorkspace1TakeWin\fR=""Alt+Ctrl+Shift+1""" 4
1032 .el .IP \fBKeySysWorkspace1TakeWin\fR=\f(CWAlt+Ctrl+Shift+1\fR 4
1033 .IX Item "KeySysWorkspace1TakeWin=Alt+Ctrl+Shift+1"
1034 Takes the active window to workspace 1.
1035 .ie n .IP "\fBKeySysWorkspace2TakeWin\fR=""Alt+Ctrl+Shift+2""" 4
1036 .el .IP \fBKeySysWorkspace2TakeWin\fR=\f(CWAlt+Ctrl+Shift+2\fR 4
1037 .IX Item "KeySysWorkspace2TakeWin=Alt+Ctrl+Shift+2"
1038 Takes the active window to workspace 2.
1039 .ie n .IP "\fBKeySysWorkspace3TakeWin\fR=""Alt+Ctrl+Shift+3""" 4
1040 .el .IP \fBKeySysWorkspace3TakeWin\fR=\f(CWAlt+Ctrl+Shift+3\fR 4
1041 .IX Item "KeySysWorkspace3TakeWin=Alt+Ctrl+Shift+3"
1042 Takes the active window to workspace 3.
1043 .ie n .IP "\fBKeySysWorkspace4TakeWin\fR=""Alt+Ctrl+Shift+4""" 4
1044 .el .IP \fBKeySysWorkspace4TakeWin\fR=\f(CWAlt+Ctrl+Shift+4\fR 4
1045 .IX Item "KeySysWorkspace4TakeWin=Alt+Ctrl+Shift+4"
1046 Takes the active window to workspace 4.
1047 .ie n .IP "\fBKeySysWorkspace5TakeWin\fR=""Alt+Ctrl+Shift+5""" 4
1048 .el .IP \fBKeySysWorkspace5TakeWin\fR=\f(CWAlt+Ctrl+Shift+5\fR 4
1049 .IX Item "KeySysWorkspace5TakeWin=Alt+Ctrl+Shift+5"
1050 Takes the active window to workspace 5.
1051 .ie n .IP "\fBKeySysWorkspace6TakeWin\fR=""Alt+Ctrl+Shift+6""" 4
1052 .el .IP \fBKeySysWorkspace6TakeWin\fR=\f(CWAlt+Ctrl+Shift+6\fR 4
1053 .IX Item "KeySysWorkspace6TakeWin=Alt+Ctrl+Shift+6"
1054 Takes the active window to workspace 6.
1055 .ie n .IP "\fBKeySysWorkspace7TakeWin\fR=""Alt+Ctrl+Shift+7""" 4
1056 .el .IP \fBKeySysWorkspace7TakeWin\fR=\f(CWAlt+Ctrl+Shift+7\fR 4
1057 .IX Item "KeySysWorkspace7TakeWin=Alt+Ctrl+Shift+7"
1058 Takes the active window to workspace 7.
1059 .ie n .IP "\fBKeySysWorkspace8TakeWin\fR=""Alt+Ctrl+Shift+8""" 4
1060 .el .IP \fBKeySysWorkspace8TakeWin\fR=\f(CWAlt+Ctrl+Shift+8\fR 4
1061 .IX Item "KeySysWorkspace8TakeWin=Alt+Ctrl+Shift+8"
1062 Takes the active window to workspace 8.
1063 .ie n .IP "\fBKeySysWorkspace9TakeWin\fR=""Alt+Ctrl+Shift+9""" 4
1064 .el .IP \fBKeySysWorkspace9TakeWin\fR=\f(CWAlt+Ctrl+Shift+9\fR 4
1065 .IX Item "KeySysWorkspace9TakeWin=Alt+Ctrl+Shift+9"
1066 Takes the active window to workspace 9.
1067 .ie n .IP "\fBKeySysWorkspace10TakeWin\fR=""Alt+Ctrl+Shift+0""" 4
1068 .el .IP \fBKeySysWorkspace10TakeWin\fR=\f(CWAlt+Ctrl+Shift+0\fR 4
1069 .IX Item "KeySysWorkspace10TakeWin=Alt+Ctrl+Shift+0"
1070 Takes the active window to workspace 10.
1071 .ie n .IP "\fBKeySysWorkspace11TakeWin\fR=""Alt+Ctrl+Shift+minus""" 4
1072 .el .IP \fBKeySysWorkspace11TakeWin\fR=\f(CWAlt+Ctrl+Shift+minus\fR 4
1073 .IX Item "KeySysWorkspace11TakeWin=Alt+Ctrl+Shift+minus"
1074 Takes the active window to workspace 11.
1075 .ie n .IP "\fBKeySysWorkspace12TakeWin\fR=""Alt+Ctrl+Shift+equal""" 4
1076 .el .IP \fBKeySysWorkspace12TakeWin\fR=\f(CWAlt+Ctrl+Shift+equal\fR 4
1077 .IX Item "KeySysWorkspace12TakeWin=Alt+Ctrl+Shift+equal"
1078 Takes the active window to workspace 12.
1079 .ie n .IP "\fBKeySysTileVertical\fR=""Alt+Shift+F2""" 4
1080 .el .IP \fBKeySysTileVertical\fR=\f(CWAlt+Shift+F2\fR 4
1081 .IX Item "KeySysTileVertical=Alt+Shift+F2"
1082 Tiles all windows from left to right maximized vertically.
1083 .ie n .IP "\fBKeySysTileHorizontal\fR=""Alt+Shift+F3""" 4
1084 .el .IP \fBKeySysTileHorizontal\fR=\f(CWAlt+Shift+F3\fR 4
1085 .IX Item "KeySysTileHorizontal=Alt+Shift+F3"
1086 Tiles all windows from top to bottom maximized horizontally.
1087 .ie n .IP "\fBKeySysCascade\fR=""Alt+Shift+F4""" 4
1088 .el .IP \fBKeySysCascade\fR=\f(CWAlt+Shift+F4\fR 4
1089 .IX Item "KeySysCascade=Alt+Shift+F4"
1090 Makes a horizontal cascade of all windows which are maximized vertically.
1091 .ie n .IP "\fBKeySysArrange\fR=""Alt+Shift+F5""" 4
1092 .el .IP \fBKeySysArrange\fR=\f(CWAlt+Shift+F5\fR 4
1093 .IX Item "KeySysArrange=Alt+Shift+F5"
1094 Rearranges the windows.
1095 .ie n .IP "\fBKeySysUndoArrange\fR=""Alt+Shift+F7""" 4
1096 .el .IP \fBKeySysUndoArrange\fR=\f(CWAlt+Shift+F7\fR 4
1097 .IX Item "KeySysUndoArrange=Alt+Shift+F7"
1098 Undoes arrangement.
1099 .ie n .IP "\fBKeySysArrangeIcons\fR=""Alt+Shift+F8""" 4
1100 .el .IP \fBKeySysArrangeIcons\fR=\f(CWAlt+Shift+F8\fR 4
1101 .IX Item "KeySysArrangeIcons=Alt+Shift+F8"
1102 Rearranges icons.
1103 .ie n .IP "\fBKeySysMinimizeAll\fR=""Alt+Shift+F9""" 4
1104 .el .IP \fBKeySysMinimizeAll\fR=\f(CWAlt+Shift+F9\fR 4
1105 .IX Item "KeySysMinimizeAll=Alt+Shift+F9"
1106 Minimizes all windows.
1107 .ie n .IP "\fBKeySysHideAll\fR=""Alt+Shift+F11""" 4
1108 .el .IP \fBKeySysHideAll\fR=\f(CWAlt+Shift+F11\fR 4
1109 .IX Item "KeySysHideAll=Alt+Shift+F11"
1110 Hides all windows.
1111 .ie n .IP "\fBKeySysShowDesktop\fR=""Alt+Ctrl+d""" 4
1112 .el .IP \fBKeySysShowDesktop\fR=\f(CWAlt+Ctrl+d\fR 4
1113 .IX Item "KeySysShowDesktop=Alt+Ctrl+d"
1114 Unmaps all windows to show the desktop.
1115 .ie n .IP "\fBKeySysCollapseTaskBar\fR=""Alt+Ctrl+h""" 4
1116 .el .IP \fBKeySysCollapseTaskBar\fR=\f(CWAlt+Ctrl+h\fR 4
1117 .IX Item "KeySysCollapseTaskBar=Alt+Ctrl+h"
1118 Hides the task bar.
1119 .ie n .IP "\fBKeyTaskBarSwitchNext\fR=""undefined""" 4
1120 .el .IP \fBKeyTaskBarSwitchNext\fR=\f(CWundefined\fR 4
1121 .IX Item "KeyTaskBarSwitchNext=undefined"
1122 Switches to the next window in the task bar.
1123 .ie n .IP "\fBKeyTaskBarSwitchPrev\fR=""undefined""" 4
1124 .el .IP \fBKeyTaskBarSwitchPrev\fR=\f(CWundefined\fR 4
1125 .IX Item "KeyTaskBarSwitchPrev=undefined"
1126 Switches to the previous window in the task bar.
1127 .ie n .IP "\fBKeyTaskBarMoveNext\fR=""undefined""" 4
1128 .el .IP \fBKeyTaskBarMoveNext\fR=\f(CWundefined\fR 4
1129 .IX Item "KeyTaskBarMoveNext=undefined"
1130 Moves the task bar button of the current window
1131 right.
1132 .ie n .IP "\fBKeyTaskBarMovePrev\fR=""undefined""" 4
1133 .el .IP \fBKeyTaskBarMovePrev\fR=\f(CWundefined\fR 4
1134 .IX Item "KeyTaskBarMovePrev=undefined"
1135 Moves the task bar button of the current window
1136 left.
1137 .ie n .IP "\fBKeySysWinListMenu\fR=""undefined""" 4
1138 .el .IP \fBKeySysWinListMenu\fR=\f(CWundefined\fR 4
1139 .IX Item "KeySysWinListMenu=undefined"
1140 Shows the window list menu.
1141 .ie n .IP "\fBKeySysKeyboardNext\fR=""undefined""" 4
1142 .el .IP \fBKeySysKeyboardNext\fR=\f(CWundefined\fR 4
1143 .IX Item "KeySysKeyboardNext=undefined"
1144 Switch to the next keyboard layout in the KeyboardLayouts list.
1145 .ie n .IP "\fBKeySysSwitchNext\fR=""Alt+Tab""" 4
1146 .el .IP \fBKeySysSwitchNext\fR=\f(CWAlt+Tab\fR 4
1147 .IX Item "KeySysSwitchNext=Alt+Tab"
1148 Opens the \f(CW\*(C`QuickSwitch\*(C'\fR popup (see "INPUT FOCUS")
1149 and/or moves the selector in the \f(CW\*(C`QuickSwitch\*(C'\fR popup.
1150 .ie n .IP "\fBKeySysSwitchLast\fR=""Alt+Shift+Tab""" 4
1151 .el .IP \fBKeySysSwitchLast\fR=\f(CWAlt+Shift+Tab\fR 4
1152 .IX Item "KeySysSwitchLast=Alt+Shift+Tab"
1153 Works like \f(CW\*(C`KeySysSwitchNext\*(C'\fR but moving in the
1154 opposite direction.
1155 .ie n .IP "\fBKeySysSwitchClass\fR=""Alt+grave""" 4
1156 .el .IP \fBKeySysSwitchClass\fR=\f(CWAlt+grave\fR 4
1157 .IX Item "KeySysSwitchClass=Alt+grave"
1158 Is like \f(CW\*(C`KeySysSwitchNext\*(C'\fR but only for windows
1159 with the same WM_CLASS property as the currently focused window.
1160 .SS "MOUSE BINDINGS"
1161 .IX Subsection "MOUSE BINDINGS"
1162 You can control windows by a modified mouse button press:
1163 .ie n .IP "\fBMouseWinMove\fR=""Alt+Pointer_Button1""" 4
1164 .el .IP \fBMouseWinMove\fR=\f(CWAlt+Pointer_Button1\fR 4
1165 .IX Item "MouseWinMove=Alt+Pointer_Button1"
1166 Moves the window under the mouse over the screen.
1167 .ie n .IP "\fBMouseWinSize\fR=""Alt+Pointer_Button3""" 4
1168 .el .IP \fBMouseWinSize\fR=\f(CWAlt+Pointer_Button3\fR 4
1169 .IX Item "MouseWinSize=Alt+Pointer_Button3"
1170 Resizes the window. Keep the key and button pressed.
1171 To enlarge the window move the mouse button away from the center. To
1172 shrink it move towards the centre.
1173 .ie n .IP "\fBMouseWinRaise\fR=""Ctrl+Alt+Pointer_Button1""" 4
1174 .el .IP \fBMouseWinRaise\fR=\f(CWCtrl+Alt+Pointer_Button1\fR 4
1175 .IX Item "MouseWinRaise=Ctrl+Alt+Pointer_Button1"
1176 Raises the window under the mouse.
1177 .ie n .IP "\fBMouseWinLower\fR=""Ctrl+Alt+Pointer_Button1""" 4
1178 .el .IP \fBMouseWinLower\fR=\f(CWCtrl+Alt+Pointer_Button1\fR 4
1179 .IX Item "MouseWinLower=Ctrl+Alt+Pointer_Button1"
1180 Lowers the window under the mouse.
1181 If this is equal to \f(CW\*(C`MouseWinRaise\*(C'\fR and the window can be raised
1182 then \f(CW\*(C`MouseWinRaise\*(C'\fR takes preference over \f(CW\*(C`MouseWinLower\*(C'\fR.
1183 .IP "\fBMouseWinTabbing\fR=""Shift+Pointer_Button2""" 4
1184 .IX Item "MouseWinTabbing=""Shift+Pointer_Button2"""
1185 Mouse binding to create tabs.
1186 Drag the title bar with this button over another title bar.
1187 When they start to flash, release the button to merge the frame tabs.
1188 .PP
1189 The title frame of a window also listens for mouse clicks. A left
1190 double\-click maximizes the window (\f(CW\*(C`TitleBarMaximizeButton=1\*(C'\fR).
1191 When Shift is also pressed it only maximizes vertically.
1192 Press Alt+Shift to maximize horizontally.
1193 .PP
1194 Middle double\-clicking rolls up the window (\f(CW\*(C`TitleBarRollupButton=2\*(C'\fR).
1195 Also press Shift to maximize horizontally. If \fBTitleBarRollupButton\fR
1196 is either 4 or 5 then the scroll wheel controls rolling up or down.
1197 .PP
1198 Press a mouse button on the title bar and drag it to move the window.
1199 To drag a maximized window, keep the Shift key down.
1200 A \f(CW\*(C`Alt+Pointer_Button1\*(C'\fR click in the title bar lowers the window.
1201 .PP
1202 When the mouse is on the window frame then a left click raises the
1203 window. Dragging with the left button down resizes the window.
1204 Clicking the right button pops up the context menu. Dragging with the
1205 right button moves the window.
1206 .PP
1207 Double\-clicking on the frame border (or corner) maximizes just that side
1208 of the window. Another double\-click restores that side. Double\-clicking
1209 on the border can also undo a maximization in that dimension.
1210 .PP
1211 Clicking on the desktop activates a menu. The middle button shows the
1212 window list (\f(CW\*(C`DesktopWinListButton=2\*(C'\fR). The right button shows the
1213 root menu (\f(CW\*(C`DesktopMenuButton=3\*(C'\fR). If you press \f(CW\*(C`Ctrl+Alt\*(C'\fR then
1214 the mouse wheel will focus all applications in turn.
1215 .SS SIGNALS
1216 .IX Subsection "SIGNALS"
1217 \&\fBicewm\fR supports the following signals:
1218 .IP \fBSIGHUP\fR 4
1219 .IX Item "SIGHUP"
1220 \&\fBicewm\fR will restart itself. It is a way to reload the configuration.
1221 .IP "\fBSIGINT\fR, \fBSIGTERM\fR" 4
1222 .IX Item "SIGINT, SIGTERM"
1223 \&\fBicewm\fR will cease to manage application windows and terminate.
1224 .IP \fBSIGQUIT\fR 4
1225 .IX Item "SIGQUIT"
1226 \&\fBicewm\fR will initiate the logout procedure. If a \f(CW\*(C`LogoutCommand\*(C'\fR
1227 preferences option was configured it will be executed.
1228 .IP \fBSIGUSR2\fR 4
1229 .IX Item "SIGUSR2"
1230 Toggle the logging of X11 events, if \f(CW\*(C`logevents\*(C'\fR was configured.
1231 .SS "ENVIRONMENT VARIABLES"
1232 .IX Subsection "ENVIRONMENT VARIABLES"
1233 .IP \fBICEWM_PRIVCFG\fR 4
1234 .IX Item "ICEWM_PRIVCFG"
1235 The directory for user private configuration files. When this
1236 environment variable is not specified, the default directory is
1237 \&\fR\f(CI$XDG_CONFIG_HOME\fR\fI/icewm\fR when that directory exists, otherwise the
1238 default value is \fI\fR\f(CI$HOME\fR\fI/.icewm\fR.
1239 .IP \fBDISPLAY\fR 4
1240 .IX Item "DISPLAY"
1241 The name of the X11 server. See \fBXorg\fR\|(1) or \fBXserver\fR\|(1). This
1242 value can be overridden by the \fB\-\-display\fR option.
1243 .IP "\fBMAILPATH\fR, \fBMAIL\fR" 4
1244 .IX Item "MAILPATH, MAIL"
1245 Gives the location of your mailbox. If the schema is omitted the local
1246 "file" schema is assumed. This is used by the mailbox applet in the
1247 task bar to show the status of your mailbox. If the \f(CW\*(C`MailBoxPath\*(C'\fR
1248 option in the \fIpreferences\fR file is set, then that one takes
1249 precedence.
1250 .SS FILES
1251 .IX Subsection "FILES"
1252 .SS "CONFIGURATION DIRECTORIES"
1253 .IX Subsection "CONFIGURATION DIRECTORIES"
1254 \&\fBicewm\fR looks for configuration files in the following directories, in
1255 the given order, until it finds one:
1256 .ie n .IP \fR\fI$ICEWM_PRIVCFG\fR\fI/\fR 4
1257 .el .IP \fR\f(CI$ICEWM_PRIVCFG\fR\fI/\fR 4
1258 .IX Item "$ICEWM_PRIVCFG/"
1259 Contains user\-specific configurations. When \fBICEWM_PRIVCFG\fR is
1260 specified, this directory takes precedence over
1261 \&\fR\f(CI$XDG_CONFIG_HOME\fR\fI/icewm\fR and \fI\fR\f(CI$HOME\fR\fI/.icewm\fR.
1262 .ie n .IP \fR\fI$XDG_CONFIG_HOME\fR\fI/icewm/\fR 4
1263 .el .IP \fR\f(CI$XDG_CONFIG_HOME\fR\fI/icewm/\fR 4
1264 .IX Item "$XDG_CONFIG_HOME/icewm/"
1265 Contains user\-specific configurations. When this directory exists it
1266 take precedence over \fR\f(CI$HOME\fR\fI/.icewm\fR.
1267 .ie n .IP \fR\fI$HOME\fR\fI/.icewm/\fR 4
1268 .el .IP \fR\f(CI$HOME\fR\fI/.icewm/\fR 4
1269 .IX Item "$HOME/.icewm/"
1270 Contains user\-specific configurations. This is the historical default
1271 directory.
1272 .IP \fI/etc/icewm/\fR 4
1273 .IX Item "/etc/icewm/"
1274 Contains system\-wide customized defaults. Please note that your local
1275 installation may have been configured to use a different system
1276 location. The output of \f(CW\*(C`icewm \-\-directories\*(C'\fR will show this location.
1277 .IP \fI/usr/share/icewm/\fR 4
1278 .IX Item "/usr/share/icewm/"
1279 Default local installation settings.
1280 .SS "CONFIGURATION FILES"
1281 .IX Subsection "CONFIGURATION FILES"
1282 .IP \fIenv\fR 4
1283 .IX Item "env"
1284 \&\fBicewm\-session\fR\|(1) loads additional environment variables from the file
1285 \&\fIenv\fR. Each line is subjected to POSIX shell expansion by
1286 \&\fBwordexp\fR\|(3). Comment lines starting by a hash\-sign (\f(CW\*(C`#\*(C'\fR) are ignored.
1287 \&\fBicewm\-session\fR\|(1) will load those expanded lines that contain a name,
1288 followed by an equals sign, followed by the value (which may be empty).
1289 .Sp
1290 See \fBicewm\-env\fR\|(5).
1291 .IP \fIfocus_mode\fR 4
1292 .IX Item "focus_mode"
1293 Defines the initial value for \f(CW\*(C`FocusMode\*(C'\fR. Its default value is
1294 \&\f(CW\*(C`FocusMode=1\*(C'\fR (Click\-to\-focus). This can be changed via the menu.
1295 \&\fBicewm\fR will save the Focus menu choice in this file.
1296 .Sp
1297 See \fBicewm\-focus_mode\fR\|(5).
1298 .IP \fIkeys\fR 4
1299 .IX Item "keys"
1300 Global keybindings to launch applications, which need not be window
1301 manager related. Each non\-empty line starts with the word \f(CW\*(C`key\*(C'\fR.
1302 After one or more spaces follows a double\-quoted string of the bound X11
1303 key combination like \f(CW\*(C`Alt+Ctrl+Shift+X\*(C'\fR. Then after at least one space
1304 follows a shell command\-line that will be executed by \fBicewm\fR whenever
1305 this key combination is pressed. For example, the following line
1306 creates a hotkey to reload the \fBicewm\fR configuration:
1307 .Sp
1308 .Vb 1
1309 \& key "Ctrl+Shift+r" icesh restart
1310 .Ve
1311 .Sp
1312 See \fBicewm\-keys\fR\|(5).
1313 .IP \fImenu\fR 4
1314 .IX Item "menu"
1315 A menu of applications; usually customized by the user. \fBicewm\fR
1316 provides the \fBicewm\-menu\-fdo\fR\|(1) program to generate a default menu.
1317 Similar programs are \fBxdg_menu\fR\|(1), \fBmmaker\fR\|(1) (MenuMaker),
1318 \&\fBxde\-menu\fR\|(1), \fBxdgmenumaker\fR\|(1).
1319 .Sp
1320 See \fBicewm\-menu\fR\|(5).
1321 .IP \fIpreferences\fR 4
1322 .IX Item "preferences"
1323 Contains general settings like paths, colors and fonts, but also options
1324 to control the \fBicewm\fR focus behaviour and the applets that are
1325 started in the task bar. The \fBicewm\fR installation will provide a
1326 default \fIpreferences\fR file, which can be copied to the \fBicewm\fR user
1327 configuration directory and modified.
1328 .Sp
1329 See \fBicewm\-preferences\fR\|(5).
1330 .IP \fIprefoverride\fR 4
1331 .IX Item "prefoverride"
1332 Settings which override the settings from a theme. Some of the \fBicewm\fR
1333 configuration options from the preferences file that control the
1334 look\-and\-feel may be overridden by the theme, if the theme designer
1335 thinks this is desirable. However, this \fIprefoverride\fR file will again
1336 override this for a few specific options of your choosing. It is safe
1337 to leave this file empty initially.
1338 .Sp
1339 See \fBicewm\-prefoverride\fR\|(5).
1340 .IP \fIprograms\fR 4
1341 .IX Item "programs"
1342 An automatically generated menu of applications. This could be used by
1343 \&\fBwmconfig\fR\|(1), menu or similar programs to give easy access to all the
1344 desktop applications that are installed on the system.
1345 .Sp
1346 See \fBicewm\-programs\fR\|(5).
1347 .IP \fItheme\fR 4
1348 .IX Item "theme"
1349 This file contains the name of the default theme. On startup \fBicewm\fR
1350 reads this file to obtain the theme name, unless \fBicewm\fR was started
1351 with the \fB\-\-theme\fR option. Whenever a different theme is selected from
1352 the \fBicewm\fR Menu then the theme file is overwritten with the name of
1353 the selected theme. This theme file contains the keyword \f(CW\*(C`Theme\*(C'\fR,
1354 followed by an equals sign, followed by a double\-quoted string with the
1355 theme name. The theme name is the name of the theme directory, followed
1356 by a slash, followed by the theme file. Usually the theme file is just
1357 \&\fIdefault.theme\fR, but a theme may have alternatives. Alternatives are
1358 small tweaks of a theme. These are specified in their own \fI.theme\fR
1359 file, which replaces \fIdefault.theme\fR. If no theme file exists then
1360 \&\fBicewm\fR will use as default \f(CW\*(C`Theme="icedesert/default.theme"\*(C'\fR.
1361 .Sp
1362 See \fBicewm\-theme\fR\|(5).
1363 .IP \fItoolbar\fR 4
1364 .IX Item "toolbar"
1365 Contains names of quick to launch applications with icons for the task
1366 bar. Each non\-empty non\-comment line starts with the keyword \fBprog\fR.
1367 After one or more spaces follows a name, which is displayed in a tool
1368 tip whenever the mouse cursor hovers over the toolbar icon. This name
1369 may be a double quoted string. Then follows the bare name of the icon
1370 to use without extensions. This icon will be shown in the toolbar. The
1371 last component is a shell command\-line that will be executed whenever
1372 the user presses the icon in the toolbar. For example, the following
1373 line in toolbar will create a button with tool tip \f(CW\*(C`Mozilla Firefox\*(C'\fR
1374 with the \fIfirefox\fR icon that launches \fBfirefox\fR\|(1) when clicked:
1375 .Sp
1376 .Vb 1
1377 \& prog "Mozilla Firefox" firefox /usr/bin/firefox \-\-private\-window
1378 .Ve
1379 .Sp
1380 See \fBicewm\-toolbar\fR\|(5).
1381 .IP \fIwinoptions\fR 4
1382 .IX Item "winoptions"
1383 Contains settings to control window appearance and behaviour that are
1384 specific to applications or groups of applications. Options can control
1385 the border, whether it appears on the task bar, the window list, the
1386 system tray and the workspaces. Also its layer, geometry, whether it
1387 can be moved, resized and closed.
1388 .Sp
1389 See \fBicewm\-winoptions\fR\|(5).
1390 .IP \fIstartup\fR 4
1391 .IX Item "startup"
1392 Contains commands to be executed on \fBicewm\fR startup. This is an
1393 executable script with commands to tweak X11 settings and launch some
1394 applications that need to be active whenever \fBicewm\fR is started.
1395 It is run by \fBicewm\-session\fR\|(1) when \fBicewm\fR starts.
1396 .Sp
1397 See \fBicewm\-startup\fR\|(5).
1398 .IP \fIshutdown\fR 4
1399 .IX Item "shutdown"
1400 Contains commands to be executed on \fBicewm\fR shutdown. This is an
1401 executable script with commands to be executed in the last stage of
1402 \&\fBicewm\fR termination. Typically they may undo some of the effects of
1403 the \fIstartup\fR script. It is run by \fBicewm\-session\fR\|(1) when \fBicewm\fR
1404 terminates.
1405 .Sp
1406 See \fBicewm\-shutdown\fR\|(5).
1407 .SS "CONFIGURATION SUBDIRECTORIES"
1408 .IX Subsection "CONFIGURATION SUBDIRECTORIES"
1409 .IP \fIcursors\fR 4
1410 .IX Item "cursors"
1411 May contain cursor icons in the XPM image format. These overrule cursors
1412 provided by a theme. There are 3 direction cursors: \fIleft.xpm\fR,
1413 \&\fIright.xpm\fR, \fImove.xpm\fR, 8 resize cursors: \fIsizeR.xpm\fR, \fIsizeTR.xpm\fR,
1414 \&\fIsizeT.xpm\fR, \fIsizeTL.xpm\fR, \fIsizeL.xpm\fR, \fIsizeBL.xpm\fR, \fIsizeB.xpm\fR,
1415 \&\fIsizeBR.xpm\fR, and 4 scroll cursors: \fIscrollL.xpm\fR, \fIscrollR.xpm\fR,
1416 \&\fIscrollU.xpm\fR, and \fIscrollD.xpm\fR.
1417 .Sp
1418 By default an XPM header defines four dimensions: width, height, colors
1419 and chars\-per\-pixel. For cursors this must be extended to six. The last
1420 two are the \fIx\-hotspot\fR and the \fIy\-hotspot\fR. These define which point
1421 in the XPM image is the sensitive point for the mouse pointer.
1422 .Sp
1423 Instead of XPM images, a theme may use Xcursor files instead.
1424 These then don\*(Aqt have a filename extension.
1425 .Sp
1426 When a theme doesn\*(Aqt define a cursor, icewm falls back to the system
1427 cursor themes for Xcursor, if they are installed. This is configurable
1428 by the following environment variables:
1429 .RS 4
1430 .IP XCURSOR_PATH 4
1431 .IX Item "XCURSOR_PATH"
1432 Where to look for themed cursors.
1433 .IP XCURSOR_SIZE 4
1434 .IX Item "XCURSOR_SIZE"
1435 The cursor size in pixels.
1436 .IP XCURSOR_THEME 4
1437 .IX Item "XCURSOR_THEME"
1438 The name of the cursor theme.
1439 .RE
1440 .RS 4
1441 .Sp
1442 The last two can also be set as an X\-resource:
1443 .Sp
1444 .Vb 2
1445 \& Xcursor.size: 24
1446 \& Xcursor.theme: whiteglass
1447 .Ve
1448 .Sp
1449 Otherwise core X11 cursors are used.
1450 .RE
1451 .IP \fIicons\fR 4
1452 .IX Item "icons"
1453 Contains icons for applications and keyboard layouts. These can be in
1454 XPM, PNG or SVG format. The filename of an \fIapplication icon\fR may
1455 follow a specific naming pattern, like \fIapp_32x32.xpm\fR. They start
1456 with a base name, which usually is just a single word. Then follows
1457 an underscore, followed by a size specification, as in \f(CW\*(C`SIZExSIZE\*(C'\fR.
1458 This is followed by a dot and the file extension, where the extension
1459 denotes the icon image format. Common sizes are 16, 32 and 48.
1460 This depends on the respective \f(CW\*(C`IconSize\*(C'\fR preferences options.
1461 .IP \fIledclock\fR 4
1462 .IX Item "ledclock"
1463 Pictures of digits for the LED clock which is displayed in the
1464 bottom\-right corner of the task bar. These can be seen when the
1465 \&\f(CW\*(C`TaskBarShowClock\*(C'\fR and \f(CW\*(C`TaskBarClockLeds\*(C'\fR options are both set to 1.
1466 .IP \fImailbox\fR 4
1467 .IX Item "mailbox"
1468 Icons that are used to display different states of the mailbox applet
1469 in the task bar. There are five states and each has its own icon:
1470 \&\fImail.xpm\fR, \fInewmail.xpm\fR, \fIunreadmail.xpm\fR, \fInomail.xpm\fR,
1471 \&\fIerrmail.xpm\fR.
1472 .IP \fIsounds\fR 4
1473 .IX Item "sounds"
1474 Audio files that are played by \fBicesound\fR\|(1) on GUI events. These
1475 are: \fIstartup.wav\fR, \fIshutdown.wav\fR, \fIrestart.wav\fR, \fIlaunchApp.wav\fR,
1476 \&\fIworkspaceChange.wav\fR, \fIwindowOpen.wav\fR, \fIwindowClose.wav\fR,
1477 \&\fIdialogOpen.wav\fR, \fIdialogClose.wav\fR, \fIwindowMax.wav\fR,
1478 \&\fIwindowRestore.wav\fR, \fIwindowMin.wav\fR, \fIwindowHide.wav\fR,
1479 \&\fIwindowRollup.wav\fR, \fIwindowMoved.wav\fR, \fIwindowSized.wav\fR,
1480 \&\fIwindowLower.wav\fR.
1481 .IP \fItaskbar\fR 4
1482 .IX Item "taskbar"
1483 Pictures to customize the look of the task bar. These include:
1484 \&\fItaskbarbg.xpm\fR, \fItaskbuttonactive.xpm\fR, \fItaskbuttonbg.xpm\fR,
1485 \&\fItaskbuttonminimized.xpm\fR, \fItoolbuttonbg.xpm\fR,
1486 \&\fIworkspacebuttonactive.xpm\fR, \fIworkspacebuttonbg.xpm\fR.
1487 .IP \fIthemes\fR 4
1488 .IX Item "themes"
1489 A directory to store themes. Each theme is stored in its own
1490 sub\-directory in the \fIthemes\fR directory. A theme contains at least a
1491 \&\fIdefault.theme\fR file, and optionally theme alternatives which are
1492 additional files that have a \fI.theme\fR file name extension and that
1493 contain tweaks of the \fIdefault.theme\fR file.
1494 How to create a theme is explained in the
1495 IceWM Theme Creation Howto.
1496 .IP \fIworkspace\fR 4
1497 .IX Item "workspace"
1498 If \f(CW\*(C`PagerShowPreview\*(C'\fR is disabled, icewm looks in the \f(CW\*(C`workspace\*(C'\fR
1499 directory for images to draw on a workspace button. The image filename
1500 should have the name of the workspace. The image extension is optional.
1501 .SS OPACITY
1502 .IX Subsection "OPACITY"
1503 IceWM supports window opacity and transparency in connection with an
1504 external compositor like \fBcompton\fR\|(1) or \fBpicom\fR\|(1).
1505 If a client window sets the \f(CW\*(C`_NET_WM_WINDOW_OPACITY\*(C'\fR property on
1506 its window, then \fBicewm\fR will copy this to the outer frame window,
1507 where the compositor will read it and adjust the opacity accordingly.
1508 .PP
1509 The opacity can also be set in the \fBicewm\-winoptions\fR\|(5) file.
1510 \&\fBicesh\fR\|(1) can control the opacity level of running applications.
1511 .PP
1512 The _NET_WM_WINDOW_TYPE properties that \fBicewm\fR sets on its windows
1513 are \fIDIALOG\fR, \fINOTIFICATION\fR, \fIPOPUP_MENU\fR and \fITOOLTIP\fR. The output
1514 of \f(CW\*(C`icesh windows\*(C'\fR shows their WM_CLASS values. These can be helpful
1515 to configure compton.
1516 .SS EXAMPLES
1517 .IX Subsection "EXAMPLES"
1518 Examples of the above configuration files can be found in the default
1519 installation path or in the system\-wide defaults. See the output of
1520 \&\f(CW\*(C`icewm \-\-directories\*(C'\fR for their locations.
1521 .SS "CONFORMING TO"
1522 .IX Subsection "CONFORMING TO"
1523 ICCCM 2.0: partial. NetWM/EWMH: extensive.
1524 See the file \fICOMPLIANCE\fR in the distribution for full details.
1525 .SS "SEE ALSO"
1526 .IX Subsection "SEE ALSO"
1527 \&\fBicehelp\fR\|(1),
1528 \&\fBicesh\fR\|(1),
1529 \&\fBicesound\fR\|(1),
1530 \&\fBicewm\-env\fR\|(5),
1531 \&\fBicewm\-focus_mode\fR\|(5),
1532 \&\fBicewm\-keys\fR\|(5),
1533 \&\fBicewm\-menu\fR\|(5),
1534 \&\fBicewm\-menu\-fdo\fR\|(1),
1535 \&\fBicewm\-menu\-xrandr\fR\|(1),
1536 \&\fBicewm\-preferences\fR\|(5),
1537 \&\fBicewm\-prefoverride\fR\|(5),
1538 \&\fBicewm\-programs\fR\|(5),
1539 \&\fBicewm\-session\fR\|(1),
1540 \&\fBicewm\-set\-gnomewm\fR\|(1),
1541 \&\fBicewm\-shutdown\fR\|(5),
1542 \&\fBicewm\-startup\fR\|(5),
1543 \&\fBicewm\-theme\fR\|(5),
1544 \&\fBicewm\-toolbar\fR\|(5),
1545 \&\fBicewm\-winoptions\fR\|(5),
1546 \&\fBicewmbg\fR\|(1),
1547 \&\fBicewmhint\fR\|(1),
1548 \&\fBsetxkbmap\fR\|(1),
1549 \&\fBXorg\fR\|(1),
1550 \&\fBXserver\fR\|(1),
1551 \&\fBxinit\fR\|(1),
1552 \&\fBxprop\fR\|(1),
1553 \&\fBxwininfo\fR\|(1),
1554 \&\fBwmctrl\fR\|(1).
1555 .SS BUGS
1556 .IX Subsection "BUGS"
1557 Please report bugs at <https://github.com/ice\-wm/icewm/issues>.
1558 .SS AUTHOR
1559 .IX Subsection "AUTHOR"
1560 Brian Bidulock <mailto:[email protected]>.
1561 .PP
1562 See \fB\-\-copying\fR for full copyright notice and copying permissions.
1563 .SS LICENSE
1564 .IX Subsection "LICENSE"
1565 \&\fBIceWM\fR is licensed under the GNU Library General Public License.
1566 See the \fICOPYING\fR file in the distribution or use the \fB\-\-copying\fR flag
1567 to display copying permissions.