# HG changeset patch
# User Michael Albinus <michael.albinus@gmx.de>
# Date 1215961963 0
# Node ID 5e58654e97ff51186b4cb96578fe3f2ba338a2c5
# Parent  45b707df336e4ed8943cef2ca98764336413a881
* dbus.texi (Receiving Method Calls): Fix description of
`dbus-register-method'.
(Signals): Allow also signal arguments for filtering in
`dbus-register-signal'.

diff -r 45b707df336e -r 5e58654e97ff doc/misc/dbus.texi
--- a/doc/misc/dbus.texi	Sun Jul 13 15:07:10 2008 +0000
+++ b/doc/misc/dbus.texi	Sun Jul 13 15:12:43 2008 +0000
@@ -550,7 +550,7 @@
 client.  Therefore, @var{handler} shall not last longer than
 absolutely necessary.
 
-@code{dbus-register-method} returns a Lisp symbol, which can be used
+@code{dbus-register-method} returns a Lisp object, which can be used
 as argument in @code{dbus-unregister-object} for removing the
 registration for @var{method}.  Example:
 
@@ -623,7 +623,7 @@
 @end lisp
 @end defun
 
-@defun dbus-register-signal bus service path interface signal handler
+@defun dbus-register-signal bus service path interface signal handler &rest args
 With this function, an application registers for @var{signal} on the
 D-Bus @var{bus}.
 
@@ -648,7 +648,16 @@
 
 @var{handler} is a Lisp function to be called when the @var{signal} is
 received.  It must accept as arguments the output parameters
-@var{signal} is sending.  Example:
+@var{signal} is sending.
+
+All other arguments @var{args}, if specified, must be strings.  They
+stand for the respective arguments of @var{signal} in their order, and
+are used for filtering as well.  A @code{nil} argument might be used
+to preserve the order.
+
+@code{dbus-register-signal} returns a Lisp object, which can be used
+as argument in @code{dbus-unregister-object} for removing the
+registration for @var{signal}.  Example:
 
 @lisp
 (defun my-dbus-signal-handler (device)
@@ -673,10 +682,6 @@
 single string argument therefore.  Plugging an USB device to your
 machine, when registered for signal @code{DeviceAdded}, will show you
 which objects the GNU/Linux @code{hal} daemon adds.
-
-@code{dbus-register-signal} returns a Lisp symbol, which can be used
-as argument in @code{dbus-unregister-object} for removing the
-registration for @var{signal}.
 @end defun
 
 @defun dbus-unregister-object object