[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[Emacs-diffs] /srv/bzr/emacs/trunk r101174: * dbus.texi (Alternative Bus
From: |
Michael Albinus |
Subject: |
[Emacs-diffs] /srv/bzr/emacs/trunk r101174: * dbus.texi (Alternative Buses): New chapter. |
Date: |
Mon, 23 Aug 2010 15:48:48 +0200 |
User-agent: |
Bazaar (2.0.3) |
------------------------------------------------------------
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
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [Emacs-diffs] /srv/bzr/emacs/trunk r101174: * dbus.texi (Alternative Buses): New chapter.,
Michael Albinus <=