From: Simon McVittie <simon.mcvittie@collabora.co.uk>
Date: Tue, 7 Feb 2012 17:43:28 +0000 (+0000)
Subject: Document that dbus-launch is not dbus-run-session
X-Git-Tag: dbus-1.6.2~15
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=e9762e1542449601ff23b0c5fc8d6764e0898d3f;p=thirdparty%2Fdbus.git

Document that dbus-launch is not dbus-run-session

Architectural assumptions inside dbus-launch mean that it is unsuitable
for use in contexts where a particular process's lifetime defines the
session, unless there is an out-of-band mechanism (like the X server)
which can signal the end of the session.

Reviewed-by: Will Thompson <will.thompson@collabora.co.uk>
Bug: https://bugs.freedesktop.org/show_bug.cgi?id=39197
---

diff --git a/doc/dbus-launch.1 b/doc/dbus-launch.1
index 1707f3d36..4902b40a2 100644
--- a/doc/dbus-launch.1
+++ b/doc/dbus-launch.1
@@ -204,6 +204,19 @@ Emit Bourne\-shell compatible code to set up environment variables.
 .I "\-\-version"
 Print the version of dbus\-launch
 
+.SH NOTES
+
+If you run
+.B "dbus\-launch myapp"
+(with any other options), dbus\-daemon will
+.I not
+exit when
+.B myapp
+terminates: this is because
+.B myapp
+is assumed to be part of a larger session, rather than a session in its
+own right.
+
 .SH AUTHOR
 See http://www.freedesktop.org/software/dbus/doc/AUTHORS