Attachment 134790 Details for Bug 103216 – desktop-entry-spec: Formalize file naming recommendations

[patch] desktop-entry-spec: Formalize file naming recommendations

0002-desktop-entry-spec-Formalize-file-naming-recommendat.patch (text/plain), 2.33 KB, created by Simon McVittie on 2017-10-11 10:28:45 UTC

(hide)

Description:

Filename:

MIME Type:

Creator: Simon McVittie

Created: 2017-10-11 10:28:45 UTC

Size: 2.33 KB

patch

obsolete

>From e0787664e4f1631665425c39bcda61c784e9eae2 Mon Sep 17 00:00:00 2001
>From: Simon McVittie <smcv@debian.org>
>Date: Wed, 11 Oct 2017 10:55:58 +0100
>Subject: [PATCH 2/4] desktop-entry-spec: Formalize file naming recommendations
>
>* Add a link to the canonical definition of a D-Bus well-known name
>* Specify punctuation in terms of Unicode code points
>* Split syntactic rules (character set) and semantic rules
>  (relationship to domain names) into separate paragraphs
>
>Signed-off-by: Simon McVittie <smcv@debian.org>
>---
> desktop-entry/desktop-entry-spec.xml | 20 +++++++++++++++-----
> 1 file changed, 15 insertions(+), 5 deletions(-)
>
>diff --git a/desktop-entry/desktop-entry-spec.xml b/desktop-entry/desktop-entry-spec.xml
>index 9d0b5f5..346d41b 100644
>--- a/desktop-entry/desktop-entry-spec.xml
>+++ b/desktop-entry/desktop-entry-spec.xml
>@@ -97,11 +97,21 @@
>       fall back to recognition via "magic detection".
>     </para>
>     <para>
>-      For applications, the part of the name of the desktop file (before the <filename>.desktop</filename>)
>-      should follow the "reverse DNS" convention, e.g. <literal>org.example.FooViewer.desktop</literal>.  The
>-      name should be a valid D-Bus well-known bus name.  The valid characters (aside '<literal>.</literal>') are
>-      <literal>[A-Z][a-z][0-9]</literal> along with dash ('<literal>-</literal>') and underscore
>-      ('<literal>_</literal>').  Components may not begin with a digit.
>+      For applications, the part of the name of the desktop file before the
>+      <filename>.desktop</filename> extension should be a valid
>+      <ulink url="https://dbus.freedesktop.org/doc/dbus-specification.html#message-protocol-names">D-Bus
>+        well-known name</ulink>. This means that it is a sequence of
>+      non-empty elements separated by dots (U+002E FULL STOP), none of
>+      which starts with a digit, and each of which contains only
>+      characters from the set <literal>[A-Za-z0-9-_]</literal>: ASCII
>+      letters, digits, dash (U+002D HYPHEN-MINUS) and underscore
>+      (U+005F LOW LINE).
>+    </para>
>+    <para>
>+      The name of the desktop entry should follow the "reverse DNS"
>+      convention, for example <literal>org.example.FooViewer</literal>,
>+      resulting in a file named
>+      <literal>org.example.FooViewer.desktop</literal>.
>     </para>
> 
>     <sect2 id="desktop-file-id">
>-- 
>2.15.0.rc0
>

Actions: View | Splinter Review

Attachments on bug 103216: 134789 | 134790 | 134791 | 134792

Use of freedesktop.org services, including Bugzilla, is subject to our Code of Conduct. How we collect and use information is described in our Privacy Policy.