Attachment 49049 Details for Bug 39197 – [PATCH 4/5] dbus-launch: revise recommendations and put them in an EXAMPLES section

[patch] [PATCH 4/5] dbus-launch: revise recommendations and put them in an EXAMPLES section

0004-dbus-launch-revise-recommendations-and-put-them-in-a.patch (text/plain), 2.80 KB, created by Simon McVittie on 2011-07-13 09:38:31 UTC

(hide)

Description:

Filename:

MIME Type:

Creator: Simon McVittie

Created: 2011-07-13 09:38:31 UTC

Size: 2.80 KB

patch

obsolete

>From c9b38c48de5b347180ef234ba64e31fab700f55c Mon Sep 17 00:00:00 2001
>From: Simon McVittie <simon.mcvittie@collabora.co.uk>
>Date: Wed, 13 Jul 2011 17:34:12 +0100
>Subject: [PATCH 4/5] dbus-launch: revise recommendations and put them in an
> EXAMPLES section
>
>The first thing we should talk about is how to get a D-Bus session in
>your X session - that's the common case.
>
>Secondarily, we can tell command-line addicts how to have a D-Bus session.
>Do not recommend --exit-with-session here, since that polls (and reads
>from) stdin, which is harmful to precisely those command-line users!
>Until we have some better tool, the best we can do here is note that
>the dbus-daemon is not automatically terminated.
>---
> doc/dbus-launch.1 |   48 ++++++++++++++++++++++++++++++++----------------
> 1 files changed, 32 insertions(+), 16 deletions(-)
>
>diff --git a/doc/dbus-launch.1 b/doc/dbus-launch.1
>index c14c8a2..6e1a08f 100644
>--- a/doc/dbus-launch.1
>+++ b/doc/dbus-launch.1
>@@ -51,30 +51,46 @@ know which shell your script is written in.
> See http://www.freedesktop.org/software/dbus/ for more information
> about D-Bus. See also the man page for \fIdbus-daemon\fP.
> 
>-.PP
>-Here is an example of how to use \fIdbus-launch\fP with an 
>-sh-compatible shell to start the per-session bus daemon:
>-.nf
>+.SH EXAMPLES
>+
>+Distributions running
>+.B dbus-launch
>+as part of a standard X session should run
>+.B "dbus-launch --exit-with-x11"
>+after the X server has started and become available, as a wrapper around
>+the "main" X client (typically a session manager or window manager), as in
>+these examples:
>+
>+.RS
>+.B "dbus-launch --exit-with-x11 gnome-session"
>+
>+.B "dbus-launch --exit-with-x11 openbox"
>+
>+.B "dbus-launch --exit-with-x11 ~/.xsession"
>+.RE
>+
>+If your distribution does not do this, you can achieve similar results
>+by running your session or window manager in the same way in a script
>+run by your X session, such as
>+.BR ~/.xsession ,
>+.B ~/.xinitrc
>+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 --exit-with-session`
>+      eval `dbus-launch --sh-syntax`
>       echo "D-Bus per-session daemon address is: $DBUS_SESSION_BUS_ADDRESS"
>   fi
>-
> .fi
>-You might run something like that in your login scripts.
>-
>-.PP
>-Another way to use \fIdbus-launch\fP is to run your main session
>-program, like so:
>-.nf
> 
>-dbus-launch gnome-session
>-
>-.fi
>-The above would likely be appropriate for ~/.xsession or ~/.Xclients.
>+Note that in this case, dbus-launch will exit, and dbus-daemon will not be
>+terminated automatically on logout.
> 
> .SH AUTOMATIC LAUNCHING
> 
>-- 
>1.7.5.4
>

Actions: View | Splinter Review

Attachments on bug 39197: 49046 | 49047 | 49048 | 49049 | 49050 | 56718 | 56719 | 56720 | 56721 | 56722 | 63464 | 80363 | 80364

Use of freedesktop.org services, including Bugzilla, is subject to our Code of Conduct. How we collect and use information is described in our Privacy Policy.