spec: document how to install session .service files

Bug: https://bugs.freedesktop.org/show_bug.cgi?id=35306
Signed-off-by: Simon McVittie <simon.mcvittie@collabora.co.uk>

diff --git a/doc/dbus-specification.xml b/doc/dbus-specification.xml
index 87c7456445f8a433200e6d9e6d0d19dbb1eb5ecf..c051a33b6a0355cf819442ae9b506f31df9104a5 100644 (file)
--- a/doc/dbus-specification.xml
+++ b/doc/dbus-specification.xml
@@ -4511,6 +4511,15 @@
             looks in <literal>${datadir}/dbus-1/services</literal> as
             set at compile time.
           </para>
+          <para>
+            As described in the XDG Base Directory Specification, software
+            packages should install their session .service files to their
+            configured <literal>${datadir}/dbus-1/services</literal>,
+            where <literal>${datadir}</literal> is as defined by the GNU
+            coding standards. System administrators or users can arrange
+            for these service files to be read by setting XDG_DATA_DIRS or by
+            symlinking them into the default locations.
+          </para>
         </sect4>
       </sect3>
       <sect3 id="message-bus-types-system">