source: x/wm/icewm.xml@ 5222495

11.3 12.0 12.1 kea ken/TL2024 ken/inkscape-core-mods ken/tuningfonts lazarus lxqt plabs/newcss plabs/python-mods python3.11 qt5new rahul/power-profiles-daemon renodr/vulkan-addition trunk xry111/llvm18 xry111/xf86-video-removal
Last change on this file since 5222495 was 5222495, checked in by Pierre Labastie <pierre.labastie@…>, 17 months ago

Update to icewm-3.2.3
  • Property mode set to 100644
File size: 17.2 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
7 <!ENTITY icewm-download-http "https://github.com/ice-wm/icewm/archive/&icewm-version;/icewm-&icewm-version;.tar.gz">
8 <!ENTITY icewm-download-ftp " ">
9 <!ENTITY icewm-md5sum "ed903764698d6dff1f843ed9953566db">
10 <!ENTITY icewm-size "2.3 MB">
11 <!ENTITY icewm-buildsize "54 MB">
12 <!ENTITY icewm-time "0.3 SBU">
13]>
14
15<sect1 id="icewm" xreflabel="IceWM-&icewm-version;">
16 <?dbhtml filename="icewm.html" ?>
17
18
19 <title>IceWM-&icewm-version;</title>
20
21 <indexterm zone="icewm">
22 <primary sortas="a-icewm">icewm</primary>
23 </indexterm>
24
25 <sect2 role="package">
26 <title>Introduction to IceWM</title>
27
28 <para>
29 <application>IceWM</application> is a window manager with the goals of
30 speed, simplicity, and not getting in the user&apos;s way.
31 </para>
32
33 &lfs112_checked;
34
35 <bridgehead renderas="sect3">Package Information</bridgehead>
36 <itemizedlist spacing="compact">
37 <listitem>
38 <para>
39 Download (HTTP): <ulink url="&icewm-download-http;"/>
40 </para>
41 </listitem>
42 <listitem>
43 <para>
44 Download (FTP): <ulink url="&icewm-download-ftp;"/>
45 </para>
46 </listitem>
47 <listitem>
48 <para>
49 Download MD5 sum: &icewm-md5sum;
50 </para>
51 </listitem>
52 <listitem>
53 <para>
54 Download size: &icewm-size;
55 </para>
56 </listitem>
57 <listitem>
58 <para>
59 Estimated disk space required: &icewm-buildsize;
60 </para>
61 </listitem>
62 <listitem>
63 <para>
64 Estimated build time: &icewm-time;
65 </para>
66 </listitem>
67 </itemizedlist>
68
69 <bridgehead renderas="sect3">IceWM Dependencies</bridgehead>
70
71 <bridgehead renderas="sect4">Required</bridgehead>
72 <para role="required">
73 <xref linkend="cmake"/>,
74 <xref linkend="x-window-system"/>, and
75 <xref linkend="gdk-pixbuf-xlib"/>
76 </para>
77
78 <bridgehead renderas="sect4">Optional</bridgehead>
79 <para role="optional">
80 <xref linkend="asciidoc"/> (for regenerating the HTML documentation),
81 <xref linkend="fribidi"/> (for languages written right to left),
82 <xref linkend="imlib2"/>,
83 <xref linkend="librsvg"/>,
84 <xref linkend="libao"/>,
85 <xref linkend="libsndfile"/>, and
86 <xref linkend="alsa-lib"/> (for the experimental icesound program)
87 </para>
88
89 <para condition="html" role="usernotes">User Notes:
90 <ulink url="&blfs-wiki;/icewm"/></para>
91
92 </sect2>
93
94 <sect2 role="installation">
95 <title>Installation of IceWM</title>
96<!--
97 <note>
98 <para>
99 The tarball is compressed with <command>lzip</command>, and cannot be
100 processed with the <command>tar</command> program. It can be unpacked
101 with the <command>bsdtar</command> program from the libarchive
102 package.
103 </para>
104 </note>
105-->
106 <para>
107 Install <application>IceWM</application> by running the following
108 commands:
109 </para>
110
111<screen><userinput>mkdir build &amp;&amp;
112cd build &amp;&amp;
113
114cmake -DCMAKE_INSTALL_PREFIX=/usr \
115 -DCMAKE_BUILD_TYPE=Release \
116 -DCFGDIR=/etc \
117 -DENABLE_LTO=ON \
118 -DCONFIG_GDK_PIXBUF_XLIB=ON \
119 -DCONFIG_IMLIB2=OFF \
120 -DDOCDIR=/usr/share/doc/icewm-&icewm-version; \
121 .. &amp;&amp;
122make</userinput></screen>
123
124 <para>
125 This package does not have a working testsuite.
126 </para>
127
128 <para>
129 Now, as the <systemitem class="username">root</systemitem> user:
130 </para>
131<!--
132<screen role="root"><userinput>cp ../lib/IceWM.jpg lib &amp;&amp;
133make install &amp;&amp;
134rm /usr/share/xsessions/icewm.desktop</userinput></screen>
135-->
136<screen role="root"><userinput>make install</userinput></screen>
137
138 </sect2>
139
140 <sect2 role="commands">
141 <title>Command Explanations</title>
142
143 <para>
144 <parameter>-DENABLE_LTO=ON</parameter>: This option enables Link
145 Time Optimization and is required for this package.
146 </para>
147<!--
148 <para>
149 <command>rm /usr/share/xsessions/icewm.desktop</command>: The package
150 ships with both icewm.desktop and icewm-xsession.desktop. The former has
151 apparently been used in the past, but it will hang if used with a modern
152 desktop-manager<phrase revision='sysv'> such as
153 <xref linkend="lightdm"/></phrase>.
154 </para>
155
156 <para>
157 <command>cp ../lib/IceWM.jpg lib</command>: This instruction fixes an
158 install problem.
159 </para>
160-->
161 </sect2>
162
163 <sect2 role="configuration">
164 <title>Configuring IceWM</title>
165
166 <sect3 id="icewm-config">
167 <title>Config Files</title>
168
169 <para>
170 <filename>~/.icewm/keys</filename>,
171 <filename>~/.icewm/menu</filename>, and
172 <filename>~/.icewm/preferences</filename>, and
173 <filename>~/.icewm/toolbar</filename>, and
174 <filename>~/.icewm/winoptions</filename>. The default versions are
175 installed in <filename class="directory">/usr/share/icewm/</filename>
176 and will be used if you have not copied them to <filename
177 class="directory">~/.icewm</filename>.
178 </para>
179
180
181 <indexterm zone="icewm icewm-config">
182 <primary sortas="e-AA.icewm-keys">~/.icewm/keys</primary>
183 </indexterm>
184
185 <indexterm zone="icewm icewm-config">
186 <primary sortas="e-AA.icewm-menu">~/.icewm/menu</primary>
187 </indexterm>
188
189 <indexterm zone="icewm icewm-config">
190 <primary sortas="e-AA.icewm-preferences">~/.icewm/preferences</primary>
191 </indexterm>
192
193 <indexterm zone="icewm icewm-config">
194 <primary sortas="e-AA.icewm-toolbar">~/.icewm/toolbar</primary>
195 </indexterm>
196
197 <indexterm zone="icewm icewm-config">
198 <primary sortas="e-AA.icewm-winoptions">~/.icewm/winoptions</primary>
199 </indexterm>
200
201 </sect3>
202
203 <sect3>
204 <title>Configuration Information</title>
205
206 <para>
207 If <application>IceWM</application> is the only Window Manager you
208 want to use, you can start it with an <filename>.xinitrc</filename> file
209 in your home folder. Be sure to backup your current
210 <filename>.xinitrc</filename> before proceeding.
211 </para>
212
213 <indexterm zone="icewm icewm-config">
214 <primary sortas="e-AA.xinitrc">~/.xinitrc</primary>
215 </indexterm>
216
217<screen><userinput>echo icewm-session &gt; ~/.xinitrc</userinput></screen>
218
219 <para>
220 Now create the <application>IceWM</application> configuration files:
221 </para>
222
223<screen><userinput>mkdir -pv ~/.icewm &amp;&amp;
224cp -v /usr/share/icewm/keys ~/.icewm/keys &amp;&amp;
225cp -v /usr/share/icewm/menu ~/.icewm/menu &amp;&amp;
226cp -v /usr/share/icewm/preferences ~/.icewm/preferences &amp;&amp;
227cp -v /usr/share/icewm/toolbar ~/.icewm/toolbar &amp;&amp;
228cp -v /usr/share/icewm/winoptions ~/.icewm/winoptions</userinput></screen>
229
230 <para>
231 You can now edit these files to meet your requirements. In particular,
232 review the <filename>preferences</filename> file. You can use
233 <command>Logout -> Restart-IceWM</command> on the main menu to load
234 your changed preferences, but changes to the background only take
235 effect when <application>IceWM</application> is started.
236 </para>
237
238 <para>
239 At this point you can <emphasis>either</emphasis> modify the
240 traditional menu files to suit your requirements,
241 <emphasis>or</emphasis> use the newer
242 <command>icewm-menu-fdo</command> described later.
243 </para>
244
245 <para>
246 The syntax of the menus is explained in the help files, which you can
247 access by running <command>help</command> from the menu, but some of
248 the detail is out of date and the default selections in the menus (a
249 few old applications on the main menu, everything else on the
250 <command>Programs</command> menu) will benefit from being updated to
251 meet your needs. The following examples are provided to encourage you
252 to think about how you wish to organise your menus. Please note the
253 following:
254 </para>
255
256 <itemizedlist>
257 <listitem>
258 <para>
259 If a program listed in the menu has not been installed, it will
260 not appear when the menu is displayed. Similarly, if the program
261 exists but the specified icon does not, no icon will be displayed
262 in the menu.
263 </para>
264 </listitem>
265 <listitem>
266 <para>
267 The icons can be either <filename>.xpm</filename> or
268 <filename>.png</filename> files, and there is no need to specify
269 the extension. If the icon is located in the &quot;library&quot;
270 (<filename class="directory">/usr/share/icewm/icons</filename>)
271 there is no need to specify the path.
272 </para>
273 </listitem>
274 <listitem>
275 <para>
276 Most programs are in sub-menus, and the main menu will always
277 append entries for
278 <literal>windows, help, settings, logout</literal>
279 at the bottom.
280 </para>
281 </listitem>
282 <listitem>
283 <para>
284 An icon for <application>firefox</application> was copied to
285 the library directory and given a meaningful name. The icon for
286 <application>xine</application> is <filename>xine.xpm</filename>
287 which was installed to a pixmap directory.
288 </para>
289 </listitem>
290 <listitem>
291 <para>
292 The default toolbar is not altered.
293 </para>
294 </listitem>
295 </itemizedlist>
296
297 <para>
298 If you wish to use this traditional method, there are more examples in
299 previous releases of this book (e.g. BLFS-7.8).
300 </para>
301
302 <para>
303 <emphasis>Alternatively</emphasis>, you can create a menu which
304 conforms to the FDO Desktop Menu Specifications, where programs can be
305 found because they have a .desktop file in the XDG_DATA_HOME or
306 XDG_DATA_DIR directories. Unlike most windowmanagers,
307 <application>icewm</application> does not search for programs when the
308 menu is invoked, so if you take this route you will need to rerun the
309 following command after installing or removing programs:
310 </para>
311
312<screen><userinput>icewm-menu-fdo >~/.icewm/menu</userinput></screen>
313
314 <para>
315 If you wish to put icons on your desktop, you will need to install a
316 program such as <xref linkend="rox-filer"/> which provides a pinboard.
317 If you do that you will no longer be able to access the menu by
318 right-clicking on the desktop, you will have to use the
319 <application>IceWM</application> button. To ensure that the
320 <application>rox</application> pinboard is running, the following
321 commands will put it in the startup file:
322 </para>
323
324<screen role="nodump"><userinput>cat &gt; ~/.icewm/startup &lt;&lt; "EOF"
325<literal>rox -p Default &amp;
326EOF &amp;&amp;
327chmod +x ~/.icewm/startup</literal></userinput></screen>
328
329 <tip>
330 <para>
331 There are a number of keyboard shortcuts in
332 <application>IceWM</application>:
333 </para>
334 <itemizedlist>
335 <listitem>
336 <para>
337 Ctrl + Alt + F<replaceable>N</replaceable> : go to
338 <filename>tty<replaceable>N</replaceable></filename>.
339 </para>
340 </listitem>
341 <listitem>
342 <para>
343 Ctrl + Alt + <replaceable>N</replaceable> : go to desktop
344 number <replaceable>N</replaceable>
345 </para>
346 </listitem>
347 <listitem>
348 <para>
349 Ctrl + Alt + Space : open a box on the taskbar where you can
350 key in the name of an application and run it.
351 </para>
352 </listitem>
353 </itemizedlist>
354 </tip>
355
356 </sect3>
357
358 </sect2>
359
360 <sect2 role="content">
361 <title>Contents</title>
362
363 <segmentedlist>
364 <segtitle>Installed Programs</segtitle>
365 <segtitle>Installed Libraries</segtitle>
366 <segtitle>Installed Directories</segtitle>
367
368 <seglistitem>
369 <seg>icehelp, icesh, icesound, icewm, icewm-menu-fdo, icewm-menu-xrandr,
370 icewm-session, icewm-set-gnomewm, icewmbg, and icewmhint
371 <!-- icewmtray--></seg>
372 <seg>None</seg>
373 <seg>/usr/share/doc/icewm-&icewm-version;, /usr/share/icewm and ~/.icewm</seg>
374 </seglistitem>
375 </segmentedlist>
376
377 <variablelist>
378 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
379 <?dbfo list-presentation="list"?>
380 <?dbhtml list-presentation="table"?>
381
382 <varlistentry id="icehelp">
383 <term><command>icehelp</command></term>
384 <listitem>
385 <para>
386 is used to display the html manual
387 </para>
388 <indexterm zone="icewm icehelp">
389 <primary sortas="b-icehelp">icehelp</primary>
390 </indexterm>
391 </listitem>
392 </varlistentry>
393
394 <varlistentry id="icesh">
395 <term><command>icesh</command></term>
396 <listitem>
397 <para>
398 is a command-line window manager which can be used in
399 <filename>~/.icewm/startup</filename>
400 </para>
401 <indexterm zone="icewm icesh">
402 <primary sortas="b-icesh">icesh</primary>
403 </indexterm>
404 </listitem>
405 </varlistentry>
406
407 <varlistentry id="icesound">
408 <term><command>icesound</command></term>
409 <listitem>
410 <para>
411 plays audio files on GUI events raised by IceWM
412 </para>
413 <indexterm zone="icewm icesound">
414 <primary sortas="b-icesound">icesound</primary>
415 </indexterm>
416 </listitem>
417 </varlistentry>
418
419 <varlistentry id="icewm-prog">
420 <term><command>icewm</command></term>
421 <listitem>
422 <para>
423 is the window manager
424 </para>
425 <indexterm zone="icewm icewm-prog">
426 <primary sortas="b-icewm">icewm</primary>
427 </indexterm>
428 </listitem>
429 </varlistentry>
430
431 <varlistentry id="icewm-menu-fdo">
432 <term><command>icewm-menu-fdo</command></term>
433 <listitem>
434 <para>
435 can create a file in a format suitable for an IceWM menu, which
436 lists those programs currently installed in a layout conforming to
437 the FDO Desktop Menu Specifications
438 </para>
439 <indexterm zone="icewm icewm-menu-fdo">
440 <primary sortas="b-icewm-menu-fdo">icewm-menu-fdo</primary>
441 </indexterm>
442 </listitem>
443 </varlistentry>
444
445 <varlistentry id="icewm-menu-xrandr">
446 <term><command>icewm-menu-xrandr</command></term>
447 <listitem>
448 <para>
449 is a helper program used to manage multi-screen configurations
450 </para>
451 <indexterm zone="icewm icewm-menu-xrandr">
452 <primary sortas="b-icewm-menu-xrandr">icewm-menu-xrandr</primary>
453 </indexterm>
454 </listitem>
455 </varlistentry>
456
457 <varlistentry id="icewm-session">
458 <term><command>icewm-session</command></term>
459 <listitem>
460 <para>
461 runs icewmbg, icewm, icewmtray, startup, shutdown (i.e. startup
462 and shutdown scripts are run if installed)
463 </para>
464 <indexterm zone="icewm icewm-session">
465 <primary sortas="b-icewm-session">icewm-session</primary>
466 </indexterm>
467 </listitem>
468 </varlistentry>
469
470 <varlistentry id="icewm-set-gnomewm">
471 <term><command>icewm-set-gnomewm</command></term>
472 <listitem>
473 <para>
474 is a script to set the <application>GNOME</application> window
475 manager to <application>icewm</application> using
476 <application>gconftool</application>
477 </para>
478 <indexterm zone="icewm icewm-set-gnomewm">
479 <primary sortas="b-icewm-set-gnomewm">icewm-set-gnomewm</primary>
480 </indexterm>
481 </listitem>
482 </varlistentry>
483
484 <varlistentry id="icewmbg">
485 <term><command>icewmbg</command></term>
486 <listitem>
487 <para>
488 is used to set the background, according to the various
489 <literal>DesktopBackground</literal> settings in the preferences
490 </para>
491 <indexterm zone="icewm icewmbg">
492 <primary sortas="b-icewmbg">icewmbg</primary>
493 </indexterm>
494 </listitem>
495 </varlistentry>
496
497 <varlistentry id="icewmhint">
498 <term><command>icewmhint</command></term>
499 <listitem>
500 <para>
501 is used internally to provide hints to the user
502 </para>
503 <indexterm zone="icewm icewmhint">
504 <primary sortas="b-icewmhint">icewmhint</primary>
505 </indexterm>
506 </listitem>
507 </varlistentry>
508 <!--
509 <varlistentry id="icewmtray">
510 <term><command>icewmtray</command></term>
511 <listitem>
512 <para>
513 provides the tray
514 </para>
515 <indexterm zone="icewm icewmtray">
516 <primary sortas="b-icewmtray">icewmtray</primary>
517 </indexterm>
518 </listitem>
519 </varlistentry>
520 -->
521 </variablelist>
522
523 </sect2>
524
525</sect1>
Note: See TracBrowser for help on using the repository browser.