source: x/wm/icewm.xml@ 193af65

10.0 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 193af65 was 193af65, checked in by Ken Moffat <ken@…>, 14 months ago

Tags.

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

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