[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[Emacs-diffs] emacs/doc/misc dbus.texi
From: |
Michael Albinus |
Subject: |
[Emacs-diffs] emacs/doc/misc dbus.texi |
Date: |
Wed, 28 Jan 2009 16:07:07 +0000 |
CVSROOT: /sources/emacs
Module name: emacs
Changes by: Michael Albinus <albinus> 09/01/28 16:07:07
Modified files:
doc/misc : dbus.texi
Log message:
* dbus.texi (Errors and Events): Fix typos. Describe second parameter
of hook functions.
CVSWeb URLs:
http://cvs.savannah.gnu.org/viewcvs/emacs/doc/misc/dbus.texi?cvsroot=emacs&r1=1.29&r2=1.30
Patches:
Index: dbus.texi
===================================================================
RCS file: /sources/emacs/emacs/doc/misc/dbus.texi,v
retrieving revision 1.29
retrieving revision 1.30
diff -u -b -r1.29 -r1.30
--- dbus.texi 26 Jan 2009 20:23:30 -0000 1.29
+++ dbus.texi 28 Jan 2009 16:07:07 -0000 1.30
@@ -1525,11 +1525,11 @@
@end defun
@defun dbus-event-interface-name event
-Returns the interface name of of the D-Bus object @var{event} is coming from.
+Returns the interface name of the D-Bus object @var{event} is coming from.
@end defun
@defun dbus-event-member-name event
-Returns the member name of of the D-Bus object @var{event} is coming
+Returns the member name of the D-Bus object @var{event} is coming
from. It is either a signal name or a method name.
@end defun
@@ -1541,17 +1541,27 @@
@defvar dbus-event-error-hooks
This hook variable keeps a list of functions, which are called when a
D-Bus error happens in the event handler. Every function must accept
-one argument, the error variable catched in @code{condition-case} by
address@hidden Example:
+two arguments, the event and the error variable catched in
address@hidden by @code{dbus-error}.
+
+Such functions can be used the adapt the error signal to be raised.
+Example:
@lisp
-(defun my-dbus-event-error-handler (err)
- (message "my-dbus-event-error-handler: %S" (cadr err)))
+(defun my-dbus-event-error-handler (event error)
+ (when (string-equal (concat dbus-service-emacs ".FileManager")
+ (dbus-event-interface-name event))
+ (message "my-dbus-event-error-handler: %S %S" event error)
+ (signal 'file-error (cdr error))))
(add-hook 'dbus-event-error-hooks 'my-dbus-event-error-handler)
@end lisp
@end defvar
+Hook functions shall take into account, that there might be other
+D-Bus applications running. Therefore, they shall check carefully,
+whether a given D-Bus error is related to them.
+
@node GNU Free Documentation License
@appendix GNU Free Documentation License