summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorMichael Albinus <michael.albinus@gmx.de>2009-01-26 20:23:49 +0000
committerMichael Albinus <michael.albinus@gmx.de>2009-01-26 20:23:49 +0000
commite74335088374a8b38d3f4f763030eb648a01f801 (patch)
tree71c2d832caf2c9662da7c270dbfcb0eac4376d85 /doc
parentbf86d09c114f54879bcc66c1f262df4adeaf63b8 (diff)
downloademacs-e74335088374a8b38d3f4f763030eb648a01f801.tar.gz
* dbus.texi (Errors and Events): New variable dbus-event-error-hooks.
Diffstat (limited to 'doc')
-rw-r--r--doc/misc/ChangeLog4
-rw-r--r--doc/misc/dbus.texi17
2 files changed, 20 insertions, 1 deletions
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