source: x/wm/icewm.xml@ 4f09d49

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 9.1 kea ken/TL2024 ken/inkscape-core-mods ken/tuningfonts lazarus lxqt 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 4f09d49 was 4f09d49, checked in by Bruce Dubbs <bdubbs@…>, 4 years ago

Update to gnome-desktop-3.34.3.
Update to curl-7.68.0.
Update to icewm-1.6.4.
Update to node.js-12.14.1.
Update to nss-3.49.

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