diff options
Diffstat (limited to 'desktop-entry/desktop-entry-spec.xml')
-rw-r--r-- | desktop-entry/desktop-entry-spec.xml | 44 |
1 files changed, 44 insertions, 0 deletions
diff --git a/desktop-entry/desktop-entry-spec.xml b/desktop-entry/desktop-entry-spec.xml index 1f02d95..d3879f2 100644 --- a/desktop-entry/desktop-entry-spec.xml +++ b/desktop-entry/desktop-entry-spec.xml @@ -61,6 +61,15 @@ </address> </affiliation> </author> + <author> + <firstname>David</firstname> + <surname>Faure</surname> + <affiliation> + <address> + <email>faure@kde.org</email> + </address> + </affiliation> + </author> </authorgroup> </articleinfo> @@ -1475,4 +1484,39 @@ Icon=fooview-new the name as it appears in the "Encoding" column above. </para> </appendix> + <appendix id="desktop-file-id"> + <title>Desktop File ID</title> + <para> + The desktop file ID is the identifier of an installed desktop entry file. + </para> + <para> + To determine the ID of a desktop file, make its full path relative to + the <literal>$XDG_DATA_DIRS</literal> component in which the desktop file is installed, remove the "applications/" + prefix, and turn '/' into '-'. + </para> + <para> + For example <filename>/usr/share/applications/foo/bar.desktop</filename> has + the desktop file ID <literal>foo-bar.desktop</literal>. + </para> + <para> + If multiple files have the same desktop file ID, the first one in the + $XDG_DATA_DIRS precedence order is used. + </para> + <para> + For example, if <literal>$XDG_DATA_DIRS</literal> contains the default paths /usr/local/share:/usr/share, then + <filename>/usr/local/share/applications/org.foo.bar.desktop</filename> and + <filename>/usr/share/applications/org.foo.bar.desktop</filename> both have + the same desktop file ID <literal>org.foo.bar.desktop</literal>, but only the first + one will be used. + </para> + <para> + If both <filename>foo-bar.desktop</filename> and <filename>foo/bar.desktop</filename> exist, + it is undefined which is selected. + </para> + <para> + If the desktop file is not installed in an <literal>applications</literal> subdirectory of one + of the $XDG_DATA_DIRS components, it does not have an ID. + </para> + </appendix> + </article> |