From: Simon McVittie <simon.mcvittie@collabora.co.uk>
Date: Tue, 12 Apr 2011 15:30:24 +0000 (+0100)
Subject: spec: document the search path for session services
X-Git-Tag: dbus-1.5.10~54^2~1
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=ae3faad91d1cc9553901f5f304ca45d168387497;p=thirdparty%2Fdbus.git

spec: document the search path for session services

Bug: https://bugs.freedesktop.org/show_bug.cgi?id=35306
---

diff --git a/doc/dbus-specification.xml b/doc/dbus-specification.xml
index 7280cf176..87c745644 100644
--- a/doc/dbus-specification.xml
+++ b/doc/dbus-specification.xml
@@ -4500,9 +4500,16 @@
         <sect4>
           <title></title>
           <para>
-            [FIXME specify location of .service files, probably using
-            DESKTOP_DIRS etc. from basedir specification, though login session
-            bus is not really desktop-specific]
+            On Unix systems, the session bus should search for .service files
+            in <literal>$XDG_DATA_DIRS/dbus-1/services</literal> as defined
+            by the
+            <ulink url="http://standards.freedesktop.org/basedir-spec/basedir-spec-latest.html">XDG Base Directory Specification</ulink>.
+            Implementations may also search additional locations, which
+            should be searched with lower priority than anything in
+            XDG_DATA_HOME, XDG_DATA_DIRS or their respective defaults;
+            for example, the reference implementation also
+            looks in <literal>${datadir}/dbus-1/services</literal> as
+            set at compile time.
           </para>
         </sect4>
       </sect3>