From: Simon McVittie <simon.mcvittie@collabora.co.uk>
Date: Wed, 5 Jun 2013 16:51:55 +0000 (+0100)
Subject: Recomend dbus-run-session over dbus-launch for starting text-mode sessions
X-Git-Tag: dbus-1.7.4~15
X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=9c0ef7028893e4db18fe901ed749784c99a8839f;p=platform%2Fupstream%2Fdbus.git

Recomend dbus-run-session over dbus-launch for starting text-mode sessions

Bug: https://bugs.freedesktop.org/show_bug.cgi?id=39196
Reviewed-by: Colin Walters <walters@verbum.org>
[reformatted from roff to Docbook -smcv]
---

diff --git a/doc/dbus-launch.1.xml.in b/doc/dbus-launch.1.xml.in
index fde439d..727495b 100644
--- a/doc/dbus-launch.1.xml.in
+++ b/doc/dbus-launch.1.xml.in
@@ -102,8 +102,10 @@ run by your X session, such as
 or
 <filename>~/.Xclients</filename>.</para>
 
-<para>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:</para>
+<para>To start a D-Bus session within a text\(hymode session,
+  do not use <emphasis remap='B'>dbus-launch</emphasis>.
+  Instead, see <citerefentry><refentrytitle>dbus-run-session</refentrytitle><manvolnum>1</manvolnum></citerefentry>.
+</para>
 
 <literallayout remap='.nf'>
   ## test for an existing bus daemon, just to be safe