source: x/wm/icewm.xml@ 3585fd6

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 3585fd6 was 3585fd6, checked in by Pierre Labastie <pieere@…>, 4 years ago

Typo in icewm

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