Debian Codegraph @

upstream/mageia-cauldron/man1/icewmhint.1

raw
1 .\" -*- mode: troff; coding: utf-8 -*-
2 .\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45)
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 "ICEWMHINT 1"
61 .TH ICEWMHINT 1 2026-01-01 "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 icewmhint \- set IceWM hints by window class and instance
69 .SS SYNOPSIS
70 .IX Subsection "SYNOPSIS"
71 \&\fBicewmhint\fR \fICLASS\fR\fB.\fR\fIINSTANCE\fR \fIOPTION\fR \fIVALUE\fR ...
72 .SS DESCRIPTION
73 .IX Subsection "DESCRIPTION"
74 \&\fBicewmhint\fR is a utility for passing IceWM hints to \fBicewm\fR\|(1).
75 \&\fBicewm\fR uses these hints for the first \fIX11 client\fR which is
76 subsequently started. They take precedence over hints from
77 the \fBicewm\-winoptions\fR\|(1) file.
78 .PP
79 A hint is a triplet consisting of a \fIclass.instance\fR, an
80 \&\fIIceWM winoption\fR and its value. Multiple hints can be given per
81 invocation of \fBicewmhint\fR.
82 .PP
83 The hints are communicated over the \f(CW\*(C`_ICEWM_WINOPTHINT\*(C'\fR property on
84 the root window. \fBicewmhint\fR appends hints to this property, while
85 \&\fBicewm\fR removes the property after reading it.
86 .SS OPTIONS
87 .IX Subsection "OPTIONS"
88 \&\fBicewmhint\fR recognizes the following options:
89 .SS "COMMAND OPTIONS"
90 .IX Subsection "COMMAND OPTIONS"
91 Only one command option can be specified per invocation. If no command
92 option is specified, argument parsing and processing is performed.
93 .IP "\fB\-h\fR, \fB\-\-help\fR" 4
94 .IX Item "-h, --help"
95 Print a brief usage statement to \fIstdout\fR and exit.
96 .IP "\fB\-V\fR, \fB\-\-version\fR" 4
97 .IX Item "-V, --version"
98 Print the program version to \fIstdout\fR and exit.
99 .IP "\fB\-C\fR, \fB\-\-copying\fR" 4
100 .IX Item "-C, --copying"
101 Print copying permissions to \fIstdout\fR for the program and exit.
102 .SS "GENERAL OPTIONS"
103 .IX Subsection "GENERAL OPTIONS"
104 .IP "\fB\-d\fR, \fB\-\-display\fR=\fIDISPLAY\fR" 4
105 .IX Item "-d, --display=DISPLAY"
106 Specifies the X11 DISPLAY. If unspecified, defaults to \fR\f(CB$DISPLAY\fR\fB\fR.
107 .SS ARGUMENTS
108 .IX Subsection "ARGUMENTS"
109 The following three arguments are required for each hint.
110 .IP \fICLASS\fR\fB.\fR\fIINSTANCE\fR 4
111 .IX Item "CLASS.INSTANCE"
112 Specifies the ICCCM 2.0 \fBWM_CLASS\fR property in terms of resource class
113 and resource name separated by a period (\f(CW\*(C`.\*(C'\fR). For example:
114 \&\f(CW\*(C`XTerm.xterm\*(C'\fR. Just the resource class or resource name without a dot
115 is also acceptable, like \f(CW\*(C`XTerm\*(C'\fR or \f(CW\*(C`xterm\*(C'\fR.
116 .IP \fIOPTION\fR 4
117 .IX Item "OPTION"
118 Specifies the \fIOPTION\fR to affect.
119 .IP \fIVALUE\fR 4
120 .IX Item "VALUE"
121 Gives the \fIVALUE\fR for the option.
122 .PP
123 Multiple hints can be given.
124 .SS "GENERAL OPTION ARGUMENTS"
125 .IX Subsection "GENERAL OPTION ARGUMENTS"
126 .IP "\fBicon\fR \fINAME\fR" 4
127 .IX Item "icon NAME"
128 Specifies the icon name for windows of \fICLASS\fR\fB.\fR\fIINSTANCE\fR.
129 \&\fINAME\fR should be the name of the icon. \fBicewm\fR\|(1) will use its
130 usual method to locate the icon. The default is the name provided
131 by window manager hints.
132 .IP "\fBworkspace\fR \fIWORKSPACE\fR" 4
133 .IX Item "workspace WORKSPACE"
134 Specifies the workspace on which a window of \fICLASS\fR\fB.\fR\fIINSTANCE\fR
135 will be initially placed. The default is the current workspace.
136 \&\fIWORKSPACE\fR should be a workspace number counting from 0.
137 .IP "\fBgeometry\fR \fIGEOMETRY\fR" 4
138 .IX Item "geometry GEOMETRY"
139 Specifies the initial geometry for windows of the given
140 \&\fICLASS\fR\fB.\fR\fIINSTANCE\fR. \fIGEOMETRY\fR must be a geometry that can be
141 parsed by \fBXParseGeometry\fR\|(3). The default is the geometry provided by
142 window manager hints.
143 .IP "\fBorder\fR \fINUMBER\fR" 4
144 .IX Item "order NUMBER"
145 The sorting order of task buttons and tray icons. The default value is
146 zero. Increasing positive values go farther right, while decreasing
147 negative values go farther left. The order option applies to the task
148 pane, the tray pane and the system tray.
149 .IP "\fBopacity\fR \fINUMBER\fR" 4
150 .IX Item "opacity NUMBER"
151 Set the _NET_WM_WINDOW_OPACITY property if \fINUMBER\fR is a value between
152 1 and 100. \fINUMBER\fR is interpreted as percentage of maximum opaqueness.
153 .IP "\fBlayer\fR {\fILAYER\fR|\fINUMBER\fR}" 4
154 .IX Item "layer {LAYER|NUMBER}"
155 This command option specifies the layer to be associated with a
156 \&\fICLASS\fR\fB.\fR\fIINSTANCE\fR. The default is the \f(CW\*(C`Normal\*(C'\fR layer. \fIVALUE\fR
157 is either a layer number or a symbolic layer name. Symbolic
158 layer names are:
159 .Sp
160 .Vb 9
161 \& Desktop (0) Desktop window.
162 \& Below (2) Below the default layer.
163 \& Normal (4) Default layer for windows.
164 \& OnTop (6) Above the default layer.
165 \& Dock (8) Docked windows at edge of screen.
166 \& AboveDock (10) Windows above the dock.
167 \& Menu (12) The layer for menu\*(Aqs.
168 \& Fullscreen (14) When fullscreen and focused.
169 \& AboveAll (15) Always above anything.
170 .Ve
171 .IP "\fBtray\fR {\fBIgnore\fR|\fBMinimized\fR|\fBExclusive\fR|\fINUMBER\fR}" 4
172 .IX Item "tray {Ignore|Minimized|Exclusive|NUMBER}"
173 Specifies the tray handling to be applied to windows with
174 \&\fICLASS\fR\fB.\fR\fIINSTANCE\fR. This option is specific to \fBicewm\fR\|(1) and
175 sets the \f(CW\*(C`_ICEWM_TRAY\*(C'\fR property associated with the window.
176 The default is \f(CW\*(C`Ignore\*(C'\fR. \fIVALUE\fR can be an option number
177 or a symbolic name as follows:
178 .Sp
179 .Vb 3
180 \& Ignore (0) only in task list.
181 \& Minimized (1) icon in tray, task list unminimized.
182 \& Exclusive (2) only in tray, not in task list.
183 .Ve
184 .IP "\fBframe\fR \fIlabel\fR (default: none)" 4
185 .IX Item "frame label (default: none)"
186 All windows with the same frame label become tabs in a single frame.
187 .SS "FUNCTION OPTION ARGUMENTS"
188 .IX Subsection "FUNCTION OPTION ARGUMENTS"
189 Specifies which functions are disabled or enabled (0/1) for windows with
190 \&\fICLASS\fR\fB.\fR\fIINSTANCE\fR. All functions have a default value of enabled
191 (1) unless overridden by the application. The Motif\-like functions are
192 as follows:
193 .PP
194 .Vb 7
195 \& fClose can be closed: (default: 1).
196 \& fHide can be hidden: (default: 1).
197 \& fMaximize can be maximized: (default: 1).
198 \& fMinimize can be minimized: (default: 1).
199 \& fMove can be moved: (default: 1).
200 \& fResize can be resized: (default: 1).
201 \& fRollup can be shaded: (default: 1).
202 .Ve
203 .SS "DECOR OPTION ARGUMENTS"
204 .IX Subsection "DECOR OPTION ARGUMENTS"
205 Specifies which decorations are disabled or enabled (0/1) for windows
206 with \fICLASS\fR\fB.\fR\fIINSTANCE\fR. All decor options have a default value
207 of enabled (1) unless overridden by the application. The Motif\-like
208 decorations are as follows:
209 .PP
210 .Vb 10
211 \& dBorder has border: (default: 1).
212 \& dClose has close button: (default: 1).
213 \& dDepth has depth button: (default: 1).
214 \& dHide has hide button: (default: 1).
215 \& dMaximize has maximize button: (default: 1).
216 \& dMinimize has minimize button: (default: 1).
217 \& dResize has resize grips: (default: 1).
218 \& dRollup has shade button: (default: 1).
219 \& dSysMenu has window menu: (default: 1).
220 \& dTitleBar has title bar: (default: 1).
221 .Ve
222 .SS "FEATURE OPTION ARGUMENTS"
223 .IX Subsection "FEATURE OPTION ARGUMENTS"
224 Specifies which advanced features to be enabled/disabled (1/0) for
225 windows with \fICLASS\fR\fB.\fR\fIINSTANCE\fR. All advanced features have a
226 default value of disabled (0) unless overridden by the application. The
227 advanced features are as follows:
228 .PP
229 .Vb 10
230 \& allWorkspaces on all workspaces.
231 \& appTakesFocus let application take focus.
232 \& doNotCover limits workspace if sticky.
233 \& doNotFocus do not focus.
234 \& doNotManage do not manage.
235 \& forcedClose no close dialog.
236 \& fullKeys provided more keys.
237 \& ignoreNoFocusHint focus even no\-input.
238 \& ignorePagerPreview do not show in pager preview.
239 \& ignorePositionHint place automatically.
240 \& ignoreQuickSwitch not on quick switch.
241 \& ignoreTaskBar not on task bar.
242 \& ignoreUrgentHint ignore urgent hints.
243 \& ignoreWinList not on window list.
244 \& ignoreActivationMessages only user can focus window.
245 \& ignoreOverrideRedirect ignore the override redirect flag.
246 \& noFocusOnAppRaise no focus on raise.
247 \& noFocusOnMap do not focus when mapped.
248 \& noIgnoreTaskBar on task bar.
249 \& startClose close the window immediately.
250 \& startFullscreen start full screen.
251 \& startMaximized start maximized.
252 \& startMaximizedHorz start maximized horizontal.
253 \& startMaximizedVert start maximized vertical.
254 \& startMinimized start minimized.
255 .Ve
256 .SS EXAMPLE
257 .IX Subsection "EXAMPLE"
258 .Vb 2
259 \& # Here is how to preload an invisible background process of chromium
260 \& # on the fourth workspace which is only visible on the Window List.
261 \&
262 \& icewmhint Chromium\-browser startMinimized 1 \e
263 \& Chromium\-browser workspace 3 \e
264 \& Chromium\-browser ignorePagerPreview 1 \e
265 \& Chromium\-browser ignorePositionHint 1 \e
266 \& Chromium\-browser ignoreTaskBar 1 \e
267 \& Chromium\-browser ignoreQuickSwitch 1 \e
268 \& Chromium\-browser ignoreUrgentHint 1 \e
269 \& Chromium\-browser noFocusOnAppRaise 1
270 \& chromium
271 .Ve
272 .SS BUGS
273 .IX Subsection "BUGS"
274 Please report bugs at <https://github.com/ice\-wm/icewm/issues>.
275 .SS AUTHOR
276 .IX Subsection "AUTHOR"
277 Brian Bidulock <mailto:[email protected]>.
278 .PP
279 See \fB\-\-copying\fR for full copyright notice and copying permissions.
280 .SS LICENSE
281 .IX Subsection "LICENSE"
282 \&\fBIceWM\fR is licensed under the GNU Library General Public License.
283 See the \fICOPYING\fR file in the distribution or use the \fB\-\-copying\fR flag
284 to display copying permissions.