source: x/wm/xfce.xml@ 6b54763

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 7.10 7.4 7.5 7.6 7.6-blfs 7.6-systemd 7.7 7.8 7.9 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind gnome kde5-13430 kde5-14269 kde5-14686 kea ken/TL2024 ken/inkscape-core-mods ken/tuningfonts krejzi/svn lazarus lxqt nosym perl-modules plabs/newcss plabs/python-mods python3.11 qt5new rahul/power-profiles-daemon renodr/vulkan-addition systemd-11177 systemd-13485 trunk upgradedb xry111/intltool xry111/llvm18 xry111/soup3 xry111/test-20220226 xry111/xf86-video-removal
Last change on this file since 6b54763 was 6b54763, checked in by Andrew Benton <andy@…>, 12 years ago

Remove Hal

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

  • Property mode set to 100644
File size: 25.2 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 xfce-download-http "&sourceforge-repo;/xfce/xfce-&xfce-version;-src.tar.bz2">
8 <!ENTITY xfce-download-ftp " ">
9 <!ENTITY xfce-md5sum "5dd0ee362dd5782324b88da3cd5b9f1b">
10 <!ENTITY xfce-size "25 MB">
11 <!ENTITY xfce-buildsize "330 MB (to build and install everything without deleting any sources)">
12 <!ENTITY xfce-time "5 SBU">
13
14 <!ENTITY Terminal-version "0.2.8">
15 <!ENTITY Thunar-version "0.9.0">
16 <!ENTITY exo-version "0.3.4">
17 <!ENTITY gtk-xfce-engine-version "2.4.2">
18 <!ENTITY mousepad-version "0.2.13">
19 <!ENTITY xfce4-dev-tools-version "4.4.0.1">
20
21]>
22
23<sect1 id="xfce" xreflabel="Xfce-&xfce-version;">
24 <?dbhtml filename="xfce.html" ?>
25
26 <sect1info>
27 <othername>$LastChangedBy$</othername>
28 <date>$Date$</date>
29 </sect1info>
30
31 <title>Xfce-&xfce-version;</title>
32
33 <indexterm zone="xfce">
34 <primary sortas="a-xfce">Xfce</primary>
35 </indexterm>
36
37 <sect2 role="package">
38 <title>Introduction to Xfce</title>
39
40 <para>The <application>Xfce</application> package contains a lightweight
41 desktop environment.</para>
42
43 <bridgehead renderas="sect3">Package Information</bridgehead>
44 <itemizedlist spacing="compact">
45 <listitem>
46 <para>Download (HTTP): <ulink url="&xfce-download-http;"/></para>
47 </listitem>
48 <listitem>
49 <para>Download (FTP): <ulink url="&xfce-download-ftp;"/></para>
50 </listitem>
51 <listitem>
52 <para>Download MD5 sum: &xfce-md5sum;</para>
53 </listitem>
54 <listitem>
55 <para>Download size: &xfce-size;</para>
56 </listitem>
57 <listitem>
58 <para>Estimated disk space required: &xfce-buildsize;</para>
59 </listitem>
60 <listitem>
61 <para>Estimated build time: &xfce-time;</para>
62 </listitem>
63 </itemizedlist>
64
65 <bridgehead renderas="sect3">Xfce General Dependencies</bridgehead>
66
67 <bridgehead renderas="sect4">Required</bridgehead>
68 <para role="required"><xref linkend="gtk2"/> and
69 <xref linkend="libxml2"/></para>
70
71 <bridgehead renderas="sect4">Optional</bridgehead>
72 <para role="optional"><xref linkend="libxslt"/>,
73 <xref linkend="intltool"/>,
74 <xref linkend="startup-notification"/>, and
75 <xref linkend="gtk-doc"/> (untested by BLFS editors)</para>
76
77
78
79 <para>Xfce components have additional dependencies upon each other
80 and upon external packages. They are summarized below.</para>
81
82 <bridgehead renderas="sect3" id="libxfce4util"
83 xreflabel="libxfce4util-&xfce-version;">libxfce4util</bridgehead>
84 <para>Libxfce4util is a basic utility library for Xfce4.</para>
85 <para>Libxfce4util has no external dependencies.</para>
86
87 <bridgehead renderas="sect3" id="libxfcegui4"
88 xreflabel="libxfcegui4-&xfce-version;">libxfcegui4</bridgehead>
89 <para>Libxfcegui4 is a library that contains various <xref linkend="gtk2"/> widgets for Xfce.</para>
90 <para>Libxfcegui4 depends on <xref linkend="libxfce4util"/>.</para>
91
92 <bridgehead renderas="sect3" id="libxfce4mcs"
93 xreflabel="libxfce4mcs-&xfce-version;">libxfce4mcs</bridgehead>
94 <para>Libxfce4mcs is a library that provides multi-channel settings management support for Xfce.</para>
95 <para>Libxfce4mcs depends on <xref linkend="libxfce4util"/>.</para>
96
97 <bridgehead renderas="sect3" id="xfce-mcs-manager"
98 xreflabel="xfce-mcs-manager-&xfce-version;">xfce-mcs-manager</bridgehead>
99 <para>Xfce-mcs-manager is a graphical settings manager for Xfce.</para>
100 <para>Xfce-mcs-manager depends on <xref linkend="libxfcegui4"/>, and
101 <xref linkend="libxfce4mcs"/>.</para>
102
103 <bridgehead renderas="sect3" id="xfce-mcs-plugins"
104 xreflabel="xfce-mcs-plugins-&xfce-version;">xfce-mcs-plugins</bridgehead>
105 <para>Xfce-mcs-plugins is a set of plugins for the multi channel settings manager.
106 With these plugins, a user can change display settings, themes, fonts and similar
107 desktop parameters.</para>
108 <para>Xfce-mcs-plugins depend on <xref linkend="libxfcegui4"/>,
109 <xref linkend="xfce-mcs-manager"/>,
110 <!-- aumix (runtime, optional, patched out below), --> and
111 <xref linkend="dbus"/> (optional, needed only at runtime, to send commands
112 to the <xref linkend="Thunar"/> file manager).</para>
113
114 <bridgehead renderas="sect3" id="xfwm4"
115 xreflabel="xfwm4-&xfce-version;">xfwm4</bridgehead>
116 <para>Xfwm4 is a window manager.</para>
117 <para>Xfwm4 depends on <xref linkend="intltool"/>,
118 <xref linkend="libxfce4util"/>,
119 <xref linkend="libxfcegui4"/>, and
120 <xref linkend="xfce-mcs-manager"/>.</para>
121
122 <bridgehead renderas="sect3" id="xfwm4-themes"
123 xreflabel="xfwm4-themes-&xfce-version;">xfwm4-themes</bridgehead>
124 <para>The xfwm4-themes package contains extra themes for xfwm4.</para>
125 <para>xfwm4-themes have no external dependencies.</para>
126
127 <bridgehead renderas="sect3" id="xfce4-panel"
128 xreflabel="xfce4-panel-&xfce-version;">xfce4-panel</bridgehead>
129 <para>Xfce4-panel is the panel for the Xfce desktop environment. It
130 contains launchers for programs, the clock, and other applets.</para>
131 <para>Xfce4-panel depends on <xref linkend="intltool"/>,
132 <xref linkend="libxfce4util"/>,and
133 <xref linkend="xfce-mcs-manager"/>.</para>
134
135 <bridgehead renderas="sect3" id="xfce4-session"
136 xreflabel="xfce4-session-&xfce-version;">xfce4-session</bridgehead>
137 <para>Xfce4-session is the session manager for the Xfce desktop environment.</para>
138 <para>Xfce4-session depends on <xref linkend="libxfce4util"/>,
139 <xref linkend="xfce-mcs-manager"/>,
140 <xref linkend="dbus"/> (optional, untested by BLFS editors, needed
141 for
142 <ulink url="http://www.freedesktop.org/wiki/Software/hal">Hal</ulink>-based
143 shutdown support, which also needs
144 <ulink url="http://hal.freedesktop.org/releases/">PolicyKit</ulink> and
145 <ulink url="http://www.freedesktop.org/wiki/Software/ConsoleKit">ConsoleKit</ulink>
146 packages, which are not in BLFS), <xref linkend="sudo"/>
147 (optional, needed at runtime for non-HAL-based shutdown support), and
148 <xref linkend="GConf"/> (optional, needed for Assistive Technologies support,
149 untested by BLFS editors).</para>
150
151 <bridgehead renderas="sect3" id="xfce4-mixer"
152 xreflabel="xfce4-mixer-&xfce-version;">xfce4-mixer</bridgehead>
153 <para>Xfce4-mixer contains an applet that controls sound volume levels.</para>
154 <para>Xfce4-mixer depends on <xref linkend="libxfcegui4"/>,
155 <xref linkend="libxfce4util"/>,
156 <xref linkend="xfce-mcs-manager"/>,
157 <xref linkend="xfce4-panel"/> (optional), and
158 <xref linkend="alsa-lib"/> (optional but highly recommended, because not all
159 controls on modern sound cards are accessible to OSS applications).</para>
160
161 <bridgehead renderas="sect3" id="gtk-xfce-engine"
162 xreflabel="gtk-xfce-engine-&gtk-xfce-engine-version;">gtk-xfce-engine</bridgehead>
163 <para>Gtk-xfce-engine contains <xref linkend="gtk2"/> themes.</para>
164 <para>Gtk-xfce-engine has no external dependencies.</para>
165
166 <bridgehead renderas="sect3" id="orage"
167 xreflabel="orage-&xfce-version;">orage</bridgehead>
168 <para>Orage is a time-managing application for the Xfce desktop environment.</para>
169 <para>Orage depends on <xref linkend="libxfce4mcs"/>,
170 <xref linkend="libxfcegui4"/>,
171 <xref linkend="xfce4-panel"/>,
172 <xref linkend="xfce-mcs-manager"/>,
173 <ulink url="http://sourceforge.net/projects/freeassociation/">libical</ulink>
174 (optional, an internal copy is used if external libical is not found,
175 external libical-0.27 is known to
176 <ulink url="http://www.nabble.com/Re:--Libical--libical-0.27-is-now-available-t3444157.html">misinterpret</ulink>
177 <!-- FIXME: what about the internal version? -->
178 daylight time saving rules in the USA), and
179 <xref linkend="db"/> (optional)</para>
180
181 <bridgehead renderas="sect3" id="xfce4-appfinder"
182 xreflabel="xfce4-appfinder-&xfce-version;">xfce4-appfinder</bridgehead>
183 <para>Xfce4-appfinder shows system-wide installed applications.</para>
184 <para>Xfce4-appfinder depends on <xref linkend="libxfcegui4"/>.</para>
185
186 <bridgehead renderas="sect3" id="xfce4-icon-theme"
187 xreflabel="xfce4-icon-theme-&xfce-version;">xfce4-icon-theme</bridgehead>
188 <para>Xfce4-icon-theme contains more than 500 48x48 and scalable icons for
189 <xref linkend="gtk2"/> applications.</para>
190 <para>Xfce4-icon-theme depends on <xref linkend="intltool"/>.</para>
191
192 <bridgehead renderas="sect3" id="exo"
193 xreflabel="exo-&exo-version;">EXO</bridgehead>
194 <para>EXO is an extension library for Xfce, targeted at application development.
195 It contains some additional <xref linkend="gtk2"/> widgets and helpers that run
196 the preferred applications.</para>
197 <para>EXO depends on <xref linkend="perl-uri"/>,
198 <xref linkend="libxfce4util"/>,
199 <xref linkend="xfce-mcs-manager"/>,
200 <ulink url="http://www.freedesktop.org/wiki/Software/hal">Hal</ulink>
201 (optional, not recommended, see explanation below),
202 <xref linkend="libnotify"/> (optional,
203 useless without
204 <ulink url="http://www.freedesktop.org/wiki/Software/hal">Hal</ulink>,
205 see explanation below), and
206 <ulink url="http://www.pygtk.org/">PyGTK</ulink> (optional, untested).</para>
207
208 <bridgehead renderas="sect3" id="Terminal"
209 xreflabel="Terminal-&Terminal-version;">Terminal</bridgehead>
210 <para>Terminal is a VT-100 terminal emulator for xfce.</para>
211 <para>Terminal depends on <xref linkend="exo"/>,
212 <xref linkend="vte"/>,
213 <xref linkend="dbus"/> (optional, with <xref linkend="glib2"/> bindings).</para>
214
215 <bridgehead renderas="sect3" id="xfprint"
216 xreflabel="xfprint-&xfce-version;">xfprint</bridgehead>
217 <para>Xfprint contains a print dialog and a printer manager for Xfce.</para>
218 <para>Xfprint depends on <xref linkend="libxfcegui4"/>, and
219 <xref linkend="xfce-mcs-manager"/>,
220 <xref linkend="a2ps"/> (optional),
221 <xref linkend="enscript"/>, and
222 <xref linkend="cups"/> or <xref linkend="LPRng"/>. Due to the use of
223 <xref linkend="a2ps"/> and <xref linkend="enscript"/>, it
224 <ulink url="http://bugzilla.xfce.org/show_bug.cgi?id=783">cannot</ulink>
225 print UTF-8 encoded text files.</para>
226
227 <bridgehead renderas="sect3" id="mousepad"
228 xreflabel="mousepad-&mousepad-version;">mousepad</bridgehead>
229 <para>Mousepad is a plain text editor for Xfce.</para>
230 <para>Mousepad depends on <xref linkend="libxfcegui4"/>, printing support requires
231 <xref linkend="xfprint"/> at runtime.</para>
232
233 <bridgehead renderas="sect3" id="xfce-utils"
234 xreflabel="xfce-utils-&xfce-version;">xfce-utils</bridgehead>
235 <para>The xfce-utils package contains files needed to start Xfce from
236 <xref linkend="gdm"/>,
237 and the <command>startxfce4</command>, <command>xfbrowser4</command>,
238 <command>xfhelp4</command>, <command>xflock4</command>
239 (needs <xref linkend="xscreensaver"/> or
240 <ulink url="http://www.tux.org/~bagleyd/xlockmore.html">xlockmore</ulink> at runtime),
241 <command>xfmountdev4</command>, <command>xfterm4</command>,
242 <command>xfce4-about</command>, and <command>xfrun</command>
243 utilities.</para>
244 <para>Xfce-utils depend on <xref linkend="xfce-mcs-manager"/>,
245 <xref linkend="libxfcegui4"/>,
246 <xref linkend="libxfce4util"/>,
247 <xref linkend="dbus"/> with <xref linkend="glib2"/> bindings (optional), and
248 <xref linkend="gdm"/> (optional, untested by BLFS editors).</para>
249
250 <bridgehead renderas="sect3" id="Thunar"
251 xreflabel="Thunar-&Thunar-version;">Thunar</bridgehead>
252 <para>Thunar is a file manager for Xfce.</para>
253 <para>Thunar depends on <xref linkend="exo"/>,
254 <xref linkend="libxfce4util"/>,
255 <xref linkend="xfce4-panel"/> (optional, for trash can support),
256 <xref linkend="libjpeg"/>,
257 <xref linkend="libexif"/> (optional, for the "Image" properties page),
258 <xref linkend="pcre"/> (optional, for the "Search &amp; Replace" renamer),
259 <!-- <xref linkend="fam"/> or --><xref linkend="gamin"/> (optional)
260 <xref linkend="dbus"/> with <xref linkend="glib2"/> bindings (optional),
261 <ulink url="http://www.freedesktop.org/wiki/Software/hal">Hal</ulink>
262 (optional, not recommended), and
263 <xref linkend="GConf"/> (optional, for support of GNOME thumbnailers,
264 untested by BLFS editors).</para>
265
266 <bridgehead renderas="sect3" id="xfdesktop"
267 xreflabel="xfdesktop-&xfce-version;">xfdesktop</bridgehead>
268 <para>The xfdesktop package contains a desktop manager for Xfce.</para>
269 <para>Xfdesktop depends on <xref linkend="intltool"/>,
270 <xref linkend="libxfce4util"/>,
271 <xref linkend="libxfcegui4"/>,
272 <xref linkend="xfce-mcs-manager"/>,
273 <xref linkend="Thunar"/> (optional, for file icons on desktop),
274 <xref linkend="dbus"/> (optional, for file icons on desktop),
275 <xref linkend="exo"/> (optional, for nifty icon effects),
276 <xref linkend="xfce4-panel"/> (optional).</para>
277
278 <bridgehead renderas="sect3" id="xfce4-dev-tools"
279 xreflabel="xfce4-dev-tools-&xfce4-dev-tools-version;">xfce4-dev-tools</bridgehead>
280 <para>The xfce4-dev-tools package contains common tools required by Xfce developers and people
281 that want to build Xfce from SVN. In addition, this package contains the
282 Xfce developer's handbook.</para>
283 <para>The xfce4-dev-tools package has no external dependencies.</para>
284
285 <bridgehead renderas="sect3" id="xfce4-unwanted">Unwanted dependencies</bridgehead>
286
287 <para>Some of Xfce components have optional dependencies on HAL. E.g.,
288 <xref linkend="exo"/> and <xref linkend="Thunar"/> use HAL as a volume
289 manager in order to mount removable media. However, HAL-based volume
290 manager is currently very buggy, so it is a good idea to disable it.</para>
291
292 <para>E.g., in non-English
293 environments, it is often needed to pass <quote>iocharset</quote>
294 and <quote>codepage</quote> mount options.
295 The need for non-default mount options also exists for English users:
296 the kernel version in LFS (2.6.22.x) has a
297 <ulink url="https://launchpad.net/bugs/133567">bug</ulink> that causes the
298 statfs(2) syscall (used in order to determine the amount of free space) to take
299 too much time (up to a minute for a filesystem on a 80 GB video iPod) unless
300 the <quote>usefree</quote> option is passed at mount time.
301 However, this is currently
302 <ulink url="http://bugzilla.xfce.org/show_bug.cgi?id=2891">impossible</ulink>
303 to achieve without adding all possible removable devices into
304 <filename>/etc/fstab</filename>, because default mount options are
305 hard-coded in the <command>exo-mount</command> program.</para>
306
307 <para>Also, the automounter throws cryptic HAL error messages at the user
308 when the user
309 <ulink url="http://bugzilla.xfce.org/show_bug.cgi?id=2968">presses
310 the Eject button on a CD-ROM drive</ulink>.</para>
311
312 <para>Installation instructions below make sure that HAL is not used as a
313 volume manager even if found.</para>
314
315 <para><xref linkend="libnotify"/> provides
316 support for desktop notifications. The only source of such notifications in
317 Xfce itself is <command>Thunar</command>, which (if compiled with HAL)
318 notifies the user when it is safe to remove the media. However, HAL
319 dependency is unwanted, as explained above. Additionally, in order to
320 actually see the notifications, one needs to compile
321 <ulink url="http://goodies.xfce.org/projects/applications/notification-daemon-xfce">notification-daemon-xfce</ulink>,
322 which depends upon <xref linkend="libsexy"/>.</para>
323
324 <para>The <command>xfce4-tips</command> command from
325 the <xref linkend="xfce4-session"/> package uses
326 <ulink url="http://www.redellipse.net/code/fortune">Fortune</ulink>
327 in order to display tips and funny quotes on startup. However,
328 it is buggy:
329 <ulink url="http://bugzilla.xfce.org/show_bug.cgi?id=2020">does not remember</ulink>
330 the preference what to display
331 (tips or quotes), and does not display non-English quotes correctly
332 in non-UTF-8 locales. For these reasons, installation of this
333 nearly-useless program is disabled below.</para>
334
335 <para condition="html" role="usernotes">User Notes:
336 <ulink url="&blfs-wiki;/xfce"/></para>
337
338 </sect2>
339
340 <sect2 role="installation">
341 <title>Installation of Xfce</title>
342
343 <para>Build and install the Xfce components in the order listed above by issuing
344 the following commands for each package:</para>
345
346<screen><userinput>sed -i '/xfce4-tips/d' Makefile.in &amp;&amp;
347./configure --prefix=/usr --sysconfdir=/etc \
348 --libexecdir=/usr/lib/xfce4 --enable-debug=no \
349 --disable-python --enable-session-screenshots \
350 --with-sound=alsa --disable-hal --with-volume-manager=none &amp;&amp;
351make</userinput></screen>
352
353 <para>Arguments that make no sense for a package (e.g.,
354 <parameter>--with-sound=alsa</parameter> for
355 <xref linkend="xfce4-dev-tools"/>) are slently ignored, and thus
356 they are harmless.</para>
357
358 <para><xref linkend="exo"/> and <xref linkend="Thunar"/> have a working testsuite.
359 To test the results, issue: <command>make check</command>. Other packages
360 either have an empty testsuite, or only tests for packaging errors.</para>
361
362 <para>If you use <xref linkend="gdm"/> as your display manager and would
363 like to be able to log into an <application>Xfce</application> session from
364 the GDM login screen, pass the <parameter>--enable-gdm</parameter> option to
365 the <application>xfce-utils</application>-&xfce-version;
366 <command>configure</command> script (requires <xref linkend="which"/> to be
367 installed at run time).</para>
368
369 <para>Also, <application>xfprint</application> can be configured with
370 <parameter>--enable-cups</parameter> if you have <xref linkend="cups"/>
371 installed.</para>
372
373 <para>After building a package, run as the <systemitem class="username">root</systemitem> user:</para>
374
375<screen role="root"><userinput>make install</userinput></screen>
376
377 <para>When all packages are built and installed,
378 as the <systemitem class="username">root</systemitem> user, move the
379 help documentation to the standard BLFS location and modify the help script to
380 look for it there:</para>
381
382<screen role="root"><userinput>mv -vf /usr/share/xfce4/doc /usr/share/doc/xfce4 &amp;&amp;
383sed -i 's@xfce4/doc@doc/xfce4@' /usr/bin/xfhelp4</userinput></screen>
384
385 <para>Run the following command as the
386 <systemitem class="username">root</systemitem> user in order
387 to change the actions bound to multimedia keys
388 to use the <command>amixer</command> command from <xref linkend="alsa-utils"/>
389 instead of the old OSS-only
390 <command>aumix</command> program:</para>
391
392<screen role="root"><userinput>sed -i 's/aumix -v\([+-]\?\)\([^"]*\)/amixer set Master \2%\1/' \
393 /usr/share/xfce-mcs-plugins/shortcuts/default.xml</userinput></screen>
394
395 <note><para>Users of Intel HD Audio onboard sound chips should replace
396 <quote>Master</quote> with <quote>PCM</quote> in the command above,
397 because such chips have no Master control.</para></note>
398
399 </sect2>
400
401 <sect2 role="commands">
402 <title>Command Explanations</title>
403
404 <para><parameter>--sysconfdir=/etc</parameter>:
405 <application>libxfce4util</application>,
406 <application>xfce4-panel</application>,
407 <application>xfdesktop</application>,
408 <application>xfce-utils</application> and
409 <application>xfce4-session</application> require this parameter
410 because the path is built into the library or they install
411 configuration files in <filename class="directory">/etc/xdg</filename>.</para>
412
413 <para><parameter>--libexecdir=/usr/lib/xfce4</parameter>:
414 <application>xfce4-session</application> requires this parameter to
415 install some utility programs to the correct location.</para>
416
417 <para><parameter>--disable-hal</parameter>: disables
418 <ulink url="http://www.freedesktop.org/wiki/Software/hal">Hal</ulink>
419 support in <xref linkend="exo"/>.</para>
420
421 <para><parameter>--with-volume-manager=none</parameter>: disables
422 <ulink url="http://www.freedesktop.org/wiki/Software/hal">Hal</ulink>
423 support in <xref linkend="Thunar"/>.</para>
424
425 <para><parameter>--disable-python</parameter>: disables building <xref linkend="python2"/>
426 bindings in <xref linkend="exo"/>.</para>
427
428 <para><parameter>--enable-session-screenshots</parameter>: allows <xref linkend="xfce4-session"/>
429 to create screenshots on logout.</para>
430
431 <para><parameter>--with-sound=alsa</parameter>: tells <xref linkend="xfce4-mixer"/>
432 to use the sound system native to Linux.</para>
433
434 <para><command>sed -i '/xfce4-tips/d' Makefile.in</command>: disables the build
435 of the useless <command>xfce4-tips</command> program.</para>
436 </sect2>
437
438 <sect2 role="configuration">
439 <title>Configuring Xfce</title>
440
441 <sect3 id='xfce-config'>
442 <title>Config files</title>
443 <para><application>Xfce</application> looks for its configuration files
444 in <filename class="directory">~/.config</filename> and
445 <filename class="directory">/etc/xdg</filename> directories. Thus, for
446 changing system-wide default preferences, create or edit files in
447 <filename class="directory">/etc/xdg</filename>, using the contents
448 of <filename class="directory">~/.config</filename> as a model.</para>
449 </sect3>
450
451 <sect3>
452 <title>Configuration Information</title>
453
454 <para><application>Xfce</application> will look for the theme index from
455 <xref linkend="hicolor-icon-theme"/> at run-time. Ensure you install the
456 package before launching <application>Xfce</application>. Also, Xfce comes
457 with SVG icons specific to it. Installation of <xref linkend="librsvg"/> is
458 required in order to avoid broken icons.</para>
459
460 <para>Issue the command below to create an <filename>.xinitrc</filename>
461 file which will automatically run the appropriate
462 <application>Xfce</application> programs when the
463 <application>X</application> Window system is launched. Be sure to backup
464 your existing <filename>.xinitrc</filename> file before
465 proceeding.</para>
466
467<screen><userinput>echo "exec startxfce4" >~/.xinitrc</userinput></screen>
468
469 <para>In order to allow all users to shut down and reboot the computer
470 from Xfce, install <xref linkend="sudo"/> and, using the
471 <command>visudo</command> command, add the following line to the
472 <filename>/etc/sudoers</filename> file:</para>
473
474<screen>ALL ALL=NOPASSWD:/usr/sbin/xfsm-shutdown-helper ""</screen>
475
476 <indexterm zone="xfce xfce-config">
477 <primary sortas="e-AA.xinitrc">~/.xinitrc</primary>
478 </indexterm>
479
480 </sect3>
481
482 </sect2>
483
484 <sect2>
485 <title>Further steps</title>
486 <para>Many useful programs, panel plugins, and themes for
487 Xfce4 are available from the
488 <ulink url="http://goodies.xfce.org/">Xfce Goodies Project</ulink>
489 web site. You may want to install:</para>
490 <itemizedlist>
491
492 <listitem><para><ulink url="http://goodies.xfce.org/projects/panel-plugins/xfce4-mount-plugin">Xfce4 mount plugin</ulink>:
493 a panel plugin that allows to mount and unmount filesystems
494 listed in <filename>/etc/fstab</filename>, and also shows
495 the amount of free disk space.</para></listitem>
496
497 <listitem><para><ulink url="http://goodies.xfce.org/projects/panel-plugins/xfce4-netload-plugin">Xfce4 Net Load plugin</ulink>:
498 a panel plugin that shows the current load of the network
499 interfaces of your choice.</para></listitem>
500
501 <listitem><para><ulink url="http://goodies.xfce.org/projects/panel-plugins/xfce4-xkb-plugin">Xfce4 XKB plugin</ulink>:
502 a panel plugin that displays the current keyboard layout
503 and allows to change it with a single mouse click.</para></listitem>
504
505<!-- uncomment when they update for libburn-0.4.0
506
507 <listitem><para><ulink url="http://www.xfce.org/projects/xfburn/">Xfburn</ulink>:
508 a data CD burner for Xfce
509 (needs <ulink url="http://libburnia.pykix.org/">libburn and libisofs</ulink>).<para></listitem>
510
511-->
512
513 <listitem><para><ulink url="http://xarchiver.xfce.org/">Xarchiver</ulink>:
514 a graphical front-end for most archivers.</para></listitem>
515
516 <listitem><para><ulink url="http://spuriousinterrupt.org/projects/xfmedia">Xfmedia</ulink>:
517 a media player based on <xref linkend="xine-lib"/>. Video support is buggy,
518 compiling with CFLAGS="-O0" may or may not help.</para></listitem>
519
520 </itemizedlist>
521 </sect2>
522
523 <sect2 role="content">
524 <title>Contents</title>
525
526 <segmentedlist>
527 <segtitle>Installed Programs</segtitle>
528 <segtitle>Installed Libraries</segtitle>
529 <segtitle>Installed Directories</segtitle>
530
531 <seglistitem>
532 <seg>more than 50 binaries and scripts</seg>
533 <seg id='xfcelibs'>libexo-0.3.{a,so},
534 libexo-hal-0.3.{a,so},
535 libthunar-vfs-1.{a,so},
536 libthunarx-1.{a,so},
537 libxfce4mcs-client.{a,so},
538 libxfce4mcs-manager.{a,so},
539 libxfce4panel.{a,so},
540 libxfce4util.{a,so},
541 libxfcegui4.{a,so},
542 libxfsm-4.2.{a,so}</seg>
543
544 <seg>/usr/lib/thunarx-1, /usr/lib/xfce4, /usr/share/doc/xfce4, /usr/share/xfce4, /usr/share/Terminal,
545 /usr/share/Thunar, /usr/share/orage, /usr/share/xfce-mcs-plugins, /usr/share/xfce4-menueditor,
546 and /usr/share/xfwm4</seg>
547 </seglistitem>
548 </segmentedlist>
549
550 </sect2>
551
552</sect1>
Note: See TracBrowser for help on using the repository browser.