source: x/wm/icewm.xml@ 7830c481

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 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 7830c481 was 7830c481, checked in by Pierre Labastie <pieere@…>, 8 years ago

Another set of option vs parameter fixes

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@17879 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 <command>rm /usr/share/xsessions/icewm.desktop</command>: 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
110 <xref linkend="sddm"/></phrase>.
111 </para>
112
113 <para>
114 <option>--enable-guievents --with-icesound=ALSA</option>: these two switches
115 permit <command>icesound</command> to be compiled.
116 </para>
117
118 </sect2>
119
120 <sect2 role="configuration">
121 <title>Configuring IceWM</title>
122
123 <sect3 id="icewm-config">
124 <title>Config Files</title>
125
126 <para><filename>~/.icewm/keys</filename>,
127 <filename>~/.icewm/menu</filename>, and
128 <filename>~/.icewm/preferences</filename>, and
129 <filename>~/.icewm/toolbar</filename>, and
130 <filename>~/.icewm/winoptions</filename>. The default versions are
131 installed in <filename class="directory">/usr/share/icewm/</filename>
132 and will be used if you have not copied them to <filename
133 class="directory">~/.icewm</filename>.
134 </para>
135
136
137 <indexterm zone="icewm icewm-config">
138 <primary sortas="e-AA.icewm-keys">~/.icewm/keys</primary>
139 </indexterm>
140
141 <indexterm zone="icewm icewm-config">
142 <primary sortas="e-AA.icewm-menu">~/.icewm/menu</primary>
143 </indexterm>
144
145 <indexterm zone="icewm icewm-config">
146 <primary sortas="e-AA.icewm-preferences">~/.icewm/preferences</primary>
147 </indexterm>
148
149 <indexterm zone="icewm icewm-config">
150 <primary sortas="e-AA.icewm-toolbar">~/.icewm/toolbar</primary>
151 </indexterm>
152
153 <indexterm zone="icewm icewm-config">
154 <primary sortas="e-AA.icewm-winoptions">~/.icewm/winoptions</primary>
155 </indexterm>
156
157 </sect3>
158
159 <sect3>
160 <title>Configuration Information</title>
161
162 <para>If <application>IceWM</application> is the only Window Manager you
163 want to use, you can start it with an <filename>.xinitrc</filename> file
164 in your home folder. Be sure to backup your current
165 <filename>.xinitrc</filename> before proceeding.</para>
166
167 <indexterm zone="icewm icewm-config">
168 <primary sortas="e-AA.xinitrc">~/.xinitrc</primary>
169 </indexterm>
170
171<screen><userinput>echo icewm-session &gt; ~/.xinitrc</userinput></screen>
172
173 <para>Now create the <application>IceWM</application> configuration
174 files:</para>
175
176<screen><userinput>mkdir -v ~/.icewm &amp;&amp;
177cp -v /usr/share/icewm/keys ~/.icewm/keys &amp;&amp;
178cp -v /usr/share/icewm/menu ~/.icewm/menu &amp;&amp;
179cp -v /usr/share/icewm/preferences ~/.icewm/preferences &amp;&amp;
180cp -v /usr/share/icewm/toolbar ~/.icewm/toolbar &amp;&amp;
181cp -v /usr/share/icewm/winoptions ~/.icewm/winoptions</userinput></screen>
182
183 <para>You can now edit these files to meet your requirements. In
184 particular, review the <filename>preferences</filename> file. You can use
185 <command>Logout -> Restart-IceWM</command> on the main menu to load your
186 changed preferences, but changes to the background only take effect when
187 <application>IceWM</application> is started.</para>
188
189 <para>At this point you can <emphasis>either</emphasis> modify the
190 traditional menu files to suit your requirements, <emphasis>or</emphasis>
191 use the newer <command>icewm-menu-fdo</command> described later.</para>
192
193 <para>The syntax of the menus is explained in the help files, which you
194 can access by running <command>help</command> from the menu, but some of
195 the detail is out of date and the default selections in the menus (a few
196 old applications on the main menu, everything else on the
197 <command>Programs</command> menu) will benefit from being updated to meet
198 your needs. The following examples are provided to encourage you to
199 think about how you wish to organise your menus. Please note the
200 following:</para>
201
202 <itemizedlist>
203 <listitem>
204 <para>If a program listed in the menu has not been installed, it will
205 not appear when the menu is displayed. Similarly, if the program
206 exists but the specified icon does not, no icon will be displayed in
207 the menu.</para>
208 </listitem>
209 <listitem>
210 <para>The icons can be either <filename>.xpm</filename> or
211 <filename>.png</filename> files, and there is no need to specify the
212 extension. If the icon is located in the &quot;library&quot;
213 (<filename class="directory">/usr/share/icewm/icons</filename>) there
214 is no need to specifiy the path.</para>
215 </listitem>
216 <listitem>
217 <para>Most programs are in sub-menus, and the main menu will always
218 append entries for <literal>windows, help, settings, logout</literal>
219 at the bottom.</para> </listitem>
220 <listitem>
221 <para>An icon for <application>firefox</application> was copied to
222 the library directory and given a meaningful name. The icon for
223 <application>xine</application> is <filename>xine.xpm</filename>
224 which was installed to a pixmap directory.</para>
225 </listitem>
226 <listitem>
227 <para>The default toolbar is not altered.</para>
228 </listitem>
229 </itemizedlist>
230
231 <para>If you wish to use this traditional method, there are more examples in
232 previous releases of this book (e.g. BLFS-7.8).
233 </para>
234
235 <para><emphasis>Alternatively</emphasis>, you can create a menu which conforms
236 to the FDO Desktop Menu Specifications, where programs can be found because
237 they have a .desktop file in the XDG_DATA_HOME or XDG_DATA_DIR directories.
238 Unlike most windowmanagers, <application>icewm</application> does not search
239 for programs when the menu is invoked, so if you take this route you will
240 need to rerun the following command after installing or removing programs:
241 </para>
242
243<screen><userinput>icewm-menu-fdo >~/.icewm/menu</userinput></screen>
244
245 <para>If you wish to put icons on your desktop, you will need to install
246 a program such as <xref linkend="rox-filer"/> which provides a pinboard.
247 If you do that you will no longer be able to access the menu by
248 right-clicking on the desktop, you will have to use the
249 <application>IceWM</application> button. To ensure that the
250 <application>rox</application> pinboard is running, the following
251 commands will put it in the startup file:</para>
252
253<screen role="nodump"><userinput>cat &gt; ~/.icewm/startup &lt;&lt; "EOF"
254<literal>rox -p Default &amp;
255EOF &amp;&amp;
256chmod +x ~/.icewm/startup</literal></userinput></screen>
257
258 <tip>
259 <para>There are a number of keyboard shortcuts in
260 <application>IceWM</application>:</para>
261 <itemizedlist>
262 <listitem>
263 <para>Ctrl + Alt + F<replaceable>N</replaceable> : go to
264 <filename>tty<replaceable>N</replaceable></filename>.</para>
265 </listitem>
266 <listitem>
267 <para>Ctrl + Alt + <replaceable>N</replaceable> : go to desktop
268 number <replaceable>N</replaceable></para>
269 </listitem>
270 <listitem>
271 <para>Ctrl + Alt + Space : open a box on the taskbar where you can
272 key in the name of an application and run it.</para>
273 </listitem>
274 </itemizedlist>
275 </tip>
276
277 </sect3>
278
279 </sect2>
280
281 <sect2 role="content">
282 <title>Contents</title>
283
284 <segmentedlist>
285 <segtitle>Installed Programs</segtitle>
286 <segtitle>Installed Libraries</segtitle>
287 <segtitle>Installed Directories</segtitle>
288
289 <seglistitem>
290 <seg>icehelp, icesh, icesound, icewm, icewm-menu-fdo, icewm-session,
291 icewm-set-gnomewm, icewmbg, icewmhint, icewmtray</seg>
292 <seg>None</seg>
293 <seg>/usr/share/doc/icewm-&icewm-version;, /usr/share/icewm and ~/.icewm</seg>
294 </seglistitem>
295 </segmentedlist>
296
297 <variablelist>
298 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
299 <?dbfo list-presentation="list"?>
300 <?dbhtml list-presentation="table"?>
301
302 <varlistentry id="icehelp">
303 <term><command>icehelp</command></term>
304 <listitem>
305 <para>is used to display the html manual.</para>
306 <indexterm zone="icewm icehelp">
307 <primary sortas="b-icehelp">icehelp</primary>
308 </indexterm>
309 </listitem>
310 </varlistentry>
311
312 <varlistentry id="icesh">
313 <term><command>icesh</command></term>
314 <listitem>
315 <para>is a command-line window manager which can be used in
316 <filename>~/.icewm/startup</filename>.</para>
317 <indexterm zone="icewm icesh">
318 <primary sortas="b-icesh">icesh</primary>
319 </indexterm>
320 </listitem>
321 </varlistentry>
322
323 <varlistentry id="icesound">
324 <term><command>icesound</command></term>
325 <listitem>
326 <para>plays audio files on GUI events raised by IceWM.</para>
327 <indexterm zone="icewm icesound">
328 <primary sortas="b-icesound">icesound</primary>
329 </indexterm>
330 </listitem>
331 </varlistentry>
332
333 <varlistentry id="icewm-prog">
334 <term><command>icewm</command></term>
335 <listitem>
336 <para>is the window manager.</para>
337 <indexterm zone="icewm icewm-prog">
338 <primary sortas="b-icewm">icewm</primary>
339 </indexterm>
340 </listitem>
341 </varlistentry>
342
343 <varlistentry id="icewm-menu-fdo">
344 <term><command>icewm-menu-fdo</command></term>
345 <listitem>
346 <para>can create a file in a format suitable for an IceWM menu, which
347 lists those programs currently installed in a layout conforming to the
348 FDO Desktop Menu Specifications.</para>
349 <indexterm zone="icewm icewm-menu-fdo">
350 <primary sortas="b-icewm-menu-fdo">icewm-menu-fdo</primary>
351 </indexterm>
352 </listitem>
353 </varlistentry>
354
355 <varlistentry id="icewm-session">
356 <term><command>icewm-session</command></term>
357 <listitem>
358 <para>runs icewmbg, icewm, icewmtray, startup, shutdown (i.e. startup
359 and shutdown scripts are run if installed).</para>
360 <indexterm zone="icewm icewm-session">
361 <primary sortas="b-icewm-session">icewm-session</primary>
362 </indexterm>
363 </listitem>
364 </varlistentry>
365
366 <varlistentry id="icewm-set-gnomewm">
367 <term><command>icewm-set-gnomewm</command></term>
368 <listitem>
369 <para>is a script to set the <application>GNOME</application>windowmanager to
370 <application>icewm</application> using <application>gconftool</application>.
371 </para>
372 <indexterm zone="icewm icewm-set-gnomewm">
373 <primary sortas="b-icewm-set-gnomewm">icewm-set-gnomewm</primary>
374 </indexterm>
375 </listitem>
376 </varlistentry>
377
378 <varlistentry id="icewmbg">
379 <term><command>icewmbg</command></term>
380 <listitem>
381 <para>is used to set the background, according to the various
382 <literal>DesktopBackground</literal> settings in the preferences.</para>
383 <indexterm zone="icewm icewmbg">
384 <primary sortas="b-icewmbg">icewmbg</primary>
385 </indexterm>
386 </listitem>
387 </varlistentry>
388
389 <varlistentry id="icewmhint">
390 <term><command>icewmhint</command></term>
391 <listitem>
392 <para>is used internally.</para>
393 <indexterm zone="icewm icewmhint">
394 <primary sortas="b-icewmhint">icewmhint</primary>
395 </indexterm>
396 </listitem>
397 </varlistentry>
398
399 <varlistentry id="icewmtray">
400 <term><command>icewmtray</command></term>
401 <listitem>
402 <para>provides the tray.</para>
403 <indexterm zone="icewm icewmtray">
404 <primary sortas="b-icewmtray">icewmtray</primary>
405 </indexterm>
406 </listitem>
407 </varlistentry>
408
409 </variablelist>
410
411 </sect2>
412
413</sect1>
Note: See TracBrowser for help on using the repository browser.