source: x/wm/icewm.xml@ 714edd8f

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 9.0 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 714edd8f was 714edd8f, checked in by Bruce Dubbs <bdubbs@…>, 5 years ago

Update to icewm-1.5.5

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