[Emacs-diffs] /srv/bzr/emacs/trunk r101174: * dbus.texi (Alternative Buses): New chapter.

[Michael Albinus]

------------------------------------------------------------
revno: 101174
committer: Michael Albinus <address@hidden>
branch nick: trunk
timestamp: Mon 2010-08-23 15:48:48 +0200
message:
  * dbus.texi (Alternative Buses): New chapter.
modified:
  doc/misc/ChangeLog
  doc/misc/dbus.texi

=== modified file 'doc/misc/ChangeLog'
--- a/doc/misc/ChangeLog        2010-08-12 09:02:02 +0000
+++ b/doc/misc/ChangeLog        2010-08-23 13:48:48 +0000
@@ -1,3 +1,7 @@
+2010-08-23  Michael Albinus  <address@hidden>
+
+       * dbus.texi (Alternative Buses): New chapter.
+
 2010-08-12  Stefan Monnier  <address@hidden>
 
        * cl.texi (Mapping over Sequences): Rename mapc => cl-mapc.

=== modified file 'doc/misc/dbus.texi'
--- a/doc/misc/dbus.texi        2010-07-09 19:24:38 +0000
+++ b/doc/misc/dbus.texi        2010-08-23 13:48:48 +0000
@@ -53,6 +53,7 @@
 * Asynchronous Methods::        Calling methods non-blocking.
 * Receiving Method Calls::      Offering own methods.
 * Signals::                     Sending and receiving signals.
+* Alternative Buses::           Alternative buses.
 * Errors and Events::           Errors and events.
 * Index::                       Index including concepts, functions, variables.
 
@@ -1579,6 +1580,56 @@
 @end defun
 
 
address@hidden Alternative Buses
address@hidden Alternative buses.
address@hidden bus names
address@hidden UNIX domain socket
+
+Until now, we have spoken about the system and the session buses,
+which are the default buses to be connected to.  However, it is
+possible to connect to any bus, from which the address is known.  This
+is a UNIX domain socket.  Everywhere, where a @var{bus} is mentioned
+as argument of a function (the symbol @code{:system} or the symbol
address@hidden:session}), this address can be used instead.  The connection to
+this bus must be initialized first.
+
address@hidden dbus-init-bus bus
+Establish the connection to D-Bus @var{bus}.
+
address@hidden can be either the symbol @code{:system} or the symbol
address@hidden:session}, or it can be a string denoting the address of the
+corresponding bus.  For the system and session busses, this function
+is called when loading @file{dbus.el}, there is no need to call it
+again.
+
+Example: You open another session bus in a terminal window on your host:
+
address@hidden
+# eval `dbus-launch --auto-syntax`
+# echo $DBUS_SESSION_BUS_ADDRESS
+
address@hidden unix:abstract=/tmp/dbus-JoFtAVG92w,guid=2f320a1ebe50b7ef58e
address@hidden example
+
+In Emacs, you can access to this bus via its address:
+
address@hidden
+(setq my-bus
+      "unix:abstract=/tmp/dbus-JoFtAVG92w,guid=2f320a1ebe50b7ef58e")
+
address@hidden "unix:abstract=/tmp/dbus-JoFtAVG92w,guid=2f320a1ebe50b7ef58e"
+
+(dbus-init-bus my-bus)
+
address@hidden nil
+
+(dbus-get-unique-name my-bus)
+
address@hidden ":1.0"
address@hidden lisp
address@hidden defun
+
+
 @node Errors and Events
 @chapter Errors and events.
 @cindex debugging