source: x/wm/icewm.xml@ fd42347a

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 7.10 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind kea ken/TL2024 ken/inkscape-core-mods ken/tuningfonts lazarus lxqt nosym perl-modules plabs/newcss plabs/python-mods python3.11 qt5new rahul/power-profiles-daemon renodr/vulkan-addition trunk upgradedb xry111/intltool xry111/llvm18 xry111/soup3 xry111/test-20220226 xry111/xf86-video-removal
Last change on this file since fd42347a was fd42347a, checked in by Bruce Dubbs <bdubbs@…>, 8 years ago

Comment out sddm from systemd version of the book.
Finish all tags.

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

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