From 482e53b028d49662db35324814f82df5e5b89c0e Mon Sep 17 00:00:00 2001
From: Ralf Habacker <ralf.habacker@freenet.de>
Date: Thu, 9 Feb 2012 13:54:55 +0100
Subject: [PATCH] Documentated relative pathes in service files

---
 doc/dbus-specification.xml |   15 +++++++++++++++
 1 files changed, 15 insertions(+), 0 deletions(-)

diff --git a/doc/dbus-specification.xml b/doc/dbus-specification.xml
index 7280cf1..46e5b78 100644
--- a/doc/dbus-specification.xml
+++ b/doc/dbus-specification.xml
@@ -4216,6 +4216,21 @@
         choose one?]
       </para>
       <para>
+        Executable names may be absolute or relative. Relative pathes on Windows are
+        based on the dbus installation root. The dbus installation root is the
+        grandparent directory of the dbus daemon executable if it is located in a bin/
+        subdirectory, otherwise the parent directory.
+      </para>
+      <para>
+        Relative pathes on unix are based on the current working directory of the dbus
+        daemon executable.
+      </para>
+      <para>
+        Relative executable pathes in service files are useful on operating systems or
+        environments where the path dbus daemon is running from differs from the path
+        dbus is build for. Examples are the Windows operating system or portable installations.
+      </para>
+      <para>
         The executable launched will have the environment variable
         <literal>DBUS_STARTER_ADDRESS</literal> set to the address of the
         message bus so it can connect and request the appropriate names.
-- 
1.7.4.msysgit.0