dbus/doc dbus-specification.xml,1.5,1.6 .cvsignore,1.3,1.4

[Olivier Andrieu]

Update of /cvs/dbus/dbus/doc
In directory pdx:/tmp/cvs-serv29915/doc

Modified Files:
	dbus-specification.xml .cvsignore 
Log Message:
2004-04-15  Olivier Andrieu  <oliv__a at users.sourceforge.net>

	* bus/driver.c (bus_driver_handle_get_service_owner):
	implement a GetServiceOwner method.
	* doc/dbus-specification.xml: document it.
	* dbus/dbus-errors.h: add a 'ServiceHasNoOwner' error.
	
	* glib/dbus-gproxy.c (dbus_gproxy_new_for_service_owner):
	implement, using the bus GetServiceOwner method.

	* test/glib/test-dbus-glib.c:
	use dbus_gproxy_new_for_service_owner so that we can receive the
	signal.


Index: dbus-specification.xml
===================================================================
RCS file: /cvs/dbus/dbus/doc/dbus-specification.xml,v
retrieving revision 1.5
retrieving revision 1.6
diff -u -d -r1.5 -r1.6
--- a/dbus-specification.xml	16 Mar 2004 18:00:35 -0000	1.5
+++ b/dbus-specification.xml	15 Apr 2004 22:08:04 -0000	1.6
@@ -2206,6 +2206,58 @@
 
       </sect3>
 
+      <sect3 id="bus-messages-get-service-owner">
+        <title><literal>org.freedesktop.DBus.GetServiceOwner</literal></title>
+        <para>
+          As a method:
+          <programlisting>
+            STRING GetServiceOwner (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 to query</entry>
+                </row>
+              </tbody>
+            </tgroup>
+          </informaltable>
+        Reply 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>Return value, a base service name</entry>
+              </row>
+            </tbody>
+          </tgroup>
+        </informaltable>
+        Returns the base service name of the primary owner of the
+        service in argument. If the requested service isn't active,
+        returns a
+        <literal>org.freedesktop.DBus.Error.ServiceHasNoOwner</literal> error.
+       </para>
+      </sect3>
+
       <sect3 id="bus-messages-out-of-memory">
         <title><literal>org.freedesktop.DBus.Error.NoMemory</literal></title>
         <para>

Index: .cvsignore
===================================================================
RCS file: /cvs/dbus/dbus/doc/.cvsignore,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -d -r1.3 -r1.4
--- a/.cvsignore	16 Feb 2003 23:35:51 -0000	1.3
+++ b/.cvsignore	15 Apr 2004 22:08:04 -0000	1.4
@@ -8,3 +8,4 @@
 api
 dbus-specification.html
 dbus-test-plan.html
+dbus-tutorial.html