From def5d0e44e217062ab6a7ec8b67a8b2964c3de45 Mon Sep 17 00:00:00 2001 From: Simon McVittie Date: Tue, 7 Feb 2012 17:30:18 +0000 Subject: [PATCH 7/8] Recomend dbus-run-session over dbus-launch for starting text-mode sessions Bug: https://bugs.freedesktop.org/show_bug.cgi?id=39196 --- doc/dbus-launch.1 | 29 ++++++++++++++++------------- 1 files changed, 16 insertions(+), 13 deletions(-) diff --git a/doc/dbus-launch.1 b/doc/dbus-launch.1 index 6c7df19..049ad0d 100644 --- a/doc/dbus-launch.1 +++ b/doc/dbus-launch.1 @@ -77,19 +77,11 @@ run by your X session, such as or .BR ~/.Xclients . -To start a D-Bus session within a text-mode session, you can run -dbus-launch in the background. For instance, in a sh-compatible shell: - -.nf - ## test for an existing bus daemon, just to be safe - if test \-z "$DBUS_SESSION_BUS_ADDRESS" ; then - ## if not found, launch a new one - eval `dbus\-launch \-\-sh\-syntax` - echo "D\-Bus per\-session daemon address is: $DBUS_SESSION_BUS_ADDRESS" - fi -.fi -Note that in this case, dbus-launch will exit, and dbus-daemon will not be -terminated automatically on logout. +To start a D-Bus session within a text\(hymode session, +do not use +.BR dbus\-launch . +Instead, see +.BR dbus\-run\-session (1). .SH AUTOMATIC LAUNCHING @@ -216,6 +208,13 @@ terminates: this is because .B myapp is assumed to be part of a larger session, rather than a session in its own right. +.P +If you would like +.I myapp +to be treated as starting its own session, use +.BR dbus\-run\-session (1) +instead of +.B dbus\-launch. .SH AUTHOR See http://www.freedesktop.org/software/dbus/doc/AUTHORS @@ -223,3 +222,7 @@ See http://www.freedesktop.org/software/dbus/doc/AUTHORS .SH BUGS Please send bug reports to the D\-Bus mailing list or bug tracker, see http://www.freedesktop.org/software/dbus/ + +.SH SEE ALSO +.BR dbus\-daemon (1), +.BR dbus\-run\-session (1) -- 1.7.9