moin2mdwn: convert page Software/desktop-file-utils

1 files changed, 173 insertions, 0 deletions

diff --git a/Software/desktop-file-utils.mdwn b/Software/desktop-file-utils.mdwn
new file mode 100644
index 00000000..b6f26f5a
--- /dev/null
+++ b/Software/desktop-file-utils.mdwn
@@ -0,0 +1,173 @@
+
+
+## desktop-file-utils
+
+desktop-file-utils contains a few command line utilities for working with [[desktop entries|Specifications/desktop-entry-spec]]: 
+
+* desktop-file-validate: validates a desktop file and prints warnings/errors about desktop entry specification violations. 
+* desktop-file-install: installs a desktop file to the applications directory, optionally munging it a bit in transit. 
+* update-desktop-database: updates the database containing a cache of MIME types handled by desktop files. 
+It requires [[GLib|http://download.gnome.org/sources/glib/]] to compile, because the implementation requires Unicode utilities and such. 
+
+
+### Development
+
+The development occurs in git, in the [[xdg/desktop-file-utils|http://cgit.freedesktop.org/xdg/desktop-file-utils/]] repository. Bugs should be reported in [[Bugzilla|https://bugs.freedesktop.org/enter_bug.cgi?product=desktop-file-utils]]. 
+
+
+### Download
+
+Tarballs can be found at [[http://www.freedesktop.org/software/desktop-file-utils/releases/|http://www.freedesktop.org/software/desktop-file-utils/releases/]] 
+
+* [[http://www.freedesktop.org/software/desktop-file-utils/releases/desktop-file-utils-0.21.tar.xz|http://www.freedesktop.org/software/desktop-file-utils/releases/desktop-file-utils-0.21.tar.xz]] 
+   * desktop-file-validate 
+      * update to current version of menu specification (Vincent): 
+         * only print hint if no main category is present, not an error 
+         * make Science a main category 
+         * add new registered categories: Adult, Feed, Humanities, Maps, Shooter, Spirituality, XFCE 
+         * update related categories 
+         * add TDE to list of registered OnlyShowIn 
+      * accept and validate GNOME3/GSettings for AutostartCondition (Vincent) 
+      * output hint if more than one main category is present (Vincent) 
+      * output hint about suggested related categories (Vincent) 
+   * misc 
+      * do not require glib >= 2.28 for build (Vincent) 
+* [[http://www.freedesktop.org/software/desktop-file-utils/releases/desktop-file-utils-0.20.tar.xz|http://www.freedesktop.org/software/desktop-file-utils/releases/desktop-file-utils-0.20.tar.xz]] 
+   * desktop-file-install 
+      * fix list of locale strings without trailing slash (Matthias Clasen) 
+   * desktop-file-validate 
+      * add MATE and Razor to list of registered environments (Vincent) 
+      * validate Desktop Actions (Giovanni Campagna, Vincent) 
+* [[http://www.freedesktop.org/software/desktop-file-utils/releases/desktop-file-utils-0.19.tar.xz|http://www.freedesktop.org/software/desktop-file-utils/releases/desktop-file-utils-0.19.tar.xz]] 
+   * desktop-file-install 
+      * respect order of edit options (Vincent) 
+      * add --add-not-show-in/--remove-not-show-in options (Vincent) 
+      * add options to set Name, [[GenericName|GenericName]], Comment, Icon keys (Vincent) 
+      * add --set-key/--set-value options to set an arbitrary key (Vincent) 
+      * remove localized keys when setting/removing a key (Vincent) 
+      * copy translations when copying a key (Vincent) 
+      * create a desktop-file-edit symlink to desktop-file-install to simply edit .desktop files (without having to pass --dir) (Vincent) 
+      * look at RPM_BUILD_ROOT to know where to install desktop files 
+      * minor UI improvements (Vincent) 
+   * desktop-file-validate 
+      * add Unity to list of registered environments (Vincent) 
+      * deal with various zz-application/zz-winassoc-XXX mime types (Vincent) 
+      * mark all zz-application/* MIME types as aliases (Vincent) 
+      * add support for updated Keywords key (Vincent) 
+   * update-desktop-database 
+      * deal with various zz-application/zz-winassoc-XXX mime types (Vincent) 
+      * mark all zz-application/* MIME types as aliases (Vincent) 
+      * ignore desktop files with Hidden=true (Vincent) 
+   * misc 
+      * modernize build system a bit (Vincent) 
+      * update man pages (Vincent) 
+* [[http://www.freedesktop.org/software/desktop-file-utils/releases/desktop-file-utils-0.18.tar.bz2|http://www.freedesktop.org/software/desktop-file-utils/releases/desktop-file-utils-0.18.tar.bz2]] 
+   * desktop-file-validate 
+      * accept x-scheme-handler/* mime types (Vincent) 
+   * update-desktop-database 
+      * sort mime types alphabetically in generated cache (Vincent) 
+      * accept x-scheme-handler/* mime types (Vincent) 
+   * misc 
+      * improve build system (Vincent) 
+      * minor documentation fixes (Vincent) 
+* [[http://www.freedesktop.org/software/desktop-file-utils/releases/desktop-file-utils-0.17.tar.bz2|http://www.freedesktop.org/software/desktop-file-utils/releases/desktop-file-utils-0.17.tar.bz2]] 
+   * desktop-file-validate 
+      * accept chemical/* mime types as valid types (Vincent) 
+      * make icon names with an extension for Icon key a non-fatal error (Vincent) 
+   * update-desktop-database 
+      * accept chemical/* mime types as valid types (Vincent) 
+      * ignore --verbose if --quiet is also passed (Vincent) 
+      * make sure to always output lists in the keyfile we generate (Vincent) 
+   * misc 
+      * improve build system (Vincent) 
+      * update documentation (Vincent) 
+      * add man pages (Vincent) 
+* [[http://www.freedesktop.org/software/desktop-file-utils/releases/desktop-file-utils-0.16.tar.bz2|http://www.freedesktop.org/software/desktop-file-utils/releases/desktop-file-utils-0.16.tar.bz2]] 
+   * desktop-file-install 
+      * do not unlink the destination file if it's the same as the source file in desktop-file-install (Vincent) 
+   * desktop-file-validate 
+      * check that a main category is included in the Categories (Vincent) 
+      * check that categories required by another one are present (Vincent) 
+      * do not always show warnings about KDE specific uses (Vincent) 
+      * check that the Comment does not look like the Name and the [[GenericName|GenericName]] (Vincent) 
+      * display error about multiple keys with the same name earlier (Vincent) 
+      * improve MIME type check to make sure that the MIME types are valid (Vincent) 
+      * add LXDE in the list of registered [[OnlyShowIn|OnlyShowIn]] values (Vincent) 
+      * add "warning" to error strings to make them easily greppable (Vincent) 
+      * handle [[AutostartCondition|AutostartCondition]] key, as proposed for the autostart specification and used in GNOME (Vincent) 
+      * accept empty Categories key as valid (Vincent) 
+      * make new errors non-fatal to give some time to maintainers to fix their .desktop file after a release of desktop-file-utils (Vincent) 
+      * plug leak (Vincent) 
+      * code cleanups (Vincent) 
+   * update-desktop-database 
+      * improve MIME type check to make sure that the MIME types are valid (Vincent) 
+      * improve error messages (Erik Hovland, Vincent) 
+      * fix format string vulnerability warning (Vincent) 
+   * misc 
+      * use AM_SILENT_RULES (Vincent) 
+      * improve build system (Vincent) 
+* [[http://www.freedesktop.org/software/desktop-file-utils/releases/desktop-file-utils-0.15.tar.gz|http://www.freedesktop.org/software/desktop-file-utils/releases/desktop-file-utils-0.15.tar.gz]] 
+   * make the extension check for Icon key a warning instead of an error for now (Ray Strode) 
+   * Fix a crash in update-desktop-database when there's no group (Vincent) 
+   * Fix a crash in the validator happening for very small lines (Vincent) 
+* [[http://www.freedesktop.org/software/desktop-file-utils/releases/desktop-file-utils-0.14.tar.gz|http://www.freedesktop.org/software/desktop-file-utils/releases/desktop-file-utils-0.14.tar.gz]] 
+   * update of the Emacs editing mode for .desktop files (Ville Skyttä) 
+   * make desktop-file-install print an error when trying to install a non-existing desktop file, or a desktop file that can't be read (Vincent) 
+   * make the validator check the content of the Icon key (Vincent) 
+   * make the validator accept X-Foo as a valid environment (this was added to the spec) (Stanislav Brabec, Vincent) 
+   * really handle the -m command line argument for desktop-file-install (Matthias Clasen) 
+   * make desktop-file-install accept as one valid argument multiple categories/only-show-in/mime-types values. Now --add-category="GNOME;GTK" works as expected. (Vincent) 
+   * make desktop-file-install validate the created desktop file before removing the original file, and unlink it if it's not valid (Vincent) 
+   * code cleanups for desktop-file-install (Vincent) 
+* [[http://www.freedesktop.org/software/desktop-file-utils/releases/desktop-file-utils-0.13.tar.gz|http://www.freedesktop.org/software/desktop-file-utils/releases/desktop-file-utils-0.13.tar.gz]] 
+   * rewrite validator, and update it for desktop entry specification 1.0. The validator should be stricter and report more useful messages. (Vincent) 
+   * add --warn-kde and --no-warn-deprecated command line options to desktop-file-validate (Vincent) 
+   * port desktop-file-install to GKeyFile (Vincent) 
+   * don't require --vendor for desktop-file-install (Vincent) 
+   * some general module cleanup (Vincent) 
+* [[http://www.freedesktop.org/software/desktop-file-utils/releases/desktop-file-utils-0.12.tar.gz|http://www.freedesktop.org/software/desktop-file-utils/releases/desktop-file-utils-0.12.tar.gz]] 
+   * improves category validation code to not catch false positives (Vincent Fretin, Ville Skyttä, Ray Strode, Vincent Untz) 
+   * make category validation code non-fatal (Ray) 
+   * fix mem leaks and double frees (Pascal Terjan) 
+* [[http://www.freedesktop.org/software/desktop-file-utils/releases/desktop-file-utils-0.11.tar.gz|http://www.freedesktop.org/software/desktop-file-utils/releases/desktop-file-utils-0.11.tar.gz]] 
+   * Validate desktop file categories (Emmet Hikory, Vincent Untz) 
+   * Use GKeyFile instead of the old egg code in update-desktop-database (Vincent) 
+   * Use GOption instead of popt (Vincent) 
+   * Fix grammar problem in one of the strings (Moritz Barsnick) 
+   * NULL terminate search patch in update-desktop-database (Mike Hearn) 
+   * Fix language to encoding mapping to match spec (Ville Skyttä) 
+* [[http://www.freedesktop.org/software/desktop-file-utils/releases/desktop-file-utils-0.10.tar.gz|http://www.freedesktop.org/software/desktop-file-utils/releases/desktop-file-utils-0.10.tar.gz]] 
+   * Remove all menus code (Mark [[McLoughlin|McLoughlin]]) 
+   * Don't try and add key/value pairs to comments (Miloslav Trmac) 
+* [[http://www.freedesktop.org/software/desktop-file-utils/releases/desktop-file-utils-0.9.tar.gz|http://www.freedesktop.org/software/desktop-file-utils/releases/desktop-file-utils-0.9.tar.gz]] 
+   * Many update-desktop-database improvements (Ray Strode,  Dan Williams) 
+   * Fix desktop-file-install --remove-only-show-in (Ray Strode) 
+* [[http://www.freedesktop.org/software/desktop-file-utils/releases/desktop-file-utils-0.8.tar.gz|http://www.freedesktop.org/software/desktop-file-utils/releases/desktop-file-utils-0.8.tar.gz]] 
+   * Fix various leaks (Kjartan Maraas) 
+   * Update with latest libegg code (Ray Strode) 
+   * Menu method work (Mark [[McLoughlin|McLoughlin]], Dan Williams) 
+      * Reload the menu when .desktop/.directory files change 
+      * Respect [[NoDisplay|NoDisplay]] in .desktop/.directory files 
+      * Remove empty submenus 
+      * Report the last modification time of the tree 
+      * Support setting the [[OnlyShowIn|OnlyShowIn]] name 
+      * Add a reasonable default set of schemes 
+* [[http://www.freedesktop.org/software/desktop-file-utils/releases/desktop-file-utils-0.7.tar.gz|http://www.freedesktop.org/software/desktop-file-utils/releases/desktop-file-utils-0.7.tar.gz]] 
+   * Add update-desktop-database (Ray Strode) 
+   * Emacs editing mode for .desktop files (Ville Skyttä) 
+   * Update to latest spec, improve error messages (Ville Skyttä) 
+   * Warning fixes (Mark [[McLoughlin|McLoughlin]]) 
+   * distcheck fixes (Jonathan Blandford) 
+* [[http://www.freedesktop.org/software/desktop-file-utils/releases/desktop-file-utils-0.6.tar.gz|http://www.freedesktop.org/software/desktop-file-utils/releases/desktop-file-utils-0.6.tar.gz]] 
+   * Bring up to date with version 0.8 of the menu spec 
+   * Don't crash when a .desktop file is a symlink to a non-existant file 
+* [[http://www.freedesktop.org/software/desktop-file-utils/releases/desktop-file-utils-0.5.tar.gz|http://www.freedesktop.org/software/desktop-file-utils/releases/desktop-file-utils-0.5.tar.gz]] 
+   * Don't segfault with .desktop files which have a leading comment 
+* [[http://www.freedesktop.org/software/desktop-file-utils/releases/desktop-file-utils-0.4.tar.gz|http://www.freedesktop.org/software/desktop-file-utils/releases/desktop-file-utils-0.4.tar.gz]] 
+   * Add support for "Desktop Action" sections 
+* [[http://www.freedesktop.org/software/desktop-file-utils/releases/desktop-file-utils-0.3.tar.gz|http://www.freedesktop.org/software/desktop-file-utils/releases/desktop-file-utils-0.3.tar.gz]] 
+   * Create target dir of desktop-file-install if nonexistent; improve some error messages; fix [[OnlyShowIn|OnlyShowIn]] handling; add --print-available option to dump desktop files being considered by desktop-menu-tool; rename obsolete [KDE Desktop Entry] section if found; fix a crash; verify proper spelling of KDE and GNOME in [[OnlyShowIn|OnlyShowIn]]; add a --remove-key option; check that string lists end in a semicolon; add --copy-name-to-generic-name and vice versa; fix bug in --delete-original that made it not work 
+* [[http://www.freedesktop.org/software/desktop-file-utils/releases/desktop-file-utils-0.2.tar.gz|http://www.freedesktop.org/software/desktop-file-utils/releases/desktop-file-utils-0.2.tar.gz]] 
+   * Adds desktop-menu-tool to parse vfolder menus and generate a symlink tree or just print them out. 
+* [[http://www.freedesktop.org/software/desktop-file-utils/releases/desktop-file-utils-0.1.tar.gz|http://www.freedesktop.org/software/desktop-file-utils/releases/desktop-file-utils-0.1.tar.gz]] 
+   * Initial release. Contains desktop-file-validate and desktop-file-install. 
\ No newline at end of file