summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorSimon McVittie <simon.mcvittie@collabora.co.uk>2012-02-07 17:43:28 +0000
committerSimon McVittie <simon.mcvittie@collabora.co.uk>2012-06-15 13:10:41 +0100
commite9762e1542449601ff23b0c5fc8d6764e0898d3f (patch)
tree4a2884fef184cf51c7b2a8ddbe46ead9d98f1702 /doc
parentba433723f79c7a69e7107ae5818ecd869aeb4d33 (diff)
downloaddbus-e9762e1542449601ff23b0c5fc8d6764e0898d3f.tar.gz
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
Diffstat (limited to 'doc')
-rw-r--r--doc/dbus-launch.113
1 files changed, 13 insertions, 0 deletions
diff --git a/doc/dbus-launch.1 b/doc/dbus-launch.1
index 1707f3d3..4902b40a 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