source: general/genutils/desktop-file-utils.xml@ 879932f

10.0 10.1 11.0 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind ken/refactor-virt lazarus perl-modules qt5new trunk xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since 879932f was 879932f, checked in by Douglas R. Reno <renodr@…>, 5 years ago

Archive setuptools
Modify Python instructions to add setuptools and pip as part of the installation
Tags for the Python section + a few others

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

  • Property mode set to 100644
File size: 7.8 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
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">
9 <!ENTITY desktop-file-utils-download-ftp " ">
10 <!ENTITY desktop-file-utils-md5sum "599133d51cc9a41bfec186414906b6f1">
11 <!ENTITY desktop-file-utils-size "132 KB">
12 <!ENTITY desktop-file-utils-buildsize "1.9 MB">
13 <!ENTITY desktop-file-utils-time "less than 0.1 SBU">
14]>
15
16<sect1 id="desktop-file-utils" xreflabel="desktop-file-utils-&desktop-file-utils-version;">
17 <?dbhtml filename="desktop-file-utils.html"?>
18
19 <sect1info>
20 <othername>$LastChangedBy$</othername>
21 <date>$Date$</date>
22 </sect1info>
23
24 <title>desktop-file-utils-&desktop-file-utils-version;</title>
25
26 <indexterm zone="desktop-file-utils">
27 <primary sortas="a-desktop-file-utils">desktop-file-utils</primary>
28 </indexterm>
29
30 <sect2 role="package">
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://standards.freedesktop.org/desktop-entry-spec/latest/">
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>
42
43 &lfs80_checked;
44
45 <bridgehead renderas="sect3">Package Information</bridgehead>
46 <itemizedlist spacing="compact">
47 <listitem>
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>
76 </listitem>
77 </itemizedlist>
78
79 <bridgehead renderas="sect3">Desktop File Utils Dependencies</bridgehead>
80
81 <bridgehead renderas="sect4">Required</bridgehead>
82 <para role="required">
83 <xref linkend="glib2"/>
84 </para>
85
86 <bridgehead renderas="sect4">Optional</bridgehead>
87 <para role="optional">
88 <xref linkend="emacs"/>
89 </para>
90
91 <para condition="html" role="usernotes">User Notes:
92 <ulink url="&blfs-wiki;/desktop-file-utils"/>
93 </para>
94 </sect2>
95
96 <sect2 role="installation">
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>
103
104<screen><userinput>./configure --prefix=/usr &amp;&amp;
105make</userinput></screen>
106
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>
114
115<screen role="root"><userinput>make install</userinput></screen>
116
117 </sect2>
118
119 <sect2 role="configuration">
120 <title>Configuring Desktop File Utils</title>
121
122 <sect3>
123 <title>Configuration Information</title>
124
125 <para>
126 The <ulink
127 url="http://standards.freedesktop.org/basedir-spec/basedir-spec-latest.html">XDG
128 Base Directory</ulink> specification defines the standard locations for
129 applications to place data and configuration files. These files can be
130 used, for instance, to define the menu structure and menu items in a
131 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>
156
157<screen role="root"><userinput>update-desktop-database /usr/share/applications</userinput></screen>
158
159 </sect3>
160
161 </sect2>
162
163 <sect2 role="content">
164 <title>Contents</title>
165
166 <segmentedlist>
167 <segtitle>Installed Programs</segtitle>
168 <segtitle>Installed Libraries</segtitle>
169 <segtitle>Installed Directories</segtitle>
170
171 <seglistitem>
172 <seg>
173 desktop-file-edit, desktop-file-install,
174 desktop-file-validate and
175 update-desktop-database
176 </seg>
177 <seg>
178 None
179 </seg>
180 <seg>
181 None
182 </seg>
183 </seglistitem>
184 </segmentedlist>
185
186 <variablelist>
187 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
188 <?dbfo list-presentation="list"?>
189 <?dbhtml list-presentation="table"?>
190
191 <varlistentry id="desktop-file-edit">
192 <term><command>desktop-file-edit</command></term>
193 <listitem>
194 <para>
195 is used to modify an existing desktop file entry.
196 </para>
197 <indexterm zone="desktop-file-utils desktop-file-edit">
198 <primary sortas="b-desktop-file-edit">desktop-file-edit</primary>
199 </indexterm>
200 </listitem>
201 </varlistentry>
202
203 <varlistentry id="desktop-file-install">
204 <term><command>desktop-file-install</command></term>
205 <listitem>
206 <para>
207 is used to install a new desktop file entry. It is
208 also used to rebuild or modify the MIME-types application
209 database.
210 </para>
211 <indexterm zone="desktop-file-utils desktop-file-install">
212 <primary sortas="b-desktop-file-install">desktop-file-install</primary>
213 </indexterm>
214 </listitem>
215 </varlistentry>
216
217 <varlistentry id="desktop-file-validate">
218 <term><command>desktop-file-validate</command></term>
219 <listitem>
220 <para>
221 is used to verify the integrity of a desktop file.
222 </para>
223 <indexterm zone="desktop-file-utils desktop-file-validate">
224 <primary sortas="b-desktop-file-validate">desktop-file-validate</primary>
225 </indexterm>
226 </listitem>
227 </varlistentry>
228
229 <varlistentry id="update-desktop-database">
230 <term><command>update-desktop-database</command></term>
231 <listitem>
232 <para>
233 is used to update the MIME-types application database.
234 </para>
235 <indexterm zone="desktop-file-utils update-desktop-database">
236 <primary sortas="b-update-desktop-database">update-desktop-database</primary>
237 </indexterm>
238 </listitem>
239 </varlistentry>
240 </variablelist>
241
242 </sect2>
243
244</sect1>
Note: See TracBrowser for help on using the repository browser.