Changeset e371531 for x/wm


Ignore:
Timestamp:
12/07/2007 04:32:27 PM (16 years ago)
Author:
Alexander E. Patrakov <alexander@…>
Branches:
10.0, 10.1, 11.0, 11.1, 11.2, 11.3, 12.0, 12.1, 6.3, 6.3-rc1, 6.3-rc2, 6.3-rc3, 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
Children:
0b2b70a
Parents:
60db080
Message:

Updated Xfce to version 4.4.2 and commented it out from the book.

The package is buggy and not maintenance-free, so uncomment
only if you use it and are absolutely sure that you have
enough time to update its page.

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

Location:
x/wm
Files:
2 edited

Legend:

Unmodified
Added
Removed

  • x/wm/wm.xml

    r60db080 re371531  
    5757  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="fluxbox.xml"/>
    5858  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="metacity.xml"/>
    59   <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="xfce.xml"/>
     59<!--  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="xfce.xml"/> -->
    6060  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="other-wms.xml"/>
    6161

  • x/wm/xfce.xml

    r60db080 re371531  
    55  %general-entities;
    66
    7     <!-- Inserted as a reminder to do this. The mention of a test suite
    8          is usually right before the root user installation commands. Please
    9          delete these 12 (including one blank) lines after you are done.-->
    10 
    11     <!-- Use one of the two mentions below about a test suite,
    12          delete the line that is not applicable. Of course, if the
    13          test suite uses syntax other than "make check", revise the
    14          line to reflect the actual syntax to run the test suite -->
    15 
    16     <!-- <para>This package does not come with a test suite.</para> -->
    17     <!-- <para>To test the results, issue: <command>make check</command>.</para> -->
    18 
    197  <!ENTITY xfce-download-http "http://downloads.sourceforge.net/xfce/xfce-&xfce-version;-src.tar.bz2">
    208  <!ENTITY xfce-download-ftp  " ">
    21   <!ENTITY xfce-md5sum        "44e126e47657969657ff86fb558d54ea">
    22   <!ENTITY xfce-size          "25 MB">
    23   <!ENTITY xfce-buildsize     "219 MB (to build and install everything without deleting any sources)">
    24   <!ENTITY xfce-time          "3.5 SBU">
     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
    2521]>
    2622
    27 <sect1 id="xfce" xreflabel="XFce-&xfce-version;">
     23<sect1 id="xfce" xreflabel="Xfce-&xfce-version;">
    2824  <?dbhtml filename="xfce.html" ?>
    2925
    … …  
    3329  </sect1info>
    3430
    35   <title>XFce-&xfce-version;</title>
     31  <title>Xfce-&xfce-version;</title>
    3632
    3733  <indexterm zone="xfce">
    38     <primary sortas="a-xfce">XFce</primary>
     34    <primary sortas="a-xfce">Xfce</primary>
    3935  </indexterm>
    4036
    4137  <sect2 role="package">
    42     <title>Introduction to XFce</title>
    43 
    44     <para>The <application>XFce</application> package contains a lightweight
     38    <title>Introduction to Xfce</title>
     39
     40    <para>The <application>Xfce</application> package contains a lightweight
    4541    desktop environment.</para>
    4642
    … …  
    6763    </itemizedlist>
    6864
    69     <bridgehead renderas="sect3">XFce Dependencies</bridgehead>
     65    <bridgehead renderas="sect3">Xfce General Dependencies</bridgehead>
    7066
    7167    <bridgehead renderas="sect4">Required</bridgehead>
    7268    <para role="required"><xref linkend="gtk2"/> and
    7369    <xref linkend="libxml2"/></para>
    74 
     70   
    7571    <bridgehead renderas="sect4">Optional</bridgehead>
    76     <para role="optional"><xref linkend="gdm"/>,
    77     <xref linkend="librsvg"/>
    78     (<application>xffm</application> links to <application>librsvg</application>
    79     automatically if <application>librsvg</application> is installed),
    80     <xref linkend="libgtkhtml"/>,
     72    <para role="optional"><xref linkend="libxslt"/>,
     73    <xref linkend="intltool"/>,
    8174    <xref linkend="startup-notification"/>, and
    82     <xref linkend="a2ps"/>
    83     (required to build <application>xfprint</application>).</para>
    84 
     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 <xref linkend="hal"/>-based shutdown support, which also needs
     142    <ulink url="http://hal.freedesktop.org/releases/">PolicyKit</ulink> and
     143    <ulink url="http://www.freedesktop.org/wiki/Software/ConsoleKit">ConsoleKit</ulink>
     144    packages, which are not in BLFS), <xref linkend="sudo"/>
     145    (optional, needed at runtime for non-HAL-based shutdown support), and
     146    <xref linkend="GConf"/> (optional, needed for Assistive Technologies support,
     147    untested by BLFS editors).</para>
     148
     149    <bridgehead renderas="sect3" id="xfce4-mixer"
     150      xreflabel="xfce4-mixer-&xfce-version;">xfce4-mixer</bridgehead>
     151    <para>Xfce4-mixer contains an applet that controls sound volume levels.</para>
     152    <para>Xfce4-mixer depends on <xref linkend="libxfcegui4"/>,
     153    <xref linkend="libxfce4util"/>,
     154    <xref linkend="xfce-mcs-manager"/>,
     155    <xref linkend="xfce4-panel"/> (optional), and
     156    <xref linkend="alsa-lib"/> (optional but highly recommended, because not all
     157    controls on modern sound cards are accessible to OSS applications).</para>
     158
     159    <bridgehead renderas="sect3" id="gtk-xfce-engine"
     160      xreflabel="gtk-xfce-engine-&gtk-xfce-engine-version;">gtk-xfce-engine</bridgehead>
     161    <para>Gtk-xfce-engine contains <xref linkend="gtk2"/> themes.</para>
     162    <para>Gtk-xfce-engine has no external dependencies.</para>
     163
     164    <bridgehead renderas="sect3" id="orage"
     165      xreflabel="orage-&xfce-version;">orage</bridgehead>
     166    <para>Orage is a time-managing application for the Xfce desktop environment.</para>
     167    <para>Orage depends on <xref linkend="libxfce4mcs"/>,
     168    <xref linkend="libxfcegui4"/>,
     169    <xref linkend="xfce4-panel"/>,
     170    <xref linkend="xfce-mcs-manager"/>,
     171    <ulink url="http://sourceforge.net/projects/freeassociation/">libical</ulink>
     172    (optional, an internal copy is used if external libical is not found,
     173    external libical-0.27 is known to
     174    <ulink url="http://www.nabble.com/Re:--Libical--libical-0.27-is-now-available-t3444157.html">misinterpret</ulink>
     175    <!-- FIXME: what about the internal version? -->
     176    daylight time saving rules in the USA), and
     177    <xref linkend="db"/> (optional, part of LFS).</para>
     178   
     179    <bridgehead renderas="sect3" id="xfce4-appfinder"
     180      xreflabel="xfce4-appfinder-&xfce-version;">xfce4-appfinder</bridgehead>
     181    <para>Xfce4-appfinder shows system-wide installed applications.</para>
     182    <para>Xfce4-appfinder depends on <xref linkend="libxfcegui4"/>.</para>
     183
     184    <bridgehead renderas="sect3" id="xfce4-icon-theme"
     185      xreflabel="xfce4-icon-theme-&xfce-version;">xfce4-icon-theme</bridgehead>
     186    <para>Xfce4-icon-theme contains more than 500 48x48 and scalable icons for
     187    <xref linkend="gtk2"/> applications.</para>
     188    <para>Xfce4-icon-theme depends on <xref linkend="intltool"/>.</para>
     189
     190    <bridgehead renderas="sect3" id="exo"
     191      xreflabel="exo-&exo-version;">EXO</bridgehead>
     192    <para>EXO is an extension library for Xfce, targeted at application development.
     193    It contains some additional <xref linkend="gtk2"/> widgets and helpers that run
     194    the preferred applications.</para>
     195    <para>EXO depends on <ulink url="http://cpan.org/authors/id/G/GA/GAAS/URI-1.35.tar.gz">URI-1.35</ulink>,
     196    <xref linkend="libxfce4util"/>,
     197    <xref linkend="xfce-mcs-manager"/>,
     198    <xref linkend="hal"/> (optional, not recommended, see explanation below),
     199    <ulink url="http://www.galago-project.org/">libnotify</ulink> (optional,
     200    useless without <xref linkend="hal"/>, see explanation below), and
     201    <ulink url="http://www.pygtk.org/">PyGTK</ulink> (optional, untested).</para>
     202
     203    <bridgehead renderas="sect3" id="Terminal"
     204      xreflabel="Terminal-&Terminal-version;">Terminal</bridgehead>
     205    <para>Terminal is a VT-100 terminal emulator for xfce.</para>
     206    <para>Terminal depends on <xref linkend="exo"/>,
     207    <xref linkend="vte"/>,
     208    <xref linkend="dbus"/> (optional, with <xref linkend="glib2"/> bindings).</para>
     209
     210    <bridgehead renderas="sect3" id="xfprint"
     211      xreflabel="xfprint-&xfce-version;">xfprint</bridgehead>
     212    <para>Xfprint contains a print dialog and a printer manager for Xfce.</para>
     213    <para>Xfprint depends on <xref linkend="libxfcegui4"/>, and
     214    <xref linkend="xfce-mcs-manager"/>,
     215    <xref linkend="a2ps"/> (optional),
     216    <xref linkend="enscript"/>, and
     217    <xref linkend="cups"/> or <xref linkend="LPRng"/>. Due to the use of
     218    <xref linkend="a2ps"/> and <xref linkend="enscript"/>, it
     219    <ulink url="http://bugzilla.xfce.org/show_bug.cgi?id=783">cannot</ulink>
     220    print UTF-8 encoded text files.</para>
     221
     222    <bridgehead renderas="sect3" id="mousepad"
     223      xreflabel="mousepad-&mousepad-version;">mousepad</bridgehead>
     224    <para>Mousepad is a plain text editor for Xfce.</para>
     225    <para>Mousepad depends on <xref linkend="libxfcegui4"/>, printing support requires
     226    <xref linkend="xfprint"/> at runtime.</para>
     227   
     228    <bridgehead renderas="sect3" id="xfce-utils"
     229      xreflabel="xfce-utils-&xfce-version;">xfce-utils</bridgehead>
     230    <para>The xfce-utils package contains files needed to start Xfce from
     231    <xref linkend="gdm"/>,
     232    and the <command>startxfce4</command>, <command>xfbrowser4</command>,
     233    <command>xfhelp4</command>, <command>xflock4</command>
     234    (needs <xref linkend="xscreensaver"/> or
     235    <ulink url="http://www.tux.org/~bagleyd/xlockmore.html">xlockmore</ulink> at runtime),
     236    <command>xfmountdev4</command>, <command>xfterm4</command>,
     237    <command>xfce4-about</command>, and <command>xfrun</command>
     238    utilities.</para>
     239    <para>Xfce-utils depend on <xref linkend="xfce-mcs-manager"/>,
     240    <xref linkend="libxfcegui4"/>,
     241    <xref linkend="libxfce4util"/>,
     242    <xref linkend="dbus"/> with <xref linkend="glib2"/> bindings (optional), and
     243    <xref linkend="gdm"/> (optional, untested by BLFS editors).</para>
     244   
     245    <bridgehead renderas="sect3" id="Thunar"
     246      xreflabel="Thunar-&Thunar-version;">Thunar</bridgehead>
     247    <para>Thunar is a file manager for Xfce.</para>
     248    <para>Thunar depends on <xref linkend="exo"/>,
     249    <xref linkend="libxfce4util"/>,
     250    <xref linkend="xfce4-panel"/> (optional, for trash can support),
     251    <xref linkend="libjpeg"/>,
     252    <xref linkend="libexif"/> (optional, for the "Image" properties page),
     253    <xref linkend="pcre"/> (optional, for the "Search &amp; Replace" renamer),
     254    <!-- <xref linkend="fam"/> or --><xref linkend="gamin"/> (optional)
     255    <xref linkend="dbus"/> with <xref linkend="glib2"/> bindings (optional),
     256    <xref linkend="hal"/> (optional, not recommended), and
     257    <xref linkend="GConf"/> (optional, for support of GNOME thumbnailers,
     258    untested by BLFS editors).</para>
     259   
     260    <bridgehead renderas="sect3" id="xfdesktop"
     261      xreflabel="xfdesktop-&xfce-version;">xfdesktop</bridgehead>
     262    <para>The xfdesktop package contains a desktop manager for Xfce.</para>
     263    <para>Xfdesktop depends on <xref linkend="intltool"/>,
     264    <xref linkend="libxfce4util"/>,
     265    <xref linkend="libxfcegui4"/>,
     266    <xref linkend="xfce-mcs-manager"/>,
     267    <xref linkend="Thunar"/> (optional, for file icons on desktop),
     268    <xref linkend="dbus"/> (optional, for file icons on desktop),
     269    <xref linkend="exo"/> (optional, for nifty icon effects),
     270    <xref linkend="xfce4-panel"/> (optional).</para>
     271   
     272    <bridgehead renderas="sect3" id="xfce4-dev-tools"
     273      xreflabel="xfce4-dev-tools-&xfce4-dev-tools-version;">xfce4-dev-tools</bridgehead>
     274    <para>The xfce4-dev-tools package contains common tools required by Xfce developers and people
     275    that want to build Xfce from SVN. In addition, this package contains the
     276    Xfce developer's handbook.</para>
     277    <para>The xfce4-dev-tools package has no external dependencies.</para>
     278
     279    <bridgehead renderas="sect3" id="xfce4-unwanted">Unwanted dependencies</bridgehead>
     280
     281    <para>Some of Xfce components have optional dependencies on HAL. E.g.,
     282    <xref linkend="exo"/> and <xref linkend="Thunar"/> use HAL as a volume
     283    manager in order to mount removable media. However, HAL-based volume
     284    manager is currently very buggy, so it is a good idea to disable it.</para>
     285
     286    <para>E.g., in non-English
     287    environments, it is often needed to pass <quote>iocharset</quote>
     288    and <quote>codepage</quote> mount options.
     289    The need for non-default mount options also exists for English users:
     290    the kernel version in LFS (2.6.22.x) has a
     291    <ulink url="https://launchpad.net/bugs/133567">bug</ulink> that causes the
     292    statfs(2) syscall (used in order to determine the amount of free space) to take
     293    too much time (up to a minute for a filesystem on a 80 GB video iPod) unless
     294    the <quote>usefree</quote> option is passed at mount time.
     295    However, this is currently
     296    <ulink url="http://bugzilla.xfce.org/show_bug.cgi?id=2891">impossible</ulink>
     297    to achieve without adding all possible removable devices into
     298    <filename>/etc/fstab</filename>, because default mount options are
     299    hard-coded in the <command>exo-mount</command> program.</para>
     300   
     301    <para>Also, the automounter throws cryptic HAL error messages at the user
     302    when the user
     303    <ulink url="http://bugzilla.xfce.org/show_bug.cgi?id=2968">presses
     304    the Eject button on a CD-ROM drive</ulink>.</para>
     305   
     306    <para>Installation instructions below make sure that HAL is not used as a
     307    volume manager even if found.</para>
     308   
     309    <para><ulink url="http://www.galago-project.org/">libnotify</ulink> provides
     310    support for desktop notifications. The only source of such notifications in
     311    Xfce itself is <command>Thunar</command>, which (if compiled with HAL)
     312    notifies the user when it is safe to remove the media. However, HAL
     313    dependency is unwanted, as explained above. Additionally, in order to
     314    actually see the notifications, one needs to compile
     315    <ulink url="http://goodies.xfce.org/projects/applications/notification-daemon-xfce">notification-daemon-xfce</ulink>,
     316    which depends upon <ulink url="http://www.chipx86.com/wiki/Libsexy">libsexy</ulink>.</para>
     317
     318    <para>The <command>xfce4-tips</command> command from
     319    the <xref linkend="xfce4-session"/> package uses
     320    <ulink url="http://www.redellipse.net/code/fortune">Fortune</ulink>
     321    in order to display tips and funny quotes on startup. However,
     322    it is buggy:
     323    <ulink url="http://bugzilla.xfce.org/show_bug.cgi?id=2020">does not remember</ulink>
     324    the preference what to display
     325    (tips or quotes), and does not display non-English quotes correctly
     326    in non-UTF-8 locales. For these reasons, installation of this
     327    nearly-useless program is disabled below.</para>
     328   
    85329    <para condition="html" role="usernotes">User Notes:
    86330    <ulink url="&blfs-wiki;/xfce"/></para>
    … …  
    89333
    90334  <sect2 role="installation">
    91     <title>Installation of XFce</title>
    92 
    93     <para>A bare minimum <application>XFce</application> setup requires
    94     installation of the following packages:</para>
    95 
    96     <itemizedlist spacing='compact'>
    97       <listitem>
    98         <para>libxfce4util-&xfce-version;.2</para>
    99       </listitem>
    100       <listitem>
    101         <para>dbh-1.0.24</para>
    102       </listitem>
    103       <listitem>
    104         <para>libxfcegui4-&xfce-version;</para>
    105       </listitem>
    106       <listitem>
    107         <para>libxfce4mcs-&xfce-version;</para>
    108       </listitem>
    109       <listitem>
    110         <para>xfce-mcs-manager-&xfce-version;</para>
    111       </listitem>
    112       <listitem>
    113         <para>xfwm4-&xfce-version;.2</para>
    114       </listitem>
    115       <listitem>
    116         <para>xfce4-panel-&xfce-version;</para>
    117       </listitem>
    118       <listitem>
    119         <para>xfdesktop-&xfce-version;</para>
    120       </listitem>
    121       <listitem>
    122         <para>xfce-utils-&xfce-version;</para>
    123       </listitem>
    124     </itemizedlist>
    125 
    126     <para>Install the minimum applications by issuing the following
    127     commands:</para>
    128 
    129 <screen><userinput>./configure --prefix=/usr --sysconfdir=/etc &amp;&amp;
     335    <title>Installation of Xfce</title>
     336
     337    <para>Build and install the Xfce components in the order listed above by issuing
     338    the following commands for each package:</para>
     339
     340<screen><userinput>sed -i '/xfce4-tips/d' Makefile.in &amp;&amp;
     341./configure --prefix=/usr --sysconfdir=/etc \
     342    --libexecdir=/usr/lib/xfce4 --enable-debug=no \
     343    --disable-python --enable-session-screenshots \
     344    --with-sound=alsa --disable-hal --with-volume-manager=none &amp;&amp;
    130345make</userinput></screen>
    131346
     347    <para>Arguments that make no sense for a package (e.g.,
     348    <parameter>--with-sound=alsa</parameter> for
     349    <xref linkend="xfce4-dev-tools"/>) are slently ignored, and thus
     350    they are harmless.</para>
     351   
    132352    <para>If you use <xref linkend="gdm"/> as your display manager and would
    133     like to be able to log into an <application>XFce</application> session from
    134     the login prompt, pass the <parameter>--enable-gdm</parameter> option to
     353    like to be able to log into an <application>Xfce</application> session from
     354    the GDM login screen, pass the <parameter>--enable-gdm</parameter> option to
    135355    the <application>xfce-utils</application>-&xfce-version;
    136356    <command>configure</command> script (requires <xref linkend="which"/> to be
    137357    installed at run time).</para>
    138358
    139     <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
    140 
    141 <screen role="root"><userinput>make install</userinput></screen>
    142 
    143     <para>In addition, you may choose to install:</para>
    144 
    145     <itemizedlist spacing='compact'>
    146       <listitem>
    147         <para>gtk-xfce-engine-2.2.8</para>
    148       </listitem>
    149       <listitem>
    150         <para>xfcalendar-&xfce-version;</para>
    151       </listitem>
    152       <listitem>
    153         <para>xfce-mcs-plugins-&xfce-version;</para>
    154       </listitem>
    155       <listitem>
    156         <para>xfce4-appfinder-&xfce-version;</para>
    157       </listitem>
    158       <listitem>
    159         <para>xfce4-icon-theme-&xfce-version;</para>
    160       </listitem>
    161       <listitem>
    162         <para>xfce4-iconbox-&xfce-version;</para>
    163       </listitem>
    164       <listitem>
    165         <para>xfce4-mixer-&xfce-version;</para>
    166       </listitem>
    167       <listitem>
    168         <para>xfce4-session-&xfce-version;</para>
    169       </listitem>
    170       <listitem>
    171         <para>xfce4-systray-&xfce-version;</para>
    172       </listitem>
    173       <listitem>
    174         <para>xfce4-toys-&xfce-version;</para>
    175       </listitem>
    176       <listitem>
    177         <para>xfce4-trigger-launcher-&xfce-version;</para>
    178       </listitem>
    179       <listitem>
    180         <para>xffm-&xfce-version;</para>
    181       </listitem>
    182       <listitem>
    183         <para>xfprint-&xfce-version;</para>
    184       </listitem>
    185       <listitem>
    186         <para>xfwm4-themes-&xfce-version;</para>
    187       </listitem>
    188     </itemizedlist>
    189 
    190     <para>Install the remaining applications using the following
    191     commands:</para>
    192 
    193 <screen><userinput>./configure --prefix=/usr --sysconfdir=/etc \
    194      --libexecdir=/usr/lib/xfce4 &amp;&amp;
    195 make</userinput></screen>
    196 
    197359    <para>Also, <application>xfprint</application> can be configured with
    198360    <parameter>--enable-cups</parameter> if you have <xref linkend="cups"/>
    199361    installed.</para>
    200362
    201     <para>And then as <systemitem class="username">root</systemitem>:</para>
     363    <para>After building a package, run as the <systemitem class="username">root</systemitem> user:</para>
    202364
    203365<screen role="root"><userinput>make install</userinput></screen>
    204366
    205     <para>As the <systemitem class="username">root</systemitem> user, move the
     367    <para>When all packages are built and installed,
     368    as the <systemitem class="username">root</systemitem> user, move the
    206369    help documentation to the standard BLFS location and modify the help script to
    207370    look for it there:</para>
    … …  
    209372<screen role="root"><userinput>mv -vf /usr/share/xfce4/doc /usr/share/doc/xfce4 &amp;&amp;
    210373sed -i 's@xfce4/doc@doc/xfce4@' /usr/bin/xfhelp4</userinput></screen>
     374
     375      <para>Run the following command as the
     376      <systemitem class="username">root</systemitem> user in order
     377      to change the actions bound to multimedia keys
     378      to use the <command>amixer</command> command from <xref linkend="alsa-utils"/>
     379      instead of the old OSS-only
     380      <command>aumix</command> program:</para>
     381     
     382<screen role="root"><userinput>sed -i 's/aumix -v\([+-]\?\)\([^"]*\)/amixer set Master \2%\1/' \
     383    /usr/share/xfce-mcs-plugins/shortcuts/default.xml</userinput></screen>
     384
     385      <note><para>Users of Intel HD Audio onboard sound chips should replace
     386      <quote>Master</quote> with <quote>PCM</quote> in the command above,
     387      because such chips have no Master control.</para></note>
    211388
    212389  </sect2>
    … …  
    228405    install some utility programs to the correct location.</para>
    229406
     407    <para><parameter>--disable-hal</parameter>: disables <xref linkend="hal"/>
     408    support in <xref linkend="exo"/>.</para>
     409
     410    <para><parameter>--with-volume-manager=none</parameter>: disables <xref linkend="hal"/>
     411    support in <xref linkend="Thunar"/>.</para>
     412
     413    <para><parameter>--disable-python</parameter>: disables building <xref linkend="python"/>
     414    bindings in <xref linkend="exo"/>.</para>
     415
     416    <para><parameter>--enable-session-screenshots</parameter>: allows <xref linkend="xfce4-session"/>
     417    to create screenshots on logout.</para>
     418
     419    <para><parameter>--with-sound=alsa</parameter>: tells <xref linkend="xfce4-mixer"/>
     420    to use the sound system native to Linux.</para>
     421
     422    <para><command>sed -i '/xfce4-tips/d' Makefile.in</command>: disables the build
     423    of the useless <command>xfce4-tips</command> program.</para>
    230424  </sect2>
    231425
    232426  <sect2 role="configuration">
    233     <title>Configuring XFce</title>
     427    <title>Configuring Xfce</title>
    234428
    235429    <sect3 id='xfce-config'>
     430      <title>Config files</title>
     431      <para><application>Xfce</application> looks for its configuration files
     432      in <filename class="directory">~/.config</filename> and
     433      <filename class="directory">/etc/xdg</filename> directories. Thus, for
     434      changing system-wide default preferences, create or edit files in
     435      <filename class="directory">/etc/xdg</filename>, using the contents
     436      of <filename class="directory">~/.config</filename> as a model.</para>
     437    </sect3>
     438   
     439    <sect3>
    236440      <title>Configuration Information</title>
    237441
    238       <para><application>XFce</application> will look for the theme index from
     442      <para><application>Xfce</application> will look for the theme index from
    239443      <xref linkend="hicolor-icon-theme"/> at run-time. Ensure you install the
    240       package before launching <application>XFce</application>.</para>
     444      package before launching <application>Xfce</application>. Also, Xfce comes
     445      with SVG icons specific to it. Installation of <xref linkend="librsvg"/> is
     446      required in order to avoid broken icons.</para>
    241447
    242448      <para>Issue the command below to create an <filename>.xinitrc</filename>
    243449      file which will automatically run the appropriate
    244       <application>XFce</application> programs when the
     450      <application>Xfce</application> programs when the
    245451      <application>X</application> Window system is launched. Be sure to backup
    246452      your existing <filename>.xinitrc</filename> file before
    247453      proceeding.</para>
    248454
    249 <screen><userinput>cat &gt; ~/.xinitrc &lt;&lt; "EOF"
    250 <literal>xfce-mcs-manager
    251 xfwm4 --daemon
    252 xftaskbar4 &amp;
    253 xfdesktop &amp;
    254 exec xfce4-panel</literal>
    255 EOF</userinput></screen>
     455<screen><userinput>echo "exec startxfce4" >~/.xinitrc</userinput></screen>
     456
     457      <para>In order to allow all users to shut down and reboot the computer
     458      from Xfce, install <xref linkend="sudo"/> and, using the
     459      <command>visudo</command> command, add the following line to the
     460      <filename>/etc/sudoers</filename> file:</para>
     461
     462<screen>ALL     ALL=NOPASSWD:/usr/sbin/xfsm-shutdown-helper ""</screen>
    256463
    257464      <indexterm zone="xfce xfce-config">
    … …  
    263470  </sect2>
    264471
     472  <sect2>
     473    <title>Further steps</title>
     474    <para>Many useful programs, panel plugins, and themes for
     475    Xfce4 are available from the
     476    <ulink url="http://goodies.xfce.org/">Xfce Goodies Project</ulink>
     477    web site. You may want to install:</para>
     478    <itemizedlist>
     479
     480      <listitem><para><ulink url="http://goodies.xfce.org/projects/panel-plugins/xfce4-mount-plugin">Xfce4 mount plugin</ulink>:
     481      a panel plugin that allows to mount and unmount filesystems
     482      listed in <filename>/etc/fstab</filename>, and also shows
     483      the amount of free disk space.</para></listitem>
     484
     485      <listitem><para><ulink url="http://goodies.xfce.org/projects/panel-plugins/xfce4-netload-plugin">Xfce4 Net Load plugin</ulink>:
     486      a panel plugin that shows the current load of the network
     487      interfaces of your choice.</para></listitem>
     488
     489      <listitem><para><ulink url="http://goodies.xfce.org/projects/panel-plugins/xfce4-xkb-plugin">Xfce4 XKB plugin</ulink>:
     490      a panel plugin that displays the current keyboard layout
     491      and allows to change it with a single mouse click.</para></listitem>
     492
     493<!--  uncomment when they update for libburn-0.4.0
     494
     495      <listitem><para><ulink url="http://www.xfce.org/projects/xfburn/">Xfburn</ulink>:
     496      a data CD burner for Xfce
     497      (needs <ulink url="http://libburnia.pykix.org/">libburn and libisofs</ulink>).<para></listitem>
     498
     499-->
     500
     501      <listitem><para><ulink url="http://xarchiver.xfce.org/">Xarchiver</ulink>:
     502      a graphical front-end for most archivers.</para></listitem>
     503
     504      <listitem><para><ulink url="http://spuriousinterrupt.org/projects/xfmedia">Xfmedia</ulink>:
     505      a media player based on <xref linkend="xine-lib"/>. Video support is buggy,
     506      compiling with CFLAGS="-O0" may or may not help.</para></listitem>
     507     
     508    </itemizedlist>
     509  </sect2>
     510 
    265511  <sect2 role="content">
    266512    <title>Contents</title>
    … …  
    272518
    273519      <seglistitem>
    274         <seg>fgr, scramble, startxfce4, xfbook, xfbook4, xfcalendar,
    275         xfce-mcs-manager, xfce-setting-show, xfce4-about,
    276         xfce4-appfinder, xfce4-iconbox, xfce4-kiosk-query,
    277         xfce4-menueditor, xfce4-mixer, xfce4-panel, xfce4-session,
    278         xfce4-session-logout, xfce4-tips, xfdesktop, xfdiff4, xffm,
    279         xffrequent, xffrequent4, xffstab, xffstab4, xfglob4, xfhelp4,
    280         xflock4, xfmime-edit, xfmountdev4, xfrecent, xfrecent4,
    281         xfprint-manager, xfprint4, xfrun4, xfsamba4, xftaskbar4,
    282         xfterm4, xftrash4, xftree4, and xfwm4</seg>
    283         <seg id='xfcelibs'>libxfce4util.{a,so}, libdbh.{a,so}, libxfcegui4.{a,so},
    284         libxfce4mcs.{a,so}, libxffm_actions.so, libxffm_basic.so, libxffm_calls.so,
    285         libxffm_cpy.so, libxffm_on_demand.so, libxffm_secondary.so, libxffm_tubo.so,
     520        <seg>more than 50 binaries and scripts</seg>
     521        <seg id='xfcelibs'>libexo-0.3.{a,so},
     522        libexo-hal-0.3.{a,so},
     523        libthunar-vfs-1.{a,so},
     524        libthunarx-1.{a,so},
     525        libxfce4mcs-client.{a,so},
     526        libxfce4mcs-manager.{a,so},
     527        libxfce4panel.{a,so},
     528        libxfce4util.{a,so},
     529        libxfcegui4.{a,so},
    286530        libxfsm-4.2.{a,so}</seg>
    287         <seg>/usr/lib/xfce4, /usr/share/doc/xfce4, /usr/share/xfce4, /usr/share/xffm
     531       
     532        <seg>/usr/lib/thunarx-1, /usr/lib/xfce4, /usr/share/doc/xfce4, /usr/share/xfce4, /usr/share/Terminal,
     533        /usr/share/Thunar, /usr/share/orage, /usr/share/xfce-mcs-plugins, /usr/share/xfce4-menueditor,
    288534        and /usr/share/xfwm4</seg>
    289535      </seglistitem>
    290536    </segmentedlist>
    291537
    292     <indexterm zone="xfce xfcelibs">
    293       <primary sortas="c-libxfce4util">libxfce4util.[a,so]</primary>
    294     </indexterm>
    295 
    296     <indexterm zone="xfce xfcelibs">
    297       <primary sortas="c-libdbh">libdbh.[a,so]</primary>
    298     </indexterm>
    299 
    300     <indexterm zone="xfce xfcelibs">
    301       <primary sortas="c-libxfcegui4">libxfcegui4.[a,so]</primary>
    302     </indexterm>
    303 
    304     <indexterm zone="xfce xfcelibs">
    305       <primary sortas="c-libxfce4mcs">libxfce4mcs.[a,so]</primary>
    306     </indexterm>
    307 
    308     <indexterm zone="xfce xfcelibs">
    309       <primary sortas="c-libxffm_actions.so">libxffm_actions.so</primary>
    310     </indexterm>
    311 
    312     <indexterm zone="xfce xfcelibs">
    313       <primary sortas="c-libxffm_basic.so">libxffm_basic.so</primary>
    314     </indexterm>
    315 
    316     <indexterm zone="xfce xfcelibs">
    317       <primary sortas="c-libxffm_calls.so">libxffm_calls.so</primary>
    318     </indexterm>
    319 
    320     <indexterm zone="xfce xfcelibs">
    321       <primary sortas="c-libxffm_cpy.so">libxffm_cpy.so</primary>
    322     </indexterm>
    323 
    324     <indexterm zone="xfce xfcelibs">
    325       <primary sortas="c-libxffm_on_demand.so">libxffm_on_demand.so</primary>
    326     </indexterm>
    327 
    328     <indexterm zone="xfce xfcelibs">
    329       <primary sortas="c-libxffm_secondary.so">libxffm_secondary.so</primary>
    330     </indexterm>
    331 
    332     <indexterm zone="xfce xfcelibs">
    333       <primary sortas="c-libxffm_tubo.so">libxffm_tubo.so</primary>
    334     </indexterm>
    335 
    336     <indexterm zone="xfce xfcelibs">
    337       <primary sortas="c-libxfsm-4.2.so">libxfsm-4.2.[a,so]</primary>
    338     </indexterm>
    339 
    340     <variablelist>
    341       <bridgehead renderas="sect3">Short Descriptions</bridgehead>
    342       <?dbfo list-presentation="list"?>
    343       <?dbhtml list-presentation="table"?>
    344 
    345       <varlistentry id="fgr">
    346         <term><command>fgr</command></term>
    347         <listitem>
    348           <para>is a file content search engine for
    349           <command>xffm</command>.</para>
    350           <indexterm zone="xfce fgr">
    351             <primary sortas="b-fgr">fgr</primary>
    352           </indexterm>
    353         </listitem>
    354       </varlistentry>
    355 
    356       <varlistentry id="startxfce4">
    357         <term><command>startxfce4</command></term>
    358         <listitem>
    359           <para>is a script which starts up the <application>XFce</application> Desktop
    360           Environment.</para>
    361           <indexterm zone="xfce startxfce4">
    362             <primary sortas="b-startxfce4">startxfce4</primary>
    363           </indexterm>
    364         </listitem>
    365       </varlistentry>
    366 
    367       <varlistentry id="xfce-mcs-manager">
    368         <term><command>xfce-mcs-manager</command></term>
    369         <listitem>
    370           <para>is the settings manager for
    371           <application>XFce</application>.</para>
    372           <indexterm zone="xfce xfce-mcs-manager">
    373             <primary sortas="b-xfce-mcs-manager">xfce-mcs-manager</primary>
    374           </indexterm>
    375         </listitem>
    376       </varlistentry>
    377 
    378       <varlistentry id="xfce4-about">
    379         <term><command>xfce4-about</command></term>
    380         <listitem>
    381           <para>displays the about box.</para>
    382           <indexterm zone="xfce xfce4-about">
    383             <primary sortas="b-xfce4-about">xfce4-about</primary>
    384           </indexterm>
    385         </listitem>
    386       </varlistentry>
    387 
    388       <varlistentry id="xfce4-session">
    389         <term><command>xfce4-session</command></term>
    390         <listitem>
    391           <para>saves the state of your desktop and restores it when you next start
    392           <application>XFce</application>.</para>
    393           <indexterm zone="xfce xfce4-session">
    394             <primary sortas="b-xfce4-session">xfce4-session</primary>
    395           </indexterm>
    396         </listitem>
    397       </varlistentry>
    398 
    399       <varlistentry id="xfce-setting-show">
    400         <term><command>xfce-setting-show</command></term>
    401         <listitem>
    402           <para>displays the settings for
    403           <application>XFce</application>.</para>
    404           <indexterm zone="xfce xfce-setting-show">
    405             <primary sortas="b-xfce-setting-show">xfce-setting-show</primary>
    406           </indexterm>
    407         </listitem>
    408       </varlistentry>
    409 
    410       <varlistentry id="xfce4-panel">
    411         <term><command>xfce4-panel</command></term>
    412         <listitem>
    413           <para>is the panel manager for <application>XFce</application>.
    414           It contains the launcher, clock, mail check, desktop switcher and
    415           separator programs.</para>
    416           <indexterm zone="xfce xfce4-panel">
    417             <primary sortas="b-xfce4-panel">xfce4-panel</primary>
    418           </indexterm>
    419         </listitem>
    420       </varlistentry>
    421 
    422       <varlistentry id="xfdesktop">
    423         <term><command>xfdesktop</command></term>
    424         <listitem>
    425           <para> is the desktop manager for
    426           <application>XFce</application>.</para>
    427           <indexterm zone="xfce xfdesktop">
    428             <primary sortas="b-xfdesktop">xfdesktop</primary>
    429           </indexterm>
    430         </listitem>
    431       </varlistentry>
    432 
    433       <varlistentry id="xfhelp4">
    434         <term><command>xfhelp4</command></term>
    435         <listitem>
    436           <para>is script that launches a HTML browser to
    437           display online documentation. It requires <command>which</command> to
    438           run.</para>
    439           <indexterm zone="xfce xfhelp4">
    440             <primary sortas="b-xfhelp4">xfhelp4</primary>
    441           </indexterm>
    442         </listitem>
    443       </varlistentry>
    444 
    445       <varlistentry id="xflock4">
    446         <term><command>xflock4</command></term>
    447         <listitem>
    448           <para>is a script used to lock the current screen during drag
    449           and drop actions.</para>
    450           <indexterm zone="xfce xflock4">
    451             <primary sortas="b-xflock4">xflock4</primary>
    452           </indexterm>
    453         </listitem>
    454       </varlistentry>
    455 
    456       <varlistentry id="xfmountdev4">
    457         <term><command>xfmountdev4</command></term>
    458         <listitem>
    459           <para>mounts a device on the specified mount point and launches
    460           <command>xftree4</command>, then unmounts the device when
    461           <command>xftree4</command> finishes.</para>
    462           <indexterm zone="xfce xfmountdev4">
    463             <primary sortas="b-xfmountdev4">xfmountdev4</primary>
    464           </indexterm>
    465         </listitem>
    466       </varlistentry>
    467 
    468       <varlistentry id="xfrun4">
    469         <term><command>xfrun4</command></term>
    470         <listitem>
    471           <para>is the program launcher for
    472           <application>XFce</application>.</para>
    473           <indexterm zone="xfce xfrun4">
    474             <primary sortas="b-xfrun4">xfrun4</primary>
    475           </indexterm>
    476         </listitem>
    477       </varlistentry>
    478 
    479       <varlistentry id="xfsamba4">
    480         <term><command>xfsamba4</command></term>
    481         <listitem>
    482           <para> is the <application>Samba</application> front end for
    483           <application>XFce</application>.</para>
    484           <indexterm zone="xfce xfsamba4">
    485             <primary sortas="b-xfsamba4">xfsamba4</primary>
    486           </indexterm>
    487         </listitem>
    488       </varlistentry>
    489 
    490       <varlistentry id="xftaskbar4">
    491         <term><command>xftaskbar4</command></term>
    492         <listitem>
    493           <para>is the taskbar manager for
    494           <application>XFce</application>.</para>
    495           <indexterm zone="xfce xftaskbar4">
    496             <primary sortas="b-xftaskbar4">xftaskbar4</primary>
    497           </indexterm>
    498         </listitem>
    499       </varlistentry>
    500 
    501       <varlistentry id="xfterm4">
    502         <term><command>xfterm4</command></term>
    503         <listitem>
    504           <para>is a small terminal wrapper to be used as a drag and drop
    505           action for the <application>XFce</application> front panel. It requires
    506           <command>which</command> to run.</para>
    507           <indexterm zone="xfce xfterm4">
    508             <primary sortas="b-xfterm4">xfterm4</primary>
    509           </indexterm>
    510         </listitem>
    511       </varlistentry>
    512 
    513       <varlistentry id="xftrash4">
    514         <term><command>xftrash4</command></term>
    515         <listitem>
    516           <para>is a small binary to be used as a drag and drop action for the
    517           <application>XFce</application> front panel.</para>
    518           <indexterm zone="xfce xftrash4">
    519             <primary sortas="b-xftrash4">xftrash4</primary>
    520           </indexterm>
    521         </listitem>
    522       </varlistentry>
    523 
    524       <varlistentry id="xffm">
    525         <term><command>xffm</command></term>
    526         <listitem>
    527           <para>is the file manager for <application>XFce</application>.</para>
    528           <indexterm zone="xfce xffm">
    529             <primary sortas="b-xftree4">xffm</primary>
    530           </indexterm>
    531         </listitem>
    532       </varlistentry>
    533 
    534       <varlistentry id="xfwm4">
    535         <term><command>xfwm4</command></term>
    536         <listitem>
    537           <para>is an <application>X11</application> window manager for
    538           <application>XFce</application>.</para>
    539           <indexterm zone="xfce xfwm4">
    540             <primary sortas="b-xfwm4">xfwm4</primary>
    541           </indexterm>
    542         </listitem>
    543       </varlistentry>
    544 
    545     </variablelist>
    546 
    547538  </sect2>
    548539
Note: See TracChangeset for help on using the changeset viewer.