source: x/wm/icewm.xml@ 5a7dec8f

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 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 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 5a7dec8f was 5a7dec8f, checked in by Ken Moffat <ken@…>, 7 years ago

icewm-1.4.2

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