From 573aa0110a47bd4566c6597c5af40687b02eab59 Mon Sep 17 00:00:00 2001
From: Simon McVittie <smcv@debian.org>
Date: Wed, 11 Oct 2017 11:00:26 +0100
Subject: [PATCH 3/4] desktop-entry-spec: Formalize the reverse DNS convention

Also mention the D-Bus convention for the part after the domain name,
which is widely deployed and seems as good as anything else.

Signed-off-by: Simon McVittie <smcv@debian.org>
---
 desktop-entry/desktop-entry-spec.xml | 11 ++++++++---
 1 file changed, 8 insertions(+), 3 deletions(-)

diff --git a/desktop-entry/desktop-entry-spec.xml b/desktop-entry/desktop-entry-spec.xml
index 346d41b..63c4a70 100644
--- a/desktop-entry/desktop-entry-spec.xml
+++ b/desktop-entry/desktop-entry-spec.xml
@@ -109,9 +109,14 @@
     </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>.
+      convention: it should start with a reversed DNS domain name
+      controlled by the author of the application, in lower case. The
+      domain name should be followed by the name of the application, which
+      is conventionally written with words run together and initial capital
+      letters (CamelCase). For example, if the owner of
+      <literal>example.org</literal> writes "Foo Viewer", they might choose
+      the name <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