Imported Upstream version 0.22
[platform/upstream/desktop-file-utils.git] / README
1 desktop-file-utils
2 ==================
3
4 http://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   http://freedesktop.org/wiki/Specifications/desktop-entry-spec
22   http://specifications.freedesktop.org/desktop-entry-spec/desktop-entry-spec-latest.html
23
24 You may download updates to the package from:
25
26    http://www.freedesktop.org/software/desktop-file-utils/releases/
27
28 To discuss desktop-file-utils, you may use the xdg mailing list:
29
30   http://lists.freedesktop.org/mailman/listinfo/xdg
31
32
33 Installation
34 ============
35
36 See the file 'INSTALL'. If you are not using a released version of
37 desktop-file-utils (for example, if you checked out the code from git),
38 you first need to run './autogen.sh'.
39
40
41 How to report bugs
42 ==================
43
44 Bugs should be reported to the freedesktop.org bug tracking system:
45
46    https://bugs.freedesktop.org/ (product desktop-file-utils)
47
48 You will need to create an account for yourself.
49
50 Please read the following page on how to prepare a useful bug report:
51
52    https://bugs.freedesktop.org/page.cgi?id=bug-writing.html
53
54 Please read the HACKING file for information on where to send changes or
55 bugfixes for this package.