source: x/wm/icewm.xml@ fdf0646

10.1 11.0 11.1 11.2 lazarus plabs/python-mods qt5new trunk upgradedb xry111/intltool xry111/soup3 xry111/test-20220226
Last change on this file since fdf0646 was fdf0646, checked in by Bruce Dubbs <bdubbs@…>, 2 years ago

Update to cmake-3.19.2.
Update to pipewire-0.3.18.
Update to node-14.15.2.
Update to icewm-2.0.0.

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@23998 af4574ff-66df-0310-9fd7-8a98e5e911e0

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