From 0d8af3571c0755463643af2456cd9e9f59df8960 Mon Sep 17 00:00:00 2001 From: Simon McVittie Date: Wed, 13 Jul 2011 19:53:10 +0100 Subject: [PATCH 2/2] Recomend dbus-run-session over dbus-launch for starting text-mode sessions --- doc/dbus-launch.1 | 28 ++++++++++++++-------------- 1 files changed, 14 insertions(+), 14 deletions(-) diff --git a/doc/dbus-launch.1 b/doc/dbus-launch.1 index ee0c804..fa92606 100644 --- a/doc/dbus-launch.1 +++ b/doc/dbus-launch.1 @@ -77,20 +77,9 @@ 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-mode session, +see +.BR dbus-run-session (1). .SH AUTOMATIC LAUNCHING @@ -217,6 +206,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 @@ -224,3 +220,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.5.4