* dbus.texi (Errors and Events): New variable dbus-event-error-hooks.

diff --git a/doc/misc/ChangeLog b/doc/misc/ChangeLog
index 4296cb4e61bcc0be903b521ace48cd21e4cbecae..352573f9a6ab4a7081e43ec2d3fe04a907f2a2ca 100644 (file)
--- a/doc/misc/ChangeLog
+++ b/doc/misc/ChangeLog
@@ -1,3 +1,7 @@
+2009-01-26  Michael Albinus  <michael.albinus@gmx.de>
+
+       * dbus.texi (Errors and Events): New variable dbus-event-error-hooks.
+
 2009-01-26  Glenn Morris  <rgm@gnu.org>
 
        * org.texi: Fix typos.

diff --git a/doc/misc/dbus.texi b/doc/misc/dbus.texi
index 1702c8b43406ab373816d2b8a4841fa57f6353b0..a6d042a8500973d0f2ff2002ced36a953ca407a0 100644 (file)
--- a/doc/misc/dbus.texi
+++ b/doc/misc/dbus.texi
@@ -1535,7 +1535,22 @@ from.  It is either a signal name or a method name.
 
 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