source: x/wm/icewm.xml@ c4ec167b

10.1 11.0 ken/refactor-virt lazarus qt5new trunk xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since c4ec167b was c4ec167b, checked in by Tim Tassonis <stuff@…>, 9 months ago

Update to icewm-2.0.1.

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

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