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 ce58fe865531f85b5aefaeafdabb12ea1e1f4cc0..e6e75fde98dd592b14705e7f96f0df4e650ad7b5 100644 (file)
--- 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