From 6b01c6cdfdaae6d6847c5f5f8333867f53f0463e Mon Sep 17 00:00:00 2001
From: Simon McVittie <simon.mcvittie@collabora.co.uk>
Date: Wed, 8 Feb 2012 15:46:37 +0000
Subject: [PATCH] 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>
---
 doc/dbus-specification.xml | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/doc/dbus-specification.xml b/doc/dbus-specification.xml
index 87c7456..c051a33 100644
--- 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">
-- 
2.7.4