changeset 101523:7b5ca0afd795

* dbus.texi (Errors and Events): New variable dbus-event-error-hooks.
author Michael Albinus <michael.albinus@gmx.de>
date Mon, 26 Jan 2009 20:23:30 +0000
parents 561d416172d0
children 58326376a152
files doc/misc/dbus.texi
diffstat 1 files changed, 16 insertions(+), 1 deletions(-) [+]
line wrap: on
line diff
--- a/doc/misc/dbus.texi	Mon Jan 26 15:50:43 2009 +0000
+++ b/doc/misc/dbus.texi	Mon Jan 26 20:23:30 2009 +0000
@@ -1535,7 +1535,22 @@
 
 D-Bus errors are not propagated during event handling, because it is
 usually not desired.  D-Bus errors in events can be made visible by
-setting the variable @code{dbus-debug} to @code{t}.
+setting the variable @code{dbus-debug} to @code{t}.  They can also be
+handled by a hook function.
+
+@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
+@code{dbus-error}.  Example:
+
+@lisp
+(defun my-dbus-event-error-handler (err)
+  (message "my-dbus-event-error-handler: %S" (cadr err)))
+
+(add-hook 'dbus-event-error-hooks 'my-dbus-event-error-handler)
+@end lisp
+@end defvar
 
 
 @node GNU Free Documentation License