Changeset bfa83aee for general/genutils
- Timestamp:
- 10/19/2012 08:00:31 PM (12 years ago)
- Branches:
- 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
- Children:
- f55136a
- Parents:
- 16aa286
- File:
-
- 1 edited
Legend:
- Unmodified
- Added
- Removed
-
general/genutils/desktop-file-utils.xml
r16aa286 rbfa83aee 5 5 %general-entities; 6 6 7 <!ENTITY desktop-file-utils-download-http "http://freedesktop.org/software/desktop-file-utils/releases/desktop-file-utils-&desktop-file-utils-version;.tar.xz"> 7 <!ENTITY desktop-file-utils-download-http 8 "http://freedesktop.org/software/desktop-file-utils/releases/desktop-file-utils-&desktop-file-utils-version;.tar.xz"> 8 9 <!ENTITY desktop-file-utils-download-ftp " "> 9 <!ENTITY desktop-file-utils-md5sum " 8c85cbc13632ba69077c6bc41ce4d0ac">10 <!ENTITY desktop-file-utils-size "12 4KB">11 <!ENTITY desktop-file-utils-buildsize " 1.8MB">10 <!ENTITY desktop-file-utils-md5sum "fda5c312c9fb3b8d818fb54f2c34db82"> 11 <!ENTITY desktop-file-utils-size "128 KB"> 12 <!ENTITY desktop-file-utils-buildsize "2.0 MB"> 12 13 <!ENTITY desktop-file-utils-time "less than 0.1 SBU"> 13 14 ]> 14 15 15 <sect1 id="desktop-file-utils" 16 xreflabel="desktop-file-utils-&desktop-file-utils-version;"> 16 <sect1 id="desktop-file-utils" xreflabel="desktop-file-utils-&desktop-file-utils-version;"> 17 17 <?dbhtml filename="desktop-file-utils.html"?> 18 18 … … 25 25 26 26 <indexterm zone="desktop-file-utils"> 27 <primary sortas="a- Desktop-file-utils">Desktop-file-utils</primary>27 <primary sortas="a-desktop-file-utils">desktop-file-utils</primary> 28 28 </indexterm> 29 29 30 30 <sect2 role="package"> 31 <title>Introduction to desktop-file-utils</title> 32 33 <para>The <application>desktop-file-utils</application> package contains 34 command line utilities for working with <ulink 35 url="http://www.freedesktop.org/Standards/desktop-entry-spec">desktop 36 entries</ulink>. These utilities are used by Desktop Environments 37 and other applications 38 to manipulate the MIME-types application databases and help 39 adhere to the Desktop Entry Specification.</para> 31 <title>Introduction to Desktop File Utils</title> 32 33 <para> 34 The <application>Desktop File Utils</application> package contains 35 command line utilities for working with <ulink 36 url="http://www.freedesktop.org/Standards/desktop-entry-spec"> 37 Desktop entries</ulink>. These utilities are used by Desktop 38 Environments and other applications to manipulate the MIME-types 39 application databases and help adhere to the Desktop Entry 40 Specification. 41 </para> 40 42 41 43 &lfs72_checked; … … 44 46 <itemizedlist spacing="compact"> 45 47 <listitem> 46 <para>Download (HTTP): <ulink url="&desktop-file-utils-download-http;"/></para> 47 </listitem> 48 <listitem> 49 <para>Download (FTP): <ulink url="&desktop-file-utils-download-ftp;"/></para> 50 </listitem> 51 <listitem> 52 <para>Download MD5 sum: &desktop-file-utils-md5sum;</para> 53 </listitem> 54 <listitem> 55 <para>Download size: &desktop-file-utils-size;</para> 56 </listitem> 57 <listitem> 58 <para>Estimated disk space required: &desktop-file-utils-buildsize;</para> 59 </listitem> 60 <listitem> 61 <para>Estimated build time: &desktop-file-utils-time;</para> 48 <para> 49 Download (HTTP): <ulink url="&desktop-file-utils-download-http;"/> 50 </para> 51 </listitem> 52 <listitem> 53 <para> 54 Download (FTP): <ulink url="&desktop-file-utils-download-ftp;"/> 55 </para> 56 </listitem> 57 <listitem> 58 <para> 59 Download MD5 sum: &desktop-file-utils-md5sum; 60 </para> 61 </listitem> 62 <listitem> 63 <para> 64 Download size: &desktop-file-utils-size; 65 </para> 66 </listitem> 67 <listitem> 68 <para> 69 Estimated disk space required: &desktop-file-utils-buildsize; 70 </para> 71 </listitem> 72 <listitem> 73 <para> 74 Estimated build time: &desktop-file-utils-time; 75 </para> 62 76 </listitem> 63 77 </itemizedlist> 64 78 65 <bridgehead renderas="sect3"> desktop-file-utils Dependencies</bridgehead>79 <bridgehead renderas="sect3">Desktop File Utils Dependencies</bridgehead> 66 80 67 81 <bridgehead renderas="sect4">Required</bridgehead> 68 <para role="required"><xref linkend="glib2"/></para> 82 <para role="required"> 83 <xref linkend="glib2"/> 84 </para> 69 85 70 86 <bridgehead renderas="sect4">Optional</bridgehead> 71 <para role="optional"><xref linkend="emacs"/></para> 87 <para role="optional"> 88 <xref linkend="emacs"/> 89 </para> 72 90 73 91 <para condition="html" role="usernotes">User Notes: 74 <ulink url="&blfs-wiki;/desktop-file-utils"/></para>75 92 <ulink url="&blfs-wiki;/desktop-file-utils"/> 93 </para> 76 94 </sect2> 77 95 78 96 <sect2 role="installation"> 79 <title>Installation of desktop-file-utils</title> 80 81 <para>Install <application>desktop-file-utils</application> by running the 82 following commands:</para> 97 <title>Installation of Desktop File Utils</title> 98 99 <para> 100 Install <application>Desktop File Utils</application> by 101 running the following commands: 102 </para> 83 103 84 104 <screen><userinput>./configure --prefix=/usr && 85 105 make</userinput></screen> 86 106 87 <para>This package does not come with a test suite.</para> 88 89 <para>Now, as the <systemitem class="username">root</systemitem> user:</para> 107 <para> 108 This package does not come with a test suite. 109 </para> 110 111 <para> 112 Now, as the <systemitem class="username">root</systemitem> user: 113 </para> 90 114 91 115 <screen role="root"><userinput>make install</userinput></screen> … … 94 118 95 119 <sect2 role="configuration"> 96 <title>Configuring desktop-file-utils</title>120 <title>Configuring Desktop File Utils</title> 97 121 98 122 <sect3> 99 123 <title>Configuration Information</title> 100 124 101 <!-- Background for the XDG_* settings can be found in #2172 --> 102 103 <para>The <ulink 104 url="http://freedesktop.org/wiki/Standards/basedir-spec">XDG Base 105 Directory</ulink> specification defines the standard locations for 106 applications to place data and configuration files. These files can 107 be used, for instance, to define the menu structure and menu items 108 in a desktop environment.</para> 109 110 <para>The default location for configuration files to be installed 111 is <filename class="directory">/etc/xdg</filename>, and the default 112 locations for data files are <filename 113 class="directory">/usr/local/share</filename> and <filename 114 class="directory">/usr/share</filename>. These locations can be 115 extended with the environment variables <envar>XDG_CONFIG_DIRS</envar> 116 and <envar>XDG_DATA_DIRS</envar>, respectively. The 117 <application>GNOME</application>, <application>KDE</application> and 118 <application>XFCE</application> environments respect these 119 settings. Update the <envar>XDG_DATA_DIRS</envar> (if necessary) and 120 <envar>XDG_CONFIG_DIRS</envar> environment variables so that the 121 additional MIME-types application databases and desktop menu files are 122 properly maintained and discovered by adding the following to the 123 system-wide or personal profile:</para> 124 125 <para>For <application>GNOME</application>:</para> 126 127 <screen><literal>XDG_DATA_DIRS=$GNOME_PREFIX/share:/usr/local/share:/usr/share 128 XDG_CONFIG_DIRS=$GNOME_SYSCONFDIR/xdg:/etc/xdg 129 export XDG_DATA_DIRS XDG_CONFIG_DIRS</literal></screen> 130 131 <para>For <application>KDE</application>:</para> 132 133 <screen><literal>XDG_DATA_DIRS=&kde-dir;/share:/usr/local/share:/usr/share 134 XDG_CONFIG_DIRS=/etc/kde/xdg:/etc/xdg 135 export XDG_DATA_DIRS XDG_CONFIG_DIRS</literal></screen> 136 137 <para>For <application>XFCE</application>, the default locations 138 should be appropriate if the instructions in the BLFS book were 139 followed.</para> 140 141 <!-- This ends up messing up the menus and the GNOME and KDE stuff is simply 142 not yet interchangeable 143 144 <para>If you're installing both <application>GNOME</application> and 145 <application>KDE</application>:</para> 146 147 <screen><literal>XDG_DATA_DIRS=$XDG_DATA_DIRS:$GNOME_PREFIX/share:&kde-dir;/share 148 export XDG_DATA_DIRS</literal></screen> 149 150 --> 151 152 <para>When a package installs a <filename>.desktop</filename> file 153 to a location in one of the base data directories, the database 154 that maps MIME-types to available applications can be updated. For 155 instance, the cache file at 156 <filename>/usr/share/applications/mimeinfo.cache</filename> can 157 be rebuilt by executing the following command as the <systemitem 158 class="username">root</systemitem> user:</para> 125 <para> 126 The <ulink 127 url="http://freedesktop.org/wiki/Standards/basedir-spec">XDG Base 128 Directory</ulink> specification defines the standard locations for 129 applications to place data and configuration files. These files can 130 be used, for instance, to define the menu structure and menu items 131 in a desktop environment. 132 </para> 133 134 <para> 135 The default location for configuration files to be installed 136 is <filename class="directory">/etc/xdg</filename>, and the default 137 locations for data files are <filename 138 class="directory">/usr/local/share</filename> and <filename 139 class="directory">/usr/share</filename>. These locations can be 140 extended with the environment variables <envar>XDG_CONFIG_DIRS</envar> 141 and <envar>XDG_DATA_DIRS</envar>, respectively. The 142 <application>GNOME</application>, <application>KDE</application> and 143 <application>XFCE</application> environments respect these 144 settings. 145 </para> 146 147 <para> 148 When a package installs a <filename>.desktop</filename> file 149 to a location in one of the base data directories, the database 150 that maps MIME-types to available applications can be updated. For 151 instance, the cache file at 152 <filename>/usr/share/applications/mimeinfo.cache</filename> can 153 be rebuilt by executing the following command as the <systemitem 154 class="username">root</systemitem> user: 155 </para> 159 156 160 157 <screen role="root"><userinput>update-desktop-database /usr/share/applications</userinput></screen> … … 169 166 <segmentedlist> 170 167 <segtitle>Installed Programs</segtitle> 171 <segtitle>Installed Libraries</segtitle>172 <segtitle>Installed Directories</segtitle>173 168 174 169 <seglistitem> 175 <seg>desktop-file-edit, desktop-file-install, 176 desktop-file-validate, and update-desktop-database 170 <seg> 171 desktop-file-edit, desktop-file-install, 172 desktop-file-validate and 173 update-desktop-database 177 174 </seg> 178 <seg>None</seg>179 <seg>None</seg>180 175 </seglistitem> 181 176 </segmentedlist> … … 189 184 <term><command>desktop-file-edit</command></term> 190 185 <listitem> 191 <para>is used to modify an existing desktop file entry.</para> 186 <para> 187 is used to modify an existing desktop file entry. 188 </para> 192 189 <indexterm zone="desktop-file-utils desktop-file-edit"> 193 190 <primary sortas="b-desktop-file-edit">desktop-file-edit</primary> … … 199 196 <term><command>desktop-file-install</command></term> 200 197 <listitem> 201 <para>is used to install a new desktop file entry. It is 202 also used to rebuild or modify the MIME-types application 203 database.</para> 198 <para> 199 is used to install a new desktop file entry. It is 200 also used to rebuild or modify the MIME-types application 201 database. 202 </para> 204 203 <indexterm zone="desktop-file-utils desktop-file-install"> 205 204 <primary sortas="b-desktop-file-install">desktop-file-install</primary> … … 211 210 <term><command>desktop-file-validate</command></term> 212 211 <listitem> 213 <para>is used to verify the integrity of a desktop file.</para> 212 <para> 213 is used to verify the integrity of a desktop file. 214 </para> 214 215 <indexterm zone="desktop-file-utils desktop-file-validate"> 215 216 <primary sortas="b-desktop-file-validate">desktop-file-validate</primary> … … 221 222 <term><command>update-desktop-database</command></term> 222 223 <listitem> 223 <para>is used to update the MIME-types 224 application database.</para> 224 <para> 225 is used to update the MIME-types application database. 226 </para> 225 227 <indexterm zone="desktop-file-utils update-desktop-database"> 226 228 <primary sortas="b-update-desktop-database">update-desktop-database</primary>
Note:
See TracChangeset
for help on using the changeset viewer.