r6483 - in trunk/BOOK: general/genutils gnome/core introduction/welcome

dnicholson at linuxfromscratch.org dnicholson at linuxfromscratch.org
Mon Jan 29 21:53:35 PST 2007


Author: dnicholson
Date: 2007-01-29 22:53:34 -0700 (Mon, 29 Jan 2007)
New Revision: 6483

Modified:
   trunk/BOOK/general/genutils/desktop-file-utils.xml
   trunk/BOOK/gnome/core/gnome-menus.xml
   trunk/BOOK/introduction/welcome/changelog.xml
Log:
Fixed XDG basedir info on desktop-file-utils and gnome-menus.
Closes #2172.


Modified: trunk/BOOK/general/genutils/desktop-file-utils.xml
===================================================================
--- trunk/BOOK/general/genutils/desktop-file-utils.xml	2007-01-30 05:25:21 UTC (rev 6482)
+++ trunk/BOOK/general/genutils/desktop-file-utils.xml	2007-01-30 05:53:34 UTC (rev 6483)
@@ -36,7 +36,7 @@
     entries</ulink>. These utilities are used by
     <application>GNOME</application>-2 and other applications
     to manipulate the MIME-types application databases and help
-    adhere to the desktop entries standards specification.</para>
+    adhere to the Desktop Entry Specification.</para>
 
     <bridgehead renderas="sect3">Package Information</bridgehead>
     <itemizedlist spacing="compact">
@@ -96,13 +96,25 @@
     <sect3>
       <title>Configuration Information</title>
 
-      <para>The default location for the MIME-types application database is
-      <filename>/usr/share/applications/mimeinfo.cache</filename>. If you are
-      going to install, or have already installed, a desktop environment such
-      as <application>GNOME</application> or <application>KDE</application> in
-      a prefix other than <filename class='directory'>/usr</filename>, you'll
-      need to update the <envar>XDG_DATA_DIRS</envar> variable with your prefix
-      setting. Update the <envar>XDG_DATA_DIRS</envar> (if necessary) and
+      <!-- Background for the XDG_* settings can be found in #2172 -->
+
+      <para>The <ulink
+      url="http://freedesktop.org/wiki/Standards/basedir-spec">XDG Base
+      Directory</ulink> specification defines the standard locations for
+      applications to place data and configuration files. These files can
+      be used, for instance, to define the menu structure and menu items
+      in a desktop environment.</para>
+
+      <para>The default location for configuration files to be installed
+      is <filename class="directory">/etc/xdg</filename>, and the default
+      locations for data files are <filename
+      class="directory">/usr/local/share</filename> and <filename
+      class="directory">/usr/share</filename>. These locations can be
+      extended with the environment variables <envar>XDG_CONFIG_DIRS</envar>
+      and <envar>XDG_DATA_DIRS</envar>, respectively. The
+      <application>GNOME</application>, <application>KDE</application> and
+      <application>XFCE</application> environments respect respect these
+      settings. Update the <envar>XDG_DATA_DIRS</envar> (if necessary) and
       <envar>XDG_CONFIG_DIRS</envar> environment variables so that the
       additional MIME-types application databases and desktop menu files are
       properly maintained and discovered by adding the following to the
@@ -110,16 +122,19 @@
 
       <para>For <application>GNOME</application>:</para>
 
-<screen><literal>XDG_DATA_DIRS=/usr/share:$GNOME_PREFIX/share
-XDG_CONFIG_DIRS=/usr/share:&gnome-etc-dir;/xdg
+<screen><literal>XDG_DATA_DIRS=$GNOME_PREFIX/share:/usr/local/share:/usr/share
+XDG_CONFIG_DIRS=&gnome-etc-dir;/xdg:/etc/xdg
 export XDG_DATA_DIRS XDG_CONFIG_DIRS</literal></screen>
 
       <para>For <application>KDE</application>:</para>
 
-<screen><literal>XDG_DATA_DIRS=/usr/share:$KDE_PREFIX/share
-XDG_CONFIG_DIRS=/usr/share:/etc/kde/xdg
+<screen><literal>XDG_DATA_DIRS=$KDE_PREFIX/share:/usr/local/share:/usr/share
+XDG_CONFIG_DIRS=/etc/kde/xdg:/etc/xdg
 export XDG_DATA_DIRS XDG_CONFIG_DIRS</literal></screen>
 
+      <para>For <application>XFCE</application>, the default locations
+      should be appropriate if the instructions in the BLFS book were
+      followed.</para>
 
 <!-- This ends up messing up the menus and the GNOME and KDE stuff is simply
      not yet interchangeable
@@ -132,6 +147,16 @@
 
 -->
 
+      <para>When a package installs a <filename>.desktop</filename> file
+      to a location in one the base data directories, a database
+      mapping MIME-types to available applications can be updated. For
+      instance, the cache file at
+      <filename>/usr/share/applications/mimeinfo.cache</filename> can
+      be rebuilt by executing the following command as the <systemitem
+      class="username">root</systemitem> user:</para>
+
+<screen role="root"><userinput>update-desktop-database /usr/share/applications</userinput></screen>
+
     </sect3>
 
   </sect2>

Modified: trunk/BOOK/gnome/core/gnome-menus.xml
===================================================================
--- trunk/BOOK/gnome/core/gnome-menus.xml	2007-01-30 05:25:21 UTC (rev 6482)
+++ trunk/BOOK/gnome/core/gnome-menus.xml	2007-01-30 05:53:34 UTC (rev 6483)
@@ -122,11 +122,24 @@
         profiles as shown below (you may add additional directories, separated
         with colons, if desired):</para>
 
-<screen><literal>export XDG_CONFIG_DIRS=/usr/share:&gnome-etc-dir;/xdg</literal></screen>
+<screen><literal>export XDG_CONFIG_DIRS=&gnome-etc-dir;/xdg:/etc/xdg</literal></screen>
 
       </sect4>
 
       <sect4>
+        <title>XDG_DATA_DIRS Variable</title>
+
+        <para>So that <application>GNOME</application> can find the data
+        to populate the menus, ensure you set the <envar>XDG_DATA_DIRS</envar>
+        environment variable in the system profile, or in individual user's
+        profiles as shown below (you may add additional directories, separated
+        with colons, if desired):</para>
+
+<screen><literal>export XDG_DATA_DIRS=$GNOME_PREFIX/share:/usr/share</literal></screen>
+
+      </sect4>
+
+      <sect4>
         <title>PYTHONPATH Variable</title>
 
         <para>If your GNOME-2 installation prefix is anything other than

Modified: trunk/BOOK/introduction/welcome/changelog.xml
===================================================================
--- trunk/BOOK/introduction/welcome/changelog.xml	2007-01-30 05:25:21 UTC (rev 6482)
+++ trunk/BOOK/introduction/welcome/changelog.xml	2007-01-30 05:53:34 UTC (rev 6483)
@@ -45,6 +45,12 @@
       <para>January 29th, 2007</para>
       <itemizedlist>
         <listitem>
+          <para>[dnicholson] - Updated the desktop-file-utils page to
+          more closely reflect the XDG Base Directory Specification and
+          corrected the information on the gnome-menus page. Fixes
+          ticket #2172.</para>
+        </listitem>
+        <listitem>
           <para>[dnicholson] - Set the sysconfdir for libxfce4util, fixing
           ticket #2227.</para>
         </listitem>




More information about the blfs-book mailing list