From: Simon McVittie <simon.mcvittie@collabora.co.uk>
Date: Mon, 16 Sep 2013 13:33:41 +0000 (+0100)
Subject: spec: system services' service description files have constrained names
X-Git-Tag: dbus-1.7.6~16
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=be2d249f71c8469c2e6a9af425fc4192b291f341;p=thirdparty%2Fdbus.git

spec: system services' service description files have constrained names

Bug: https://bugs.freedesktop.org/show_bug.cgi?id=66608
Reviewed-by: Chengwei Yang <chengwei.yang@intel.com>
---

diff --git a/doc/dbus-specification.xml b/doc/dbus-specification.xml
index ce58fe865..e6e75fde9 100644
--- a/doc/dbus-specification.xml
+++ b/doc/dbus-specification.xml
@@ -4638,6 +4638,19 @@
         names.
       </para>
 
+      <para>
+        On the well-known system bus, the name of a service description file
+        must be its well-known name plus <literal>.service</literal>,
+        for instance
+        <literal>com.example.ConfigurationDatabase.service</literal>.
+      </para>
+
+      <para>
+        On the well-known session bus, services should follow the same
+        service description file naming convention as on the system bus,
+        but for backwards compatibility they are not required to do so.
+      </para>
+
       <para>
         [FIXME the file format should be much better specified than "similar to
         .desktop entries" esp. since desktop entries are already