Bump to 0.27
[platform/upstream/desktop-file-utils.git] / README
1 desktop-file-utils
2 ==================
3
4 https://www.freedesktop.org/wiki/Software/desktop-file-utils
5
6 desktop-file-utils contains a few command line utilities for working
7 with desktop entries.
8
9 desktop-file-validate: validates a desktop file and prints warnings/errors
10                        about desktop entry specification violations.
11
12 desktop-file-install: installs a desktop file to the applications directory,
13                       optionally munging it a bit in transit.
14
15 update-desktop-database: updates the database containing a cache of
16                          MIME types handled by desktop files.
17
18 More information about desktop files and the "Desktop Entry
19 Specification" is available on:
20
21   https://freedesktop.org/wiki/Specifications/desktop-entry-spec
22   https://specifications.freedesktop.org/desktop-entry-spec/desktop-entry-spec-latest.html
23
24 You may download updates to the package from:
25
26   https://www.freedesktop.org/software/desktop-file-utils/releases/
27
28 To discuss desktop-file-utils, you may use the xdg mailing list:
29
30   https://lists.freedesktop.org/mailman/listinfo/xdg
31
32
33 Installation
34 ============
35
36 Using Meson:
37
38   meson _build
39   ninja -C _build
40   sudo ninja -C _build install
41
42
43 How to report bugs
44 ==================
45
46 Bugs should be reported to the freedesktop.org bug tracking system:
47
48    https://gitlab.freedesktop.org/xdg/desktop-file-utils/-/issues/new
49
50 You will need to create an account for yourself.
51
52 Please read the HACKING file for information on where to send changes or
53 bugfixes for this package.