From: Michael Albinus <michael.albinus@gmx.de>
Date: Mon, 26 Jan 2009 20:23:49 +0000 (+0000)
Subject: * dbus.texi (Errors and Events): New variable dbus-event-error-hooks.
X-Git-Tag: emacs-pretest-23.0.90~188
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=e74335088374a8b38d3f4f763030eb648a01f801;p=emacs.git

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

diff --git a/doc/misc/ChangeLog b/doc/misc/ChangeLog
index 4296cb4e61b..352573f9a6a 100644
--- 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 1702c8b4340..a6d042a8500 100644
--- 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