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

12.0 12.1 kea ken/TL2024 ken/tuningfonts lazarus lxqt plabs/newcss python3.11 rahul/power-profiles-daemon renodr/vulkan-addition trunk xry111/llvm18 xry111/xf86-video-removal
Last change on this file since cb594b6c was cb594b6c, checked in by Xi Ruoyao <xry111@…>, 12 months ago

general: Remove non-exist User Notes link

Part of User Notes removal by
​https://www.linuxfromscratch.org/~xry111/remove-nonexist-usernote.sh
  • Property mode set to 100644
File size: 9.0 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 "https://www.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 "29739e005f5887cf41639b8450f3c23f">
11 <!ENTITY desktop-file-utils-size "84 KB">
12 <!ENTITY desktop-file-utils-buildsize "1.8 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
20 <title>desktop-file-utils-&desktop-file-utils-version;</title>
21
22 <indexterm zone="desktop-file-utils">
23 <primary sortas="a-desktop-file-utils">desktop-file-utils</primary>
24 </indexterm>
25
26 <sect2 role="package">
27 <title>Introduction to Desktop File Utils</title>
28
29 <para>
30 The <application>Desktop File Utils</application> package contains
31 command line utilities for working with <ulink
32 url="https://standards.freedesktop.org/desktop-entry-spec/latest/">
33 Desktop entries</ulink>. These utilities are used by Desktop
34 Environments and other applications to manipulate the MIME-types
35 application databases and help adhere to the Desktop Entry
36 Specification.
37 </para>
38
39 &lfs113_checked;
40
41 <bridgehead renderas="sect3">Package Information</bridgehead>
42 <itemizedlist spacing="compact">
43 <listitem>
44 <para>
45 Download (HTTP): <ulink url="&desktop-file-utils-download-http;"/>
46 </para>
47 </listitem>
48 <listitem>
49 <para>
50 Download (FTP): <ulink url="&desktop-file-utils-download-ftp;"/>
51 </para>
52 </listitem>
53 <listitem>
54 <para>
55 Download MD5 sum: &desktop-file-utils-md5sum;
56 </para>
57 </listitem>
58 <listitem>
59 <para>
60 Download size: &desktop-file-utils-size;
61 </para>
62 </listitem>
63 <listitem>
64 <para>
65 Estimated disk space required: &desktop-file-utils-buildsize;
66 </para>
67 </listitem>
68 <listitem>
69 <para>
70 Estimated build time: &desktop-file-utils-time;
71 </para>
72 </listitem>
73 </itemizedlist>
74
75 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
76 <itemizedlist spacing="compact">
77 <listitem>
78 <para>
79 Required patch:
80 <ulink url="&patch-root;/desktop-file-utils-&desktop-file-utils-version;-update_standard-1.patch"/>
81 </para>
82 </listitem>
83 </itemizedlist>
84
85 <bridgehead renderas="sect3">Desktop File Utils Dependencies</bridgehead>
86
87 <bridgehead renderas="sect4">Required</bridgehead>
88 <para role="required">
89 <xref linkend="glib2"/>
90 </para>
91
92 <bridgehead renderas="sect4">Optional</bridgehead>
93 <para role="optional">
94 <xref linkend="emacs"/>
95 </para>
96
97 </sect2>
98
99 <sect2 role="installation">
100 <title>Installation of Desktop File Utils</title>
101
102 <warning>
103 <para>
104 If you are upgrading from a previous version of desktop-file-utils that
105 used the Autotools method of installing and configuring the package,
106 you must remove the desktop-file-edit symlink by using the following
107 commands.
108 </para>
109 </warning>
110 <!-- Works around a bug in meson's symlink creation exposed by this package -->
111
112<screen role="root"><userinput>rm -fv /usr/bin/desktop-file-edit</userinput></screen>
113
114 <para>
115 Next, update the version of the desktop file standard to accept the
116 SingleMainWindow key:
117 </para>
118
119<screen><userinput remap="pre">patch -Np1 -i ../desktop-file-utils-&desktop-file-utils-version;-update_standard-1.patch</userinput></screen>
120
121 <para>
122 Install <application>Desktop File Utils</application> by
123 running the following commands:
124 </para>
125
126<screen><userinput>mkdir build &amp;&amp;
127cd build &amp;&amp;
128
129meson setup --prefix=/usr --buildtype=release .. &amp;&amp;
130ninja</userinput></screen>
131
132 <para>
133 This package does not come with a test suite.
134 </para>
135
136 <para>
137 Now, as the <systemitem class="username">root</systemitem> user:
138 </para>
139
140<screen role="root"><userinput>ninja install</userinput></screen>
141
142 </sect2>
143
144 <sect2 role="commands">
145 <title>Command Explanations</title>
146
147 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
148 href="../../xincludes/meson-buildtype-release.xml"/>
149 </sect2>
150
151 <sect2 role="configuration">
152 <title>Configuring Desktop File Utils</title>
153
154 <sect3>
155 <title>Configuration Information</title>
156
157 <para>
158 The <ulink
159 url="https://standards.freedesktop.org/basedir-spec/basedir-spec-latest.html">XDG
160 Base Directory</ulink> specification defines the standard locations for
161 applications to place data and configuration files. These files can be
162 used, for instance, to define the menu structure and menu items in a
163 desktop environment.
164 </para>
165
166 <para>
167 The default location for configuration files to be installed
168 is <filename class="directory">/etc/xdg</filename>, and the default
169 locations for data files are <filename
170 class="directory">/usr/local/share</filename> and <filename
171 class="directory">/usr/share</filename>. These locations can be
172 extended with the environment variables <envar>XDG_CONFIG_DIRS</envar>
173 and <envar>XDG_DATA_DIRS</envar>, respectively. The
174 <application>GNOME</application>, <application>KDE</application> and
175 <application>XFCE</application> environments respect these
176 settings.
177 </para>
178
179 <para>
180 When a package installs a <filename>.desktop</filename> file
181 to a location in one of the base data directories, the database
182 that maps MIME-types to available applications can be updated. For
183 instance, the cache file at
184 <filename>/usr/share/applications/mimeinfo.cache</filename> can
185 be rebuilt by executing the following command as the <systemitem
186 class="username">root</systemitem> user:
187 </para>
188
189<screen role="root"><userinput>install -vdm755 /usr/share/applications &amp;&amp;
190update-desktop-database /usr/share/applications</userinput></screen>
191
192 </sect3>
193
194 </sect2>
195
196 <sect2 role="content">
197 <title>Contents</title>
198
199 <segmentedlist>
200 <segtitle>Installed Programs</segtitle>
201 <segtitle>Installed Libraries</segtitle>
202 <segtitle>Installed Directories</segtitle>
203
204 <seglistitem>
205 <seg>
206 desktop-file-edit, desktop-file-install,
207 desktop-file-validate and
208 update-desktop-database
209 </seg>
210 <seg>
211 None
212 </seg>
213 <seg>
214 None
215 </seg>
216 </seglistitem>
217 </segmentedlist>
218
219 <variablelist>
220 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
221 <?dbfo list-presentation="list"?>
222 <?dbhtml list-presentation="table"?>
223
224 <varlistentry id="desktop-file-edit">
225 <term><command>desktop-file-edit</command></term>
226 <listitem>
227 <para>
228 is used to modify an existing desktop file entry
229 </para>
230 <indexterm zone="desktop-file-utils desktop-file-edit">
231 <primary sortas="b-desktop-file-edit">desktop-file-edit</primary>
232 </indexterm>
233 </listitem>
234 </varlistentry>
235
236 <varlistentry id="desktop-file-install">
237 <term><command>desktop-file-install</command></term>
238 <listitem>
239 <para>
240 is used to install a new desktop file entry. It is
241 also used to rebuild or modify the MIME-types application
242 database
243 </para>
244 <indexterm zone="desktop-file-utils desktop-file-install">
245 <primary sortas="b-desktop-file-install">desktop-file-install</primary>
246 </indexterm>
247 </listitem>
248 </varlistentry>
249
250 <varlistentry id="desktop-file-validate">
251 <term><command>desktop-file-validate</command></term>
252 <listitem>
253 <para>
254 is used to verify the integrity of a desktop file
255 </para>
256 <indexterm zone="desktop-file-utils desktop-file-validate">
257 <primary sortas="b-desktop-file-validate">desktop-file-validate</primary>
258 </indexterm>
259 </listitem>
260 </varlistentry>
261
262 <varlistentry id="update-desktop-database">
263 <term><command>update-desktop-database</command></term>
264 <listitem>
265 <para>
266 is used to update the MIME-types application database
267 </para>
268 <indexterm zone="desktop-file-utils update-desktop-database">
269 <primary sortas="b-update-desktop-database">update-desktop-database</primary>
270 </indexterm>
271 </listitem>
272 </varlistentry>
273 </variablelist>
274
275 </sect2>
276
277</sect1>
Note: See TracBrowser for help on using the repository browser.