source: x/wm/icewm.xml@ 504e5ce

12.0 12.1 kea ken/TL2024 ken/tuningfonts lazarus lxqt plabs/newcss python3.11 qt5new rahul/power-profiles-daemon renodr/vulkan-addition trunk xry111/llvm18 xry111/xf86-video-removal
Last change on this file since 504e5ce was 86324838, checked in by Pierre Labastie <pierre.labastie@…>, 16 months ago

Tweak /usr/share/{x,wayland-}sessions files

Don't create a "deprecated directory, just remove spurious files
also fix starting gnome-wayland from lightdm

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