source: x/wm/icewm.xml@ c225bfa

10.0 10.1 11.0 11.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind lazarus perl-modules qt5new trunk upgradedb xry111/intltool xry111/test-20220226
Last change on this file since c225bfa was c225bfa, checked in by Bruce Dubbs <bdubbs@…>, 4 years ago

Archive sddm

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

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