[Emacs-diffs] /srv/bzr/emacs/trunk r102752: * dbus.texi (Receiving Method Calls): Describe new optional

[Michael Albinus]

------------------------------------------------------------
revno: 102752
committer: Michael Albinus <address@hidden>
branch nick: trunk
timestamp: Tue 2011-01-04 13:38:33 +0100
message:
  * dbus.texi (Receiving Method Calls): Describe new optional
  parameter dont-register-service of dbus-register-{method,property}.
modified:
  doc/misc/ChangeLog
  doc/misc/dbus.texi

=== modified file 'doc/misc/ChangeLog'
--- a/doc/misc/ChangeLog        2010-12-17 01:43:03 +0000
+++ b/doc/misc/ChangeLog        2011-01-04 12:38:33 +0000
@@ -1,3 +1,8 @@
+2011-01-04  Jan Moringen  <address@hidden>
+
+       * dbus.texi (Receiving Method Calls): Describe new optional
+       parameter dont-register-service of dbus-register-{method,property}.
+
 2010-12-17  Daiki Ueno  <address@hidden>
 
        * epa.texi (Encrypting/decrypting *.gpg files): Mention

=== modified file 'doc/misc/dbus.texi'
--- a/doc/misc/dbus.texi        2010-11-10 08:41:53 +0000
+++ b/doc/misc/dbus.texi        2011-01-04 12:38:33 +0000
@@ -9,7 +9,8 @@
 @syncodeindex fn cp
 
 @copying
-Copyright @copyright{} 2007, 2008, 2009, 2010 Free Software Foundation, Inc.
+Copyright @copyright{} 2007, 2008, 2009, 2010,
+2011 Free Software Foundation, Inc.
 
 @quotation
 Permission is granted to copy, distribute and/or modify this document
@@ -1264,7 +1265,7 @@
 string.
 @end deffn
 
address@hidden dbus-register-method bus service path interface method handler
address@hidden dbus-register-method bus service path interface method handler 
dont-register-service
 With this function, an application registers @var{method} on the D-Bus
 @var{bus}.
 
@@ -1272,10 +1273,11 @@
 @code{:session}.
 
 @var{service} is the D-Bus service name of the D-Bus object
address@hidden is registered for.  It must be a known name.
address@hidden is registered for.  It must be a known name (See
+discussion of @var{dont-register-service} below).
 
address@hidden is the D-Bus object path @var{service} is
-registered.
address@hidden is the D-Bus object path @var{service} is registered (See
+discussion of @var{dont-register-service} below).
 
 @var{interface} is the interface offered by @var{service}.  It must
 provide @var{method}.
@@ -1294,6 +1296,13 @@
 In case @var{handler} shall return a reply message with an empty
 argument list, @var{handler} must return the symbol @code{:ignore}.
 
+When @var{dont-register-service} is address@hidden, the known name
address@hidden is not registered.  This means that other D-Bus clients
+have no way of noticing the newly registered method.  When interfaces
+are constructed incrementally by adding single methods or properties
+at a time, @var{dont-register-service} can be use to prevent other
+clients from discovering the still incomplete interface.
+
 The default D-Bus timeout when waiting for a message reply is 25
 seconds.  This value could be even smaller, depending on the calling
 client.  Therefore, @var{handler} shall not last longer than
@@ -1368,7 +1377,7 @@
 @end example
 @end defun
 
address@hidden dbus-register-property bus service path interface property 
access value &optional emits-signal
address@hidden dbus-register-property bus service path interface property 
access value &optional emits-signal dont-register-service
 With this function, an application declares a @var{property} on the D-Bus
 @var{bus}.
 
@@ -1378,8 +1387,8 @@
 @var{service} is the D-Bus service name of the D-Bus.  It must be a
 known name.
 
address@hidden is the D-Bus object path @var{service} is
-registered.
address@hidden is the D-Bus object path @var{service} is registered (See
+discussion of @var{dont-register-service} below).
 
 @var{interface} is the name of the interface used at @var{path},
 @var{property} is the name of the property of @var{interface}.
@@ -1401,6 +1410,13 @@
 @samp{PropertiesChanged} is sent when the property is changed by
 @code{dbus-set-property}.
 
+When @var{dont-register-service} is address@hidden, the known name
address@hidden is not registered.  This means that other D-Bus clients
+have no way of noticing the newly registered method.  When interfaces
+are constructed incrementally by adding single methods or properties
+at a time, @var{dont-register-service} can be use to prevent other
+clients from discovering the still incomplete interface.
+
 @noindent Example:
 
 @lisp