From 85f8f62da6bb26d7033310af9d3260b073efe4bf Mon Sep 17 00:00:00 2001
From: Olivier Andrieu <oliv__a@users.sourceforge.net>
Date: Fri, 24 Sep 2004 10:43:36 +0000
Subject: * doc/dbus-specification.xml: document ServiceOwnerChanged signal.

* bus/driver.c, bus/driver.h, bus/services.c: Use ServiceOwnerChanged
signal instead of ServiceCreated and ServiceDeleted.

* bus/dispatch.c: update testcase for the new signal.
---
 doc/dbus-specification.xml | 59 ++++++++++------------------------------------
 1 file changed, 12 insertions(+), 47 deletions(-)

(limited to 'doc')

diff --git a/doc/dbus-specification.xml b/doc/dbus-specification.xml
index f0d1727e..4793278f 100644
--- a/doc/dbus-specification.xml
+++ b/doc/dbus-specification.xml
@@ -2277,19 +2277,14 @@
         <para>
           This message is sent to a specific application when it loses primary
           ownership of a service.
-
-          [FIXME instead of ServiceLost/ServiceCreated going only to 
-          a specific app, why not just OwnerChanged that covers both 
-          lost and created and changed owner and deleted]
         </para>
       </sect3>
 
-      <sect3 id="bus-messages-service-created">
-        <title><literal>org.freedesktop.DBus.ServiceCreated</literal></title>
+      <sect3 id="bus-messages-service-owner-changed">
+        <title><literal>org.freedesktop.DBus.ServiceOwnerChanged</literal></title>
         <para>
-          As a method:
           <programlisting>
-            ServiceCreated (in STRING service_name)
+            ServiceOwnerChanged (STRING service_name, STRING old_owner, STRING new_owner)
           </programlisting>
           Message arguments:
           <informaltable>
@@ -2309,46 +2304,15 @@
                 </row>
 	        <row>
 		  <entry>1</entry>
-		  <entry>UINT32</entry>
-		  <entry>Flags</entry>
+		  <entry>STRING</entry>
+		  <entry>Base service of previous owner, empty string if the
+		  service is newly created</entry>
 	        </row>
-              </tbody>
-            </tgroup>
-          </informaltable>
-        </para>
-        <para>
-          This message is broadcast to all applications when a service has been
-          successfully registered on the message bus.
-        </para>
-      </sect3>
-
-      <sect3 id="bus-messages-service-deleted">
-        <title><literal>org.freedesktop.DBus.ServiceDeleted</literal></title>
-        <para>
-          As a method:
-          <programlisting>
-            ServiceDeleted (in STRING service_name)
-          </programlisting>
-          Message arguments:
-          <informaltable>
-            <tgroup cols="3">
-              <thead>
-                <row>
-                  <entry>Argument</entry>
-                  <entry>Type</entry>
-                  <entry>Description</entry>
-                </row>
-              </thead>
-              <tbody>
-                <row>
-                  <entry>0</entry>
-                  <entry>STRING</entry>
-                  <entry>Name of the service</entry>
-                </row>
 	        <row>
-		  <entry>1</entry>
-		  <entry>UINT32</entry>
-		  <entry>Flags</entry>
+		  <entry>2</entry>
+		  <entry>STRING</entry>
+		  <entry>Base service of new owner, empty string if the
+		  service is no longer available</entry>
 	        </row>
               </tbody>
             </tgroup>
@@ -2356,7 +2320,8 @@
         </para>
         <para>
           This message is broadcast to all applications when a service has been
-          deleted from the message bus.
+          successfully registered on the message bus, has been deleted
+          or its primary owner has changed.
         </para>
       </sect3>
 
-- 
cgit