changeset 605:860ab66f5f71

vanilla: add documentation about .desktop files
author David Demelier <markand@malikania.fr>
date Mon, 15 Jul 2019 20:10:00 +0200
parents ec4819b1579a
children 25cecc6dca48
files HOWTO.md
diffstat 1 files changed, 13 insertions(+), 0 deletions(-) [+]
line wrap: on
line diff
--- a/HOWTO.md	Tue Jul 16 21:22:48 2019 +0200
+++ b/HOWTO.md	Mon Jul 15 20:10:00 2019 +0200
@@ -355,3 +355,16 @@
     rm -f $DESTDIR/lib/libfoo.la
 
 Assuming the package is "foo".
+
+# Desktop files
+
+We usually never add .desktop files for any package that doesn't provide one by
+itself. This also includes terminal based applications.
+
+If a .desktop is provided by the package, make sure though that it is valid and
+specifies the appropriate category (i.e. it does not appear in multiple menus at
+once).
+
+See [desktop entry specification][] for more information.
+
+[desktop entry specification]: https://specifications.freedesktop.org/desktop-entry-spec/latest