Changeset bfa83aee for general/genutils


Ignore:
Timestamp:
10/19/2012 08:00:31 PM (12 years ago)
Author:
Krejzi <krejzi@…>
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
Message:

VLC 2.0.4, mtdev 1.1.3, Desktop File Utils 0.21.

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

File:
1 edited

Legend:

Unmodified
Added
Removed
  • general/genutils/desktop-file-utils.xml

    r16aa286 rbfa83aee  
    55  %general-entities;
    66
    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">
    89  <!ENTITY desktop-file-utils-download-ftp  " ">
    9   <!ENTITY desktop-file-utils-md5sum        "8c85cbc13632ba69077c6bc41ce4d0ac">
    10   <!ENTITY desktop-file-utils-size          "124 KB">
    11   <!ENTITY desktop-file-utils-buildsize     "1.8 MB">
     10  <!ENTITY desktop-file-utils-md5sum        "fda5c312c9fb3b8d818fb54f2c34db82">
     11  <!ENTITY desktop-file-utils-size          "128 KB">
     12  <!ENTITY desktop-file-utils-buildsize     "2.0 MB">
    1213  <!ENTITY desktop-file-utils-time          "less than 0.1 SBU">
    1314]>
    1415
    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;">
    1717  <?dbhtml filename="desktop-file-utils.html"?>
    1818
     
    2525
    2626  <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>
    2828  </indexterm>
    2929
    3030  <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>
    4042
    4143    &lfs72_checked;
     
    4446    <itemizedlist spacing="compact">
    4547      <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>
    6276      </listitem>
    6377    </itemizedlist>
    6478
    65     <bridgehead renderas="sect3">desktop-file-utils Dependencies</bridgehead>
     79    <bridgehead renderas="sect3">Desktop File Utils Dependencies</bridgehead>
    6680
    6781    <bridgehead renderas="sect4">Required</bridgehead>
    68     <para role="required"><xref linkend="glib2"/></para>
     82    <para role="required">
     83      <xref linkend="glib2"/>
     84    </para>
    6985
    7086    <bridgehead renderas="sect4">Optional</bridgehead>
    71     <para role="optional"><xref linkend="emacs"/></para>
     87    <para role="optional">
     88      <xref linkend="emacs"/>
     89    </para>
    7290
    7391    <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>
    7694  </sect2>
    7795
    7896  <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>
    83103
    84104<screen><userinput>./configure --prefix=/usr &amp;&amp;
    85105make</userinput></screen>
    86106
    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>
    90114
    91115<screen role="root"><userinput>make install</userinput></screen>
     
    94118
    95119  <sect2 role="configuration">
    96     <title>Configuring desktop-file-utils</title>
     120    <title>Configuring Desktop File Utils</title>
    97121
    98122    <sect3>
    99123      <title>Configuration Information</title>
    100124
    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>
    159156
    160157<screen role="root"><userinput>update-desktop-database /usr/share/applications</userinput></screen>
     
    169166    <segmentedlist>
    170167      <segtitle>Installed Programs</segtitle>
    171       <segtitle>Installed Libraries</segtitle>
    172       <segtitle>Installed Directories</segtitle>
    173168
    174169      <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
    177174        </seg>
    178         <seg>None</seg>
    179         <seg>None</seg>
    180175      </seglistitem>
    181176    </segmentedlist>
     
    189184        <term><command>desktop-file-edit</command></term>
    190185        <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>
    192189          <indexterm zone="desktop-file-utils desktop-file-edit">
    193190            <primary sortas="b-desktop-file-edit">desktop-file-edit</primary>
     
    199196        <term><command>desktop-file-install</command></term>
    200197        <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>
    204203          <indexterm zone="desktop-file-utils desktop-file-install">
    205204            <primary sortas="b-desktop-file-install">desktop-file-install</primary>
     
    211210        <term><command>desktop-file-validate</command></term>
    212211        <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>
    214215          <indexterm zone="desktop-file-utils desktop-file-validate">
    215216            <primary sortas="b-desktop-file-validate">desktop-file-validate</primary>
     
    221222        <term><command>update-desktop-database</command></term>
    222223        <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>
    225227          <indexterm zone="desktop-file-utils update-desktop-database">
    226228            <primary sortas="b-update-desktop-database">update-desktop-database</primary>
Note: See TracChangeset for help on using the changeset viewer.