mirror/emacs
1
0
Fork 0
mirror of https://git.savannah.gnu.org/git/emacs.git synced 2025-01-05 11:45:45 +00:00
Code Issues Releases Activity

* dbus.texi (Errors and Events): Fix typos. Describe second parameter

Browse Source 
of hook functions.
This commit is contained in:
Michael Albinus 2009-01-28 16:07:33 +00:00
parent 8372c367bd
commit 74fc50477b
2 changed files with 21 additions and 6 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

5
doc/misc/ChangeLog
View File

@ -1,3 +1,8 @@
2009-01-28 Michael Albinus <michael.albinus@gmx.de>
* dbus.texi (Errors and Events): Fix typos. Describe second parameter
of hook functions.
2009-01-28 Carsten Dominik <dominik@science.uva.nl>
* org.texi (TODO dependencies): New section.

22
doc/misc/dbus.texi
View File

@ -1525,11 +1525,11 @@ Returns the object path of the D-Bus object @var{event} is coming from.
@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 @@ 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:
two arguments, the event and the error variable catched in
@code{condition-case} 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