Changeset 99c190b for general

Timestamp:

01/30/2007 05:53:34 AM (17 years ago)

Author:

Dan Nichilson <dnicholson@…>

Branches:

10.0, 10.1, 11.0, 11.1, 11.2, 11.3, 12.0, 12.1, 6.2, 6.2.0, 6.2.0-rc1, 6.2.0-rc2, 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:

c15c739

Parents:

b2287935

Message:

Fixed XDG basedir info on desktop-file-utils and gnome-menus.
Closes #2172.

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

File:

• general/genutils/desktop-file-utils.xml (modified) (4 diffs)

general/genutils/desktop-file-utils.xml

@@ -37 +37 @@
     <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>
@@ -97 +97 @@
       <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
@@ -111 +123 @@
       <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
@@ -132 +147 @@
 
 -->
+
+      <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>