Debian Codegraph @

upstream/fedora-44/man1/icesh.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 "ICESH 1"
61 .TH ICESH 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 \& icesh \- control window properties and the IceWM window manager
70 .Ve
71 .SS SYNOPSIS
72 .IX Subsection "SYNOPSIS"
73 .IP "\fBicesh\fR \fIOPTIONS|ACTIONS\fR+" 4
74 .IX Item "icesh OPTIONS|ACTIONS+"
75 .SS DESCRIPTION
76 .IX Subsection "DESCRIPTION"
77 \&\fBicesh\fR provides two types of commands:
78 .IP "1. Commands to directly interact with icewm:" 4
79 .IX Item "1. Commands to directly interact with icewm:"
80 These are listed in the section "MANAGER ACTIONS" below.
81 They are easy to use, because they don\*(Aqt require to select one
82 or more windows. For example, \f(CW\*(C`icesh restart\*(C'\fR will restart
83 icewm and \f(CW\*(C`icesh clients\*(C'\fR lists the applications that
84 are managed by icewm.
85 .IP "2. Commands that operate on a selection of windows:" 4
86 .IX Item "2. Commands that operate on a selection of windows:"
87 See the section \f(CW\*(C`WINDOW ACTIONS\*(C'\fR below. For example, \f(CW\*(C`icesh close\*(C'\fR
88 is a request to close a window, but which window? Now icesh
89 will turn the mouse pointer into a crosshair. Click on a window
90 and a close request will be sent to that application.
91 .Sp
92 The power of icesh lies in its ability to programmatically
93 select one or more windows and operate on that selection.
94 This can be used in scripts and in \fBicewm\-keys\fR\|(5)
95 to define your own window management hotkeys. For example, to
96 immediately close all xterm windows do \f(CW\*(C`icesh \-c xterm close\*(C'\fR.
97 .Sp
98 There are a dozen \f(CW\*(C`SELECT OPTIONS\*(C'\fR to select windows. They start
99 with a \*(Aq\-\*(Aq or a \*(Aq+\*(Aq. The \*(Aq\-\*(Aq starts a new selection, while the \*(Aq+\*(Aq
100 adds more windows to an existing selection.
101 .Sp
102 This selection of windows can be reduced by \f(CW\*(C`FILTER OPTIONS\*(C'\fR.
103 These remove unwanted windows from the current selection.
104 Multiple filter options can be given. For example,
105 \&\f(CW\*(C`icesh \-c xterm \-W this close\*(C'\fR will close only those xterms
106 that are shown on the current workspace. The xterms on other
107 workspaces are filtered out by the \f(CW\*(C`\-W this\*(C'\fR filter option.
108 .PP
109 There is no limit to the number of commands, selections, filters
110 and actions that you can give to a single icesh command.
111 They are processed and evaluated one by one from left to right.
112 This makes icesh a small declarative programming language.
113 Have a look at some examples near the end of this document.
114 .SS OPTIONS
115 .IX Subsection "OPTIONS"
116 \&\fBicesh\fR recognizes the following options:
117 .SS "SELECT OPTIONS"
118 .IX Subsection "SELECT OPTIONS"
119 Select options specify the window or windows to which subsequent
120 actions apply. If none is given, but an action does require a window,
121 then a selection crosshair is shown to select the desired window
122 interactively. The manager actions do not require window options.
123 .PP
124 The following options \fIselect\fR one or more client windows.
125 If needed, they can be repeated for successive actions.
126 .IP "\fB\-a\fR, \fB\-all\fR" 4
127 .IX Item "-a, -all"
128 Selects all client windows of the window manager.
129 .IP "\fB\-f\fR, \fB\-focus\fR, \fB+f\fR, \fB+focus\fR" 4
130 .IX Item "-f, -focus, +f, +focus"
131 Selects the application window that is currently focused.
132 The option with minus sign replaces the existing selection with
133 the focused window. With a plus sign the focused window is added to
134 an existing selection.
135 .IP "\fB+g\fR, \fB+group\fR" 4
136 .IX Item "+g, +group"
137 Extend the current selection with client windows that
138 belong to the same application window group.
139 .IP "\fB\-r\fR, \fB\-root\fR, \fB+r\fR, \fB+root\fR" 4
140 .IX Item "-r, -root, +r, +root"
141 Selects the root window.
142 The option with minus sign replaces the existing selection with
143 the root window. With a plus sign the root window is added to
144 an existing selection.
145 .IP "\fB\-s\fR, \fB\-shown\fR" 4
146 .IX Item "-s, -shown"
147 Selects all client windows that are on the current workspace.
148 .IP "\fB\-t\fR, \fB\-top\fR" 4
149 .IX Item "-t, -top"
150 Selects all toplevel windows from the display unconditionally.
151 This includes windows that have never been mapped and windows
152 with the override redirect bit set to evade management.
153 .IP "\fB\-w\fR, \fB\-window\fR, \fB+w\fR, \fB+window\fR \fIWINDOW_ID\fR" 4
154 .IX Item "-w, -window, +w, +window WINDOW_ID"
155 Specifies the identifier of the window, \fIWINDOW_ID\fR, for which the
156 action applies. Special identifiers are \fBroot\fR for the root window
157 and \fBfocus\fR for the currently focused window.
158 The option with minus sign replaces the existing selection.
159 With a plus sign the window is added to an existing selection.
160 .IP "\fB\-x\fR, \fB\-xembed\fR" 4
161 .IX Item "-x, -xembed"
162 Selects all windows that are embedded using the \fIXEMBED\fR protocol.
163 .IP "\fB+c\fR, \fB+class\fR \fICLASS\fR" 4
164 .IX Item "+c, +class CLASS"
165 Extend the current selection with client windows that have a
166 \&\fIWM_CLASS\fR property equal to \fICLASS\fR. This is the resource
167 instance and class name. If \fICLASS\fR contains a period, only
168 windows with exactly the same \fIWM_CLASS\fR property are matched.
169 If there is no period, windows of the same class and windows
170 of the same instance are selected.
171 .IP "\fB+C\fR, \fB+Class\fR" 4
172 .IX Item "+C, +Class"
173 Extend the current selection with client windows that
174 have a \fIWM_CLASS\fR property \fIsimilar\fR to the already
175 selected set of windows.
176 .IP "\fB\-D\fR, \fB\-Dockapps\fR" 4
177 .IX Item "-D, -Dockapps"
178 Selects all Dockapp applications that are managed by icewm.
179 .IP "\fB+P\fR, \fB+Pid\fR" 4
180 .IX Item "+P, +Pid"
181 Extend the current selection with client windows that have
182 the same process identifier as one of the selected windows.
183 .IP \fB\-T\fR 4
184 .IX Item "-T"
185 Selects the IceWM taskbar.
186 .IP "\fB\-A\fR, \fB\-Await\fR" 4
187 .IX Item "-A, -Await"
188 Wait for one or more new client windows to appear and make that the new
189 selection.
190 .SS "FILTER OPTIONS"
191 .IX Subsection "FILTER OPTIONS"
192 The following options \fIfilter\fR the currently selected set of windows.
193 If no previous \fIselect\fR option was given then a \fB\-all\fR option is
194 implicitly assumed to filter all client windows.
195 .IP "\fB\-c\fR, \fB\-class\fR \fICLASS\fR" 4
196 .IX Item "-c, -class CLASS"
197 Filters the set of windows on their \fIWM_CLASS\fR property. This is
198 the resource instance and class name. If \fICLASS\fR contains a period,
199 only windows with exactly the same \fIWM_CLASS\fR property are matched.
200 If there is no period, windows of the same class and windows of the
201 same instance (aka. \fI\-name\fR) are selected.
202 .IP "\fB\-l\fR, \fB\-last\fR" 4
203 .IX Item "-l, -last"
204 Filter clients and keep only the most recent client.
205 .IP "\fB\-m\fR, \fB\-machine\fR \fIHOST\fR" 4
206 .IX Item "-m, -machine HOST"
207 Filters clients by host name. Clients with a WM_CLIENT_MACHINE property
208 equal to \fIHOST\fR are selected.
209 .IP "\fB\-n\fR, \fB\-name\fR \fINAME\fR" 4
210 .IX Item "-n, -name NAME"
211 Filters clients by _NET_WM_NAME or WM_NAME.
212 \&\fINAME\fR matches any part of the property value.
213 To match at the beginning use a \f(CW\*(C`^\*(C'\fR prefix.
214 To match at the end use a \f(CW\*(C`$\*(C'\fR suffix.
215 .IP "\fB\-p\fR, \fB\-pid\fR \fIPID\fR" 4
216 .IX Item "-p, -pid PID"
217 Filters clients by process ID. Clients are selected that have
218 a process ID of \fIPID\fR, when libXRes is at version 1.2, or
219 that have a _NET_WM_PID property equal to \fIPID\fR.
220 .IP "\fB\-u\fR, \fB\-unmapped\fR" 4
221 .IX Item "-u, -unmapped"
222 Filter clients and keep those that are currently not viewable.
223 These are hidden, minimized, rolled\-up, or on another workspace.
224 .IP "\fB\-v\fR, \fB\-viewable\fR" 4
225 .IX Item "-v, -viewable"
226 Filter clients and keep only those that are currently viewable.
227 These clients are mapped on the current workspace.
228 .IP "\fB\-k\fR, \fB\-kovered\fR" 4
229 .IX Item "-k, -kovered"
230 Filter clients and keep only those that are currently viewable and
231 that are at least partially covered by another viewable window.
232 .IP "\fB\-G\fR, \fB\-Gravity\fR \fIGRAVITY\fR" 4
233 .IX Item "-G, -Gravity GRAVITY"
234 Filters clients by the window gravity field of the WM_NORMAL_HINTS
235 property. Clients with a gravity equal to \fIGRAVITY\fR are selected.
236 If \fIGRAVITY\fR starts with an exclamation mark then the filtering is
237 inverted.
238 .IP "\fB\-L\fR, \fB\-Layer\fR \fILAYER\fR" 4
239 .IX Item "-L, -Layer LAYER"
240 Filters clients by \fIGNOME window layer\fR, which can either be a layer
241 name or a layer number. See EXPRESSIONS below. If \fILAYER\fR starts with
242 an exclamation mark then the filtering is inverted.
243 .IP "\fB\-N\fR, \fB\-Netstate\fR \fISTATE\fR" 4
244 .IX Item "-N, -Netstate STATE"
245 Filters clients by \fIEWMH window state\fR. Clients that have at
246 least an EWMH window state of \fISTATE\fR are selected. This state
247 refers to details like \fBMINIZED\fR or \fBMAXIMIZED\fR. See EXPRESSIONS
248 below. If \fISTATE\fR starts with an exclamation mark then the filtering
249 is inverted. A question mark \f(CW\*(C`?\*(C'\fR filters clients with any bit set
250 in \fISTATE\fR.
251 .IP "\fB\-P\fR, \fB\-Property\fR \fIPROP[=value]\fR" 4
252 .IX Item "-P, -Property PROP[=value]"
253 Filters clients by property. Clients that have a property \fIPROP\fR
254 are selected. If the optional \fIvalue\fR is given, the match succeeds
255 only if \fIPROP\fR is a string, window, cardinal, or atom, with a value
256 equal to \fIvalue\fR. The filtering is inverted if \fIPROP\fR starts with
257 an exclamation mark.
258 .IP "\fB\-R\fR, \fB\-Role\fR \fIROLE\fR" 4
259 .IX Item "-R, -Role ROLE"
260 Filters clients by WM_WINDOW_ROLE. Clients that have a WM_WINDOW_ROLE
261 property value equal to \fIROLE\fR are selected. The filtering is inverted
262 if \fIROLE\fR starts with an exclamation mark.
263 .IP "\fB\-W\fR, \fB\-Workspace\fR \fIWORKSPACE\fR" 4
264 .IX Item "-W, -Workspace WORKSPACE"
265 Filter clients by workspace. Workspace \fIWORKSPACE\fR is either a
266 workspace name, or a workspace number counting from zero, or the word
267 \&\f(CW\*(C`this\*(C'\fR for the current workspace, or the word \f(CW\*(C`All\*(C'\fR for all workspaces.
268 If \fIWORKSPACE\fR starts with an exclamation mark then the filtering is
269 inverted.
270 .IP "\fB\-X\fR, \fB\-Xinerama\fR \fIMONITOR\fR" 4
271 .IX Item "-X, -Xinerama MONITOR"
272 Limit clients by \fIRandR\fR/\fIXinerama\fR monitor. Only operate on
273 clients that are displayed on \fIMONITOR\fR, where \fIMONITOR\fR can
274 be \f(CW\*(C`All\*(C'\fR for all monitors, \f(CW\*(C`this\*(C'\fR for the monitor where the
275 active window is displayed, or a monitor number starting from zero.
276 See the output of \f(CW\*(C`randr\*(C'\fR or \f(CW\*(C`xinerama\*(C'\fR below.
277 .IP "\fB\-Z\fR, \fB\-Zerminal\fR" 4
278 .IX Item "-Z, -Zerminal"
279 Keep only terminals: clients that have forked a shell.
280 .SS "GENERAL OPTIONS"
281 .IX Subsection "GENERAL OPTIONS"
282 The following options are identical for every IceWM command.
283 .IP "\fB\-d\fR, \fB\-display\fR \fIDISPLAY\fR" 4
284 .IX Item "-d, -display DISPLAY"
285 Specifies the X11 DISPLAY. If unspecified, defaults to \fR\f(CB$DISPLAY\fR\fB\fR.
286 .IP "\fB\-h\fR, \fB\-\-help\fR" 4
287 .IX Item "-h, --help"
288 Print a brief usage statement to \fIstdout\fR and exit.
289 .IP "\fB\-V\fR, \fB\-\-version\fR" 4
290 .IX Item "-V, --version"
291 Print the program version to \fIstdout\fR and exit.
292 .IP "\fB\-C\fR, \fB\-\-copying\fR" 4
293 .IX Item "-C, --copying"
294 Print copying permissions to \fIstdout\fR for the program and exit.
295 .IP "\fB\-q\fR, \fB\-\-quiet\fR" 4
296 .IX Item "-q, --quiet"
297 Don\*(Aqt complain if no matching windows could be found.
298 .SS ACTIONS
299 .IX Subsection "ACTIONS"
300 \&\fBicesh\fR expects one or more action arguments. There are two kinds of
301 actions: \fIwindow actions\fR and \fImanager actions\fR. The first operates on
302 the selected windows. The second directly interacts with the \fBicewm\fR
303 window manager.
304 .SS "WINDOW ACTIONS"
305 .IX Subsection "WINDOW ACTIONS"
306 The following actions affect the selected window or windows.
307 .IP \fBactivate\fR 4
308 .IX Item "activate"
309 Activate the window, aka. \fIto focus\fR.
310 .IP \fBclose\fR 4
311 .IX Item "close"
312 Send a close request to the client that created the window.
313 .IP \fBkill\fR 4
314 .IX Item "kill"
315 Force an immediate close down of the client that created the window.
316 .IP \fBid\fR 4
317 .IX Item "id"
318 Print window identifiers for the selected windows.
319 .IP \fBpid\fR 4
320 .IX Item "pid"
321 Print process identifiers for the selected windows.
322 .IP \fBlist\fR 4
323 .IX Item "list"
324 Show window details, like geometry and names.
325 .IP \fBlower\fR 4
326 .IX Item "lower"
327 Lower the window.
328 .IP \fBraise\fR 4
329 .IX Item "raise"
330 Raise the window.
331 .IP \fBabove\fR 4
332 .IX Item "above"
333 Stack the window above others.
334 .IP \fBbelow\fR 4
335 .IX Item "below"
336 Stack the window below others.
337 .IP \fBrollup\fR 4
338 .IX Item "rollup"
339 Rollup the specified window.
340 .IP \fBfullscreen\fR 4
341 .IX Item "fullscreen"
342 Set the window to fullscreen.
343 .IP \fBmaximize\fR 4
344 .IX Item "maximize"
345 Maximize the window.
346 .IP \fBhorizontal\fR 4
347 .IX Item "horizontal"
348 Maximize the window only horizontally.
349 .IP \fBvertical\fR 4
350 .IX Item "vertical"
351 Maximize the window only vertically.
352 .IP \fBminimize\fR 4
353 .IX Item "minimize"
354 Minimize the window.
355 .IP \fBrestore\fR 4
356 .IX Item "restore"
357 Restore the window to normal and clear urgency.
358 .IP \fBhide\fR 4
359 .IX Item "hide"
360 Hide the window.
361 .IP \fBunhide\fR 4
362 .IX Item "unhide"
363 Reveal the window.
364 .IP \fBskip\fR 4
365 .IX Item "skip"
366 Don\*(Aqt show the window on the taskbar.
367 .IP \fBunskip\fR 4
368 .IX Item "unskip"
369 Do show the window on the taskbar.
370 .IP \fBsticky\fR 4
371 .IX Item "sticky"
372 Show the window on all workspaces.
373 .IP \fBunsticky\fR 4
374 .IX Item "unsticky"
375 Show the window on just one workspace.
376 .IP \fBurgent\fR 4
377 .IX Item "urgent"
378 Set the urgency flag to flash the task button.
379 .IP "\fBresize\fR \fIWIDTH\fR \fIHEIGHT\fR" 4
380 .IX Item "resize WIDTH HEIGHT"
381 Resize window to \fIWIDTH\fR by \fIHEIGHT\fR window units. For text based
382 applications like terminals, a window unit is the size of a single
383 character cell.
384 .IP "\fBsizeto\fR \fIWIDTH\fR \fIHEIGHT\fR" 4
385 .IX Item "sizeto WIDTH HEIGHT"
386 Resize window to \fIWIDTH\fR by \fIHEIGHT\fR pixels. If \fIWIDTH\fR or \fIHEIGHT\fR
387 ends with a percent sign \f(CW\*(C`%\*(C'\fR, then they refer to a percentage of the
388 desktop work area. For instance, \f(CW\*(C`sizeto 50% 100%\*(C'\fR resizes to half
389 the desktop width and whatever height is available above or below the
390 taskbar.
391 .IP "\fBsizeby\fR \fIWIDTH\fR \fIHEIGHT\fR" 4
392 .IX Item "sizeby WIDTH HEIGHT"
393 Resize window by \fIWIDTH\fR by \fIHEIGHT\fR pixels. If \fIWIDTH\fR or \fIHEIGHT\fR
394 ends with a percent sign \f(CW\*(C`%\*(C'\fR, then they refer to a percentage of the
395 current window size. For instance, \f(CW\*(C`sizeby 50% 200\*(C'\fR increases the width
396 by 50% and increases the height by 200 pixels.
397 .IP "\fBmove\fR \fIX\fR \fIY\fR" 4
398 .IX Item "move X Y"
399 Move the selected window or windows to the screen position \fIX\fR \fIY\fR.
400 To specify \fIX\fR or \fIY\fR values relative to the right side or bottom side
401 precede the value with an extra minus sign, like in \f(CW\*(C`move \-+10 \-\-20\*(C'\fR.
402 When \fIX\fR or \fIY\fR end with a percent sign \f(CW\*(C`%\*(C'\fR, they refer to a percentage
403 of the desktop work area.
404 .IP "\fBmoveby\fR \fIX\fR \fIY\fR" 4
405 .IX Item "moveby X Y"
406 Displace window by \fIX\fR \fIY\fR pixels.
407 .IP \fBcenter\fR 4
408 .IX Item "center"
409 Position the window in the center of the desktop work area.
410 .IP \fBleft\fR 4
411 .IX Item "left"
412 Position the window against the left side of the desktop work area.
413 .IP \fBright\fR 4
414 .IX Item "right"
415 Position the window against the right side of the desktop work area.
416 .IP \fBtop\fR 4
417 .IX Item "top"
418 Position the window against the top side of the desktop work area.
419 .IP \fBbottom\fR 4
420 .IX Item "bottom"
421 Position the window against the bottom side of the desktop work area.
422 .IP "\fBsetIconTitle\fR \fITITLE\fR" 4
423 .IX Item "setIconTitle TITLE"
424 Set the icon title to \fITITLE\fR.
425 .IP \fBgetIconTitle\fR 4
426 .IX Item "getIconTitle"
427 Print the icon title.
428 .IP "\fBsetWindowTitle\fR \fITITLE\fR" 4
429 .IX Item "setWindowTitle TITLE"
430 Set the window title to \fITITLE\fR.
431 .IP \fBgetWindowTitle\fR 4
432 .IX Item "getWindowTitle"
433 Print the window title.
434 .IP "\fBsetGeometry\fR \fIGEOMETRY\fR" 4
435 .IX Item "setGeometry GEOMETRY"
436 Set the window geometry to \fIGEOMETRY\fR. This geometry should be
437 specified in a format that can be parsed by \fBXParseGeometry\fR\|(3).
438 Negative offsets are with respect to the bottom or right side of
439 the screen. Use \f(CW\*(C`+\-\*(C'\fR for a truly negative position.
440 .IP \fBgetGeometry\fR 4
441 .IX Item "getGeometry"
442 Print the window geometry.
443 .IP "\fBsetClass\fR \fICLASS\fR" 4
444 .IX Item "setClass CLASS"
445 Set the resource name and class to \fICLASS\fR, which should be a resource
446 name and a resource class connected by a dot. To preserve either the
447 existing name or class, use a percentage sign for that part.
448 .IP \fBgetClass\fR 4
449 .IX Item "getClass"
450 Print the resource name and class.
451 .IP "\fBnetState\fR \fI[STATE]\fR" 4
452 .IX Item "netState [STATE]"
453 If \fISTATE\fR is omitted then it shows the \fIEWMH window state\fR.
454 If \fISTATE\fR starts with a \f(CW\*(C`+\*(C'\fR then flags in \fISTATE\fR are appended to
455 the existing \fIEWMH window state\fR. If \fISTATE\fR starts with a \f(CW\*(C`\-\*(C'\fR
456 then flags in \fISTATE\fR are removed from the existing \fIEWMH window
457 state\fR. If \fISTATE\fR starts with a \f(CW\*(C`^\*(C'\fR then flags in \fISTATE\fR are
458 toggled with respect to the existing \fIEWMH window state\fR.
459 If \fISTATE\fR starts with a \f(CW\*(C`=\*(C'\fR then the \fIEWMH window state\fR
460 is set to \fISTATE\fR. See EXPRESSIONS below. A list of \fIEWMH flags\fR
461 can be found in the output of \f(CW\*(C`icesh symbols\*(C'\fR.
462 .IP "\fBsetLayer\fR \fILAYER\fR" 4
463 .IX Item "setLayer LAYER"
464 Move the specified window to another \fIwindow layer\fR.
465 See EXPRESSIONS below for a list of \fILAYER\fR symbols.
466 .IP \fBgetLayer\fR 4
467 .IX Item "getLayer"
468 Print the \fIwindow layer\fR for the specified window.
469 .IP "\fBsetWorkspace\fR \fIWORKSPACE\fR" 4
470 .IX Item "setWorkspace WORKSPACE"
471 Move the specified window to another workspace. Select the root
472 window to change the current workspace. If \fIWORKSPACE\fR is \f(CW\*(C`All\*(C'\fR
473 then the specified window becomes visible on all workspaces.
474 Specify \f(CW\*(C`this\*(C'\fR for the current workspace, \f(CW\*(C`next\*(C'\fR for the subsequent
475 workspace or \f(CW\*(C`prev\*(C'\fR for the preceding workspace.
476 .IP \fBgetWorkspace\fR 4
477 .IX Item "getWorkspace"
478 Print the workspace for the specified window.
479 .IP "\fBopacity\fR [\fIOPACITY\fR]" 4
480 .IX Item "opacity [OPACITY]"
481 Print the window opacity if \fIOPACITY\fR is not given,
482 otherwise set the window opacity to \fIOPACITY\fR.
483 .IP "\fBsetTrayOption\fR \fITRAYOPTION\fR" 4
484 .IX Item "setTrayOption TRAYOPTION"
485 Set the \fIIceWM tray option\fR for the specified window to \fITRAYOPTION\fR.
486 See \fIIceWM tray options\fR, below, for \fITRAYOPTION\fR symbols.
487 .IP \fBgetTrayOption\fR 4
488 .IX Item "getTrayOption"
489 Print the \fIIceWM tray option\fR for the specified window.
490 .IP "\fBsetNormalGravity\fR \fIGRAVITY\fR" 4
491 .IX Item "setNormalGravity GRAVITY"
492 Set the window gravity field in the WM_NORMAL_HINTS property for the
493 specified window to \fIGRAVITY\fR. See below for \fIGRAVITY\fR symbols.
494 .IP \fBgetNormalGravity\fR 4
495 .IX Item "getNormalGravity"
496 Print the window gravity from the WM_NORMAL_HINTS property for the
497 specified window.
498 .IP "\fBsetWindowGravity\fR \fIGRAVITY\fR" 4
499 .IX Item "setWindowGravity GRAVITY"
500 Set the window gravity for the specified window to \fIGRAVITY\fR.
501 See below for \fIGRAVITY\fR symbols.
502 .IP \fBgetWindowGravity\fR 4
503 .IX Item "getWindowGravity"
504 Print the window gravity for the specified window.
505 .IP "\fBsetBitGravity\fR \fIGRAVITY\fR" 4
506 .IX Item "setBitGravity GRAVITY"
507 Set the bit gravity> for the specified window to \fIGRAVITY\fR.
508 See below for \fIGRAVITY\fR symbols.
509 .IP \fBgetBitGravity\fR 4
510 .IX Item "getBitGravity"
511 Print the bit gravity for the specified window.
512 .IP "\fBmotif\fR [\fBfuncs\fR \fIFUNCTIONS\fR | \fBdecor\fR \fIDECORATIONS\fR | \fBremove\fR]" 4
513 .IX Item "motif [funcs FUNCTIONS | decor DECORATIONS | remove]"
514 Query, set or modify the \f(CW\*(C`_MOTIF_WM_HINTS\*(C'\fR property for the specified
515 window. Without arguments \fBmotif\fR will show the current value, but
516 only if the window has such a property. The property can be removed or
517 reset with the \fBremove\fR argument. With \fBfuncs\fR and \fBdecor\fR individual
518 fields of this property can be enabled or disabled. If \fIFUNCTIONS\fR or
519 \&\fIDECORATIONS\fR starts with a minus or plus sign then the existing value
520 is modified, otherwise it is set to the new value. Note that if \f(CW\*(C`All\*(C'\fR
521 is set, other set fields are disabled and cleared fields are enabled.
522 .IP \fBborderless\fR 4
523 .IX Item "borderless"
524 Hide the frame borders and title.
525 .IP \fBbordered\fR 4
526 .IX Item "bordered"
527 Show the frame borders and title.
528 .IP \fBdenormal\fR 4
529 .IX Item "denormal"
530 Remove the WM_NORMAL_HINTS property, if it exists. This lifts
531 font\-size restrictions on resizing, especially for terminals.
532 .IP "\fBprop\fR \fIPROPERTY\fR" 4
533 .IX Item "prop PROPERTY"
534 Print the value of property \fIPROPERTY\fR, if it is present.
535 .IP \fBproperties\fR 4
536 .IX Item "properties"
537 Print all properties and their values.
538 .IP \fBframe\fR 4
539 .IX Item "frame"
540 Print the identifier of the window frame.
541 .IP \fBextents\fR 4
542 .IX Item "extents"
543 Print the window identifier and the frame border sizes: left, right,
544 top and bottom.
545 .IP \fBfocusmodel\fR 4
546 .IX Item "focusmodel"
547 Print the ICCCM focus model as advertised by the client window.
548 This is either Locally, Passive, Globally or NoInput.
549 .IP "\fBoverride\fR [\fI0|1\fR]" 4
550 .IX Item "override [0|1]"
551 Print the override redirect status for the window, or if either 0 or 1
552 is given, then disable or enable the override redirect status.
553 .IP "\fBtabto\fR \fIlabel\fR" 4
554 .IX Item "tabto label"
555 Move the windows as tabs to a frame that has \f(CW\*(C`frame\*(C'\fR label \fIlabel\fR.
556 Such a frame is created if needed.
557 .IP \fBuntab\fR 4
558 .IX Item "untab"
559 Move each window to its own frame, if it is currently tabbed.
560 .IP "\fBloadicon\fR \fIimage.pam\fR" 4
561 .IX Item "loadicon image.pam"
562 Load an icon from file, which must be in the PAM image format,
563 with dimensions at most 256, a depth of 4, and type \fIRGB_ALPHA\fR.
564 .IP "\fBsaveicon\fR \fIfile000.pam\fR" 4
565 .IX Item "saveicon file000.pam"
566 Save an icon to a new file in the PAM image format. Digits are
567 increased to generate a unique new filename for each window.
568 The window must have a \fI_NET_WM_ICON\fR property.
569 .IP \fBusertime\fR 4
570 .IX Item "usertime"
571 Show the time of last user interaction in milliseconds.
572 .IP "\fBclick\fR \fIwindow\-x\fR \fIwindow\-y\fR \fIbutton\fR" 4
573 .IX Item "click window-x window-y button"
574 Send a button press and release event at position (\fIwindow\-x\fR,
575 \&\fIwindow\-y\fR). A negative position is relative to the bottom right
576 corner. The mouse pointer is warped to the position before sending
577 the events. The button number should be between 1 and 5 inclusive.
578 .IP "\fBmonitors\fR \fItop\fR \fIbottom\fR \fIleft\fR \fIright\fR" 4
579 .IX Item "monitors top bottom left right"
580 This sets the monitors to use for fullscreen.
581 Top, bottom, left, and right are indices of the \fIicesh xinerama\fR command.
582 .IP \fBspy\fR 4
583 .IX Item "spy"
584 Observe the selected windows and report any changes. This includes
585 focus, visibility, position, size and all window properties.
586 To monitor all of the protocol request messages that client applications
587 may send to icewm, also spy on the root window.
588 .IP \fBstacking\fR 4
589 .IX Item "stacking"
590 Sort the list of windows from topmost to bottom\-most.
591 .IP \fBreverse\fR 4
592 .IX Item "reverse"
593 Reverse the order of the list of windows.
594 .IP \fBswitchmenu\fR 4
595 .IX Item "switchmenu"
596 Output the list as a menu for icewm\*(Aqs QuickSwitch. This action is to be
597 used in a \fBswitchkey\fR directive in the \f(CW\*(C`keys\*(C'\fR file.
598 .IP "\fBprint\fR \fIformat\fR" 4
599 .IX Item "print format"
600 For each window in the selection, print a line according to \fIformat\fR.
601 Here common backslash\-escapes are recognized as well as the following
602 percent formatting options:
603 .RS 4
604 .IP \fB%\fR 4
605 .IX Item "%"
606 A literal percent sign.
607 .IP \fBh\fR 4
608 .IX Item "h"
609 The window height.
610 .IP \fBw\fR 4
611 .IX Item "w"
612 The window width.
613 .IP \fBx\fR 4
614 .IX Item "x"
615 The window x\-position.
616 .IP \fBy\fR 4
617 .IX Item "y"
618 The window y\-position.
619 .IP \fBg\fR 4
620 .IX Item "g"
621 The window geometry.
622 .IP \fBi\fR 4
623 .IX Item "i"
624 The window identifying handle.
625 .IP \fBo\fR 4
626 .IX Item "o"
627 An icon name.
628 .IP \fBp\fR 4
629 .IX Item "p"
630 The process\-ID of the window application.
631 .IP \fBc\fR 4
632 .IX Item "c"
633 The WM_CLASS property of the window.
634 .IP \fBm\fR 4
635 .IX Item "m"
636 The WM_CLIENT_MACHINE property of the window.
637 .IP \fBt\fR 4
638 .IX Item "t"
639 The window title.
640 .IP \fBW\fR 4
641 .IX Item "W"
642 The current workspace of the window.
643 .RE
644 .RS 4
645 .Sp
646 Each percent format option may start with a minus sign for
647 left\-alignment and have a numeric field width.
648 .RE
649 .SS "MANAGER ACTIONS"
650 .IX Subsection "MANAGER ACTIONS"
651 The following actions control the IceWM window manager and therefore
652 do not require a window \fIselect\fR or \fIfilter\fR option:
653 .IP \fBlistWorkspaces\fR 4
654 .IX Item "listWorkspaces"
655 List the names of all workspaces.
656 .IP \fBcurrent\fR 4
657 .IX Item "current"
658 Show the number and name of the current workspace.
659 .IP "\fBgoto\fR \fIWORKSPACE\fR" 4
660 .IX Item "goto WORKSPACE"
661 Change the current workspace to \fIWORKSPACE\fR. Specify \f(CW\*(C`next\*(C'\fR for the
662 subsequent workspace or \f(CW\*(C`prev\*(C'\fR for the preceding workspace.
663 .IP "\fBworkspaces\fR [\fICOUNT\fR]" 4
664 .IX Item "workspaces [COUNT]"
665 Print the number of workspaces if \fICOUNT\fR is not given,
666 otherwise set the number of workspaces to \fICOUNT\fR.
667 .IP "\fBgetWorkspaceName\fR \fIINDEX\fR" 4
668 .IX Item "getWorkspaceName INDEX"
669 Print the name of workspace \fIINDEX\fR, where \fIINDEX\fR is
670 a workspace number starting from zero.
671 .IP \fBgetWorkspaceNames\fR 4
672 .IX Item "getWorkspaceNames"
673 Print the name of all workspaces, one per line of output.
674 .IP "\fBsetWorkspaceName\fR \fIINDEX\fR \fINAME\fR" 4
675 .IX Item "setWorkspaceName INDEX NAME"
676 Change the name of the workspace \fIINDEX\fR to \fINAME\fR, where \fIINDEX\fR is
677 a workspace number starting from zero.
678 .IP "\fBsetWorkspaceNames\fR \fINAME\fR [\fINAME\fR]*" 4
679 .IX Item "setWorkspaceNames NAME [NAME]*"
680 Change the workspace names to the list of \fINAME\fRs.
681 .IP "\fBaddWorkspace\fR \fINAME\fR" 4
682 .IX Item "addWorkspace NAME"
683 Create a new workspace with name \fINAME\fR.
684 .IP "\fBdesktop\fR [\fISHOWING\fR]" 4
685 .IX Item "desktop [SHOWING]"
686 If \fISHOWING\fR is \f(CW1\fR then set \f(CW\*(C`showing the desktop\*(C'\fR mode.
687 If \fISHOWING\fR is \f(CW0\fR then turn off \f(CW\*(C`showing the desktop\*(C'\fR.
688 Print the current mode if \fISHOWING\fR is not given.
689 .IP \fBworkarea\fR 4
690 .IX Item "workarea"
691 Print the dimensions of the work area for the current workspace.
692 This is the desktop, but minus space occupied by dock and panel windows.
693 .IP \fBrandr\fR 4
694 .IX Item "randr"
695 Summarize the \fIRandR\fR configuration.
696 .IP \fBxinerama\fR 4
697 .IX Item "xinerama"
698 Summarize the \fIXinerama\fR configuration.
699 .IP \fBcheck\fR 4
700 .IX Item "check"
701 Print information about the current window manager, like name,
702 version, class, locale, command, host name and pid.
703 .IP \fBclients\fR 4
704 .IX Item "clients"
705 List all managed client windows, their titles and geometries.
706 .IP \fBshown\fR 4
707 .IX Item "shown"
708 List all mapped client windows for the current desktop,
709 their titles and geometries.
710 .IP \fBwindows\fR 4
711 .IX Item "windows"
712 List all toplevel windows, their titles and geometries.
713 .IP \fBsystray\fR 4
714 .IX Item "systray"
715 List applications that are managed by the IceWM system tray.
716 .IP \fBxembed\fR 4
717 .IX Item "xembed"
718 List application windows that are embedded using the \fIXEMBED\fR protocol.
719 This is another way to discover system tray applications.
720 .IP \fBlogout\fR 4
721 .IX Item "logout"
722 Let icewm execute the \f(CW\*(C`LogoutCommand\*(C'\fR.
723 .IP \fBreboot\fR 4
724 .IX Item "reboot"
725 Let icewm execute the \f(CW\*(C`RebootCommand\*(C'\fR.
726 .IP \fBshutdown\fR 4
727 .IX Item "shutdown"
728 Let icewm execute the \f(CW\*(C`ShutdownCommand\*(C'\fR.
729 .IP \fBcancel\fR 4
730 .IX Item "cancel"
731 Let icewm cancel the logout/reboot/shutdown.
732 .IP \fBabout\fR 4
733 .IX Item "about"
734 Let icewm show the about window.
735 .IP \fBwindowlist\fR 4
736 .IX Item "windowlist"
737 Let icewm show the window list window.
738 .IP \fBrestart\fR 4
739 .IX Item "restart"
740 Let icewm restart itself.
741 .IP \fBsuspend\fR 4
742 .IX Item "suspend"
743 Let icewm execute the \f(CW\*(C`SuspendCommand\*(C'\fR.
744 .IP \fBhibernate\fR 4
745 .IX Item "hibernate"
746 Let icewm execute the \f(CW\*(C`HibernateCommand\*(C'\fR.
747 .IP \fBwinoptions\fR 4
748 .IX Item "winoptions"
749 Let icewm reload the \f(CW\*(C`winoptions\*(C'\fR.
750 This only affects new windows.
751 .IP \fBkeys\fR 4
752 .IX Item "keys"
753 Let icewm reload the \f(CW\*(C`keys\*(C'\fR file.
754 .IP \fBtoolbar\fR 4
755 .IX Item "toolbar"
756 Let icewm reload the \f(CW\*(C`toolbar\*(C'\fR file.
757 .IP \fBrefresh\fR 4
758 .IX Item "refresh"
759 Let icewm refresh the desktop background.
760 .IP \fBguievents\fR 4
761 .IX Item "guievents"
762 Monitor the \fBICEWM_GUI_EVENT\fR property and report all changes.
763 Hit \f(CW\*(C`Ctrl+C\*(C'\fR to abort this and continue with the next command.
764 .IP "\fBdelay\fR [\fItime\fR]" 4
765 .IX Item "delay [time]"
766 Stop execution for \fItime\fR or 0.1 seconds.
767 .IP "\fBrunonce\fR \fIprogram\fR [\fIarguments...\fR]" 4
768 .IX Item "runonce program [arguments...]"
769 This action is meant to be used together with the \fB\-class\fR option.
770 Only if no window is matched by \fIWM_CLASS\fR then
771 \&\fIprogram\fR [\fIarguments...\fR] is executed.
772 .IP "\fBloop\fR [\fIcount\fR]" 4
773 .IX Item "loop [count]"
774 Loop back to the beginning of the command and repeat. The optional
775 \&\fIcount\fR limits the number of repetitions.
776 .IP \fBpick\fR 4
777 .IX Item "pick"
778 Choose a window by a mouse button click.
779 .IP \fBx11time\fR 4
780 .IX Item "x11time"
781 Show the current X11 server time in milliseconds.
782 .IP \fBsync\fR 4
783 .IX Item "sync"
784 Synchronize with the IceWM window manager. That is, wait for icewm to
785 process all previous actions.
786 .IP \fBsymbols\fR 4
787 .IX Item "symbols"
788 List all named symbols.
789 .SS CONDITIONALS
790 .IX Subsection "CONDITIONALS"
791 Icesh supports \f(CW\*(C`if\-then\-else\*(C'\fR expressions. The full syntax is:
792 .PP
793 .Vb 9
794 \& if selection
795 \& then
796 \& actions
797 \& elif selection
798 \& then
799 \& actions
800 \& else
801 \& actions
802 \& end
803 .Ve
804 .PP
805 Where \f(CW\*(C`selection\*(C'\fR is a sequence of selection and filtering options,
806 which evaluates to \fBtrue\fR when it is non\-empty. That is, if one or more
807 windows fulfilled the condition. If it is empty, then its \f(CW\*(C`actions\*(C'\fR
808 clause is ignored and the subsequent \f(CW\*(C`elif\*(C'\fR or \f(CW\*(C`else\*(C'\fR clause is tried
809 or taken. Each clause is optional.
810 .PP
811 Whenever a selection condition evaluates to \fBfalse\fR, the window selection
812 that existed before the \f(CW\*(C`if\*(C'\fR clause is immediately restored. This also
813 happens after an \f(CW\*(C`end\*(C'\fR clause.
814 .SS EXPRESSIONS
815 .IX Subsection "EXPRESSIONS"
816 Some of the window actions require one or two \fIEXPRESSION\fR arguments.
817 .ie n .IP "\fBEXPRESSION\fR ::= \fISYMBOL\fR | \fIEXPRESSION\fR { ""+"" | ""|"" | ""\-"" } \fISYMBOL\fR" 4
818 .el .IP "\fBEXPRESSION\fR ::= \fISYMBOL\fR | \fIEXPRESSION\fR { \f(CW+\fR | \f(CW|\fR | \f(CW\-\fR } \fISYMBOL\fR" 4
819 .IX Item "EXPRESSION ::= SYMBOL | EXPRESSION { + | | | - } SYMBOL"
820 .PP
821 This says that an expression is either a \fISYMBOL\fR or an expression
822 which is combined with an operator to a \fISYMBOL\fR. In other words,
823 an expression is a sequence of symbols, which are combined using
824 operators, where an operator may be a plus, a vertical bar or a minus.
825 .PP
826 Each \fISYMBOL\fR may be either a number or a named symbol from one of the
827 following applicable domains, depending upon the context in which it is
828 used:
829 .IP "\fIWindow layer\fR" 4
830 .IX Item "Window layer"
831 Named symbols of the domain \fIWindow layer\fR (numeric range: 0\-15):
832 .Sp
833 .Vb 9
834 \& Desktop (0)
835 \& Below (2)
836 \& Normal (4)
837 \& OnTop (6)
838 \& Dock (8)
839 \& AboveDock (10)
840 \& Menu (12)
841 \& Fullscreen (14)
842 \& AboveAll (15)
843 .Ve
844 .Sp
845 These symbols are used with the \fILAYER\fR argument to the \f(CW\*(C`setLayer\*(C'\fR
846 action.
847 .IP "\fIIceWM tray option\fR" 4
848 .IX Item "IceWM tray option"
849 Named symbols of the domain \fIIceWM tray option\fR (numeric range: 0\-2):
850 .Sp
851 .Vb 3
852 \& Ignore (0)
853 \& Minimized (1)
854 \& Exclusive (2)
855 .Ve
856 .Sp
857 These symbols are used with the \fITRAYOPTION\fR argument to the
858 \&\f(CW\*(C`setTrayOption\*(C'\fR action.
859 .IP "\fIGravity symbols\fR" 4
860 .IX Item "Gravity symbols"
861 Named symbols for window and bit gravity (numeric range: 0\-10):
862 .Sp
863 .Vb 11
864 \& ForgetGravity (0)
865 \& NorthWestGravity (1)
866 \& NorthGravity (2)
867 \& NorthEastGravity (3)
868 \& WestGravity (4)
869 \& CenterGravity (5)
870 \& EastGravity (6)
871 \& SouthWestGravity (7)
872 \& SouthGravity (8)
873 \& SouthEastGravity (9)
874 \& StaticGravity (10)
875 .Ve
876 .IP "\fIMotif functions\fR" 4
877 .IX Item "Motif functions"
878 .Vb 6
879 \& All (1)
880 \& Resize (2)
881 \& Move (4)
882 \& Minimize (8)
883 \& Maximize (16)
884 \& Close (32)
885 .Ve
886 .IP "\fIMotif decorations\fR" 4
887 .IX Item "Motif decorations"
888 .Vb 7
889 \& All (1)
890 \& Border (2)
891 \& Resize (4)
892 \& Title (8)
893 \& Menu (16)
894 \& Minimize (32)
895 \& Maximize (64)
896 .Ve
897 .IP "\fIEWMH window state symbols\fR" 4
898 .IX Item "EWMH window state symbols"
899 Named symbols of the domain \fIEWMH state\fR (numeric range:
900 0\-8191):
901 .Sp
902 .Vb 10
903 \& ABOVE (1)
904 \& BELOW (2)
905 \& DEMANDS_ATTENTION (4)
906 \& FOCUSED (8)
907 \& FULLSCREEN (16)
908 \& HIDDEN (32)
909 \& MAXIMIZED_HORZ (64)
910 \& MAXIMIZED_VERT (128)
911 \& MODAL (256)
912 \& SHADED (512)
913 \& SKIP_PAGER (1024)
914 \& SKIP_TASKBAR (2048)
915 \& STICKY (4096)
916 .Ve
917 .SS EXAMPLES
918 .IX Subsection "EXAMPLES"
919 List all workspace names:
920 .PP
921 .Vb 1
922 \& icesh listWorkspaces
923 .Ve
924 .PP
925 Example output:
926 .PP
927 .Vb 4
928 \& workspace #0: \`main\*(Aq
929 \& workspace #1: \`web\*(Aq
930 \& workspace #2: \`doc\*(Aq
931 \& workspace #3: \`dev\*(Aq
932 .Ve
933 .PP
934 Close terminal work and activate terminal fun.
935 .PP
936 .Vb 1
937 \& icesh \-c work.XTerm close \-a \-c fun.XTerm activate
938 .Ve
939 .PP
940 Print opacity for all xterms.
941 .PP
942 .Vb 1
943 \& icesh \-c XTerm opacity
944 .Ve
945 .PP
946 Change opacity for all xterms.
947 .PP
948 .Vb 1
949 \& icesh \-c XTerm opacity 84
950 .Ve
951 .PP
952 Move all windows on workspace "Top" to the current workspace.
953 .PP
954 .Vb 1
955 \& icesh \-W "Top" setWorkspace "this"
956 .Ve
957 .PP
958 Restore all hidden clients, minimize all clients on the current
959 workspace and activate Firefox.
960 .PP
961 .Vb 1
962 \& icesh \-N HIDDEN restore \-a \-W "this" minimize \-a \-c Firefox activate
963 .Ve
964 .PP
965 Resize the focused window to occupy the right half of the desktop area.
966 .PP
967 .Vb 1
968 \& icesh \-f sizeto 49% 100% top right raise
969 .Ve
970 .PP
971 Toggle the frame border of the focused window.
972 .PP
973 .Vb 2
974 \& if icesh \-f motif | grep \-q \*(Aqdecor:$\*(Aq; then \e
975 \& icesh \-f motif decor All; else icesh \-f motif decor ""; fi
976 .Ve
977 .PP
978 Here is a different solution using conditionals.
979 .PP
980 .Vb 1
981 \& icesh \-f if \-P _NET_FRAME_EXTENTS=0 then bordered else borderless
982 .Ve
983 .PP
984 Here is a conditional to either toggle the visibility of a roxterm that
985 has a WM_WINDOW_ROLE value of \f(CW\*(C`special\*(C'\fR or start it with \fBrunonce\fR.
986 .PP
987 .Vb 4
988 \& icesh if \-c roxterm.Roxterm \-R special then \e
989 \& if \-v then hide \e
990 \& elif \-u then setWorkspace this activate end \e
991 \& else runonce roxterm \-\-role=special
992 .Ve
993 .PP
994 Collect all urxvt terminals from the fourth workspace in a single frame
995 on the current workspace.
996 .PP
997 .Vb 1
998 \& icesh \-W 3 \-c urxvt tabto myfunnyname
999 .Ve
1000 .PP
1001 Use the loop construct conditionally to wait for a certain window to
1002 appear.
1003 .PP
1004 .Vb 1
1005 \& icesh \-t if \-n Tooltip then list else delay 0.05 loop end
1006 .Ve
1007 .SS ENVIRONMENT
1008 .IX Subsection "ENVIRONMENT"
1009 .IP \fBDISPLAY\fR 4
1010 .IX Item "DISPLAY"
1011 The default display.
1012 .SS "EXIT STATUS"
1013 .IX Subsection "EXIT STATUS"
1014 .IP \fB0\fR 4
1015 .IX Item "0"
1016 The last action completed successfully.
1017 .IP \fB1\fR 4
1018 .IX Item "1"
1019 The last action completed unsuccessfully, or no window met the condition.
1020 .IP \fB2\fR 4
1021 .IX Item "2"
1022 A conditional has invalid syntax.
1023 .IP \fB3\fR 4
1024 .IX Item "3"
1025 The display could not be opened.
1026 .IP \fB4\fR 4
1027 .IX Item "4"
1028 The X server reports an error while processing a request.
1029 .SS COMPLIANCE
1030 .IX Subsection "COMPLIANCE"
1031 \&\fBicesh\fR is largely compliant with the EWMH and ICCCM specifications.
1032 Some commands, like manager actions, are specific to IceWM.
1033 .SS "SEE ALSO"
1034 .IX Subsection "SEE ALSO"
1035 \&\fBicewm\fR\|(1), \fBwmctrl\fR\|(1), \fBxdotool\fR\|(1), \fBxprop\fR\|(1),
1036 \&\fBxwininfo\fR\|(1), \fBXParseGeometry\fR\|(3).
1037 .SS BUGS
1038 .IX Subsection "BUGS"
1039 Please report bugs at <https://github.com/ice\-wm/icewm/issues>.
1040 .SS AUTHOR
1041 .IX Subsection "AUTHOR"
1042 Brian Bidulock <mailto:[email protected]>.
1043 .PP
1044 See \fB\-\-copying\fR for full copyright notice and copying permissions.
1045 .SS LICENSE
1046 .IX Subsection "LICENSE"
1047 \&\fBIceWM\fR is licensed under the GNU Library General Public License.
1048 See the \fICOPYING\fR file in the distribution or use the \fB\-\-copying\fR flag
1049 to display copying permissions.