From e0787664e4f1631665425c39bcda61c784e9eae2 Mon Sep 17 00:00:00 2001 From: Simon McVittie 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 --- 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". - For applications, the part of the name of the desktop file (before the .desktop) - should follow the "reverse DNS" convention, e.g. org.example.FooViewer.desktop. The - name should be a valid D-Bus well-known bus name. The valid characters (aside '.') are - [A-Z][a-z][0-9] along with dash ('-') and underscore - ('_'). Components may not begin with a digit. + For applications, the part of the name of the desktop file before the + .desktop extension should be a valid + D-Bus + well-known name. 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 [A-Za-z0-9-_]: ASCII + letters, digits, dash (U+002D HYPHEN-MINUS) and underscore + (U+005F LOW LINE). + + + The name of the desktop entry should follow the "reverse DNS" + convention, for example org.example.FooViewer, + resulting in a file named + org.example.FooViewer.desktop. -- 2.15.0.rc0