summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorFlorian Müllner <fmuellner@gnome.org>2011-12-01 16:19:18 +0100
committerVincent Untz <vuntz@gnome.org>2011-12-19 15:17:26 +0100
commitd89604aa9dfaca71d38422303f60db7a17217fcd (patch)
tree45c3e39974bda35b561be561339709cddc5ec7a1
parent6f007183616dd13dc7e1622985a99f3401a4b1f1 (diff)
downloadxdg-specs-d89604aa9dfaca71d38422303f60db7a17217fcd.tar.xz
desktop-entry: Add an optional Keywords key
When searching through .desktop files, the existing keys meant for menu browsing may produce insufficient results; add a new optional key specifically targeting search which may be used to improve matches.
-rw-r--r--desktop-entry/desktop-entry-spec.xml23
1 files changed, 21 insertions, 2 deletions
diff --git a/desktop-entry/desktop-entry-spec.xml b/desktop-entry/desktop-entry-spec.xml
index 34bc154..01638e6 100644
--- a/desktop-entry/desktop-entry-spec.xml
+++ b/desktop-entry/desktop-entry-spec.xml
@@ -528,6 +528,19 @@
<entry>NO</entry>
<entry>1</entry>
</row>
+ <row>
+ <entry id="key-keywords"><varname>Keywords</varname></entry>
+ <entry>
+ A list of strings which may be used in addition to other
+ metadata to describe this entry. This can be useful e.g. to
+ facilitate searching through entries. The values are not meant
+ for display, and should not be redundant with the values of
+ <varname>Name</varname> or <varname>GenericName</varname>.
+ </entry>
+ <entry>localestring(s)</entry>
+ <entry>NO</entry>
+ <entry>1</entry>
+ </row>
<row>
<entry id="key-startupnotify"><varname>StartupNotify</varname></entry>
<entry>
@@ -894,8 +907,7 @@ X-KDE-ServiceType=FooService</programlisting>
<listitem>
<para>
KDE specific keys: <varname>ServiceTypes</varname>,
- <varname>DocPath</varname>, <varname>Keywords</varname>,
- <varname>InitialPreference</varname>
+ <varname>DocPath</varname>, <varname>InitialPreference</varname>
</para>
</listitem>
<listitem>
@@ -906,6 +918,13 @@ X-KDE-ServiceType=FooService</programlisting>
</listitem>
</itemizedlist>
<para>
+ KDE also used the <varname>Keywords</varname> key before it was
+ standardized, using commas instead of semi-colons as separators.
+ At the time of standardization, the field had been prefixed with a
+ <literal>X-KDE</literal> prefix, but the Trinity fork still used
+ the non-prefixed variant.
+ </para>
+ <para>
KDE uses the following additional keys for desktop entries of the
<constant>FSDevice</constant> type.
</para>