source: x/wm/icewm.xml@ 2b7420b

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 2b7420b was 2b7420b, checked in by Bruce Dubbs <bdubbs@…>, 8 months ago

Tag printer stack, window managers, and misc

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