now that we have the doc framework sorted, document all D-Bus interfaces

7 files changed, 260 insertions, 60 deletions

diff --git a/docs/eggdbus/eggdbus-docs.xml b/docs/eggdbus/eggdbus-docs.xml
index 8a8e909..f60dd9f 100644
--- a/docs/eggdbus/eggdbus-docs.xml
+++ b/docs/eggdbus/eggdbus-docs.xml
@@ -83,6 +83,10 @@
         <xi:include href="xml/eggdbuspeer.xml"/>
         <xi:include href="xml/eggdbusproperties.xml"/>
         <xi:include href="xml/eggdbusintrospectable.xml"/>
+        <xi:include href="xml/eggdbusrequestnameflags.xml"/>
+        <xi:include href="xml/eggdbusrequestnamereply.xml"/>
+        <xi:include href="xml/eggdbusreleasenamereply.xml"/>
+        <xi:include href="xml/eggdbusstartservicebynamereply.xml"/>
     </chapter>
 
     <chapter id="example">
diff --git a/docs/eggdbus/eggdbus-sections.txt b/docs/eggdbus/eggdbus-sections.txt
index d04e6c7..3725b08 100644
--- a/docs/eggdbus/eggdbus-sections.txt
+++ b/docs/eggdbus/eggdbus-sections.txt
@@ -535,6 +535,13 @@ EGG_TYPE_DBUS_MESSAGE_TYPE
 </SECTION>
 
 <SECTION>
+<FILE>eggdbusstartservicebynamereply</FILE>
+egg_dbus_start_service_by_name_reply_get_type
+EGG_DBUS_TYPE_START_SERVICE_BY_NAME_REPLY
+EggDBusStartServiceByNameReply
+</SECTION>
+
+<SECTION>
 <FILE>eggdbussignature</FILE>
 EGG_DBUS_TYPE_SIGNATURE
 EGG_DBUS_TYPE_SIGNATURE_ARRAY
diff --git a/src/eggdbus/Makefile.am b/src/eggdbus/Makefile.am
index f52ecd3..68a5088 100644
--- a/src/eggdbus/Makefile.am
+++ b/src/eggdbus/Makefile.am
@@ -120,6 +120,7 @@ eggdbus_headers =                        				\
 	eggdbusrequestnameflags.h					\
 	eggdbusrequestnamereply.h					\
 	eggdbusreleasenamereply.h					\
+	eggdbusstartservicebynamereply.h				\
 	eggdbusmisctypes.h						\
 	eggdbusobjectpath.h						\
 	eggdbussignature.h						\
@@ -127,16 +128,17 @@ eggdbus_headers =                        				\
 
 ###########################################################################
 
-EGG_DBUS_BUILT_SOURCES =						\
-	eggdbusbus.h			eggdbusbus.c			\
-	eggdbusintrospectable.h		eggdbusintrospectable.c		\
-	eggdbuspeer.h			eggdbuspeer.c			\
-	eggdbusproperties.h		eggdbusproperties.c		\
-	eggdbusrequestnameflags.h	eggdbusrequestnameflags.c	\
-	eggdbusrequestnamereply.h	eggdbusrequestnamereply.c	\
-	eggdbusreleasenamereply.h	eggdbusreleasenamereply.c	\
-	eggdbusbindingsmarshal.h	eggdbusbindingsmarshal.c	\
-	eggdbusbindingsmarshal.list					\
+EGG_DBUS_BUILT_SOURCES =								\
+	eggdbusbus.h				eggdbusbus.c				\
+	eggdbusintrospectable.h			eggdbusintrospectable.c			\
+	eggdbuspeer.h				eggdbuspeer.c				\
+	eggdbusproperties.h			eggdbusproperties.c			\
+	eggdbusrequestnameflags.h		eggdbusrequestnameflags.c		\
+	eggdbusrequestnamereply.h		eggdbusrequestnamereply.c		\
+	eggdbusreleasenamereply.h		eggdbusreleasenamereply.c		\
+	eggdbusstartservicebynamereply.h	eggdbusstartservicebynamereply.c	\
+	eggdbusbindingsmarshal.h		eggdbusbindingsmarshal.c		\
+	eggdbusbindingsmarshal.list							\
 	$(NULL)
 
 BUILT_SOURCES = 							\
@@ -157,6 +159,7 @@ $(EGG_DBUS_BUILT_SOURCES) : eggdbus-binding-tool Makefile.am org.freedesktop.DBu
 		--include-header "eggdbus/eggdbusrequestnameflags.h"					\
 		--include-header "eggdbus/eggdbusrequestnamereply.h"					\
 		--include-header "eggdbus/eggdbusreleasenamereply.h"					\
+		--include-header "eggdbus/eggdbusstartservicebynamereply.h"				\
 		--introspection-xml $(top_srcdir)/src/eggdbus/org.freedesktop.DBus.xml			\
 		--introspection-xml $(top_srcdir)/src/eggdbus/org.freedesktop.DBus.Peer.xml		\
 		--introspection-xml $(top_srcdir)/src/eggdbus/org.freedesktop.DBus.Properties.xml	\
diff --git a/src/eggdbus/org.freedesktop.DBus.Introspectable.xml b/src/eggdbus/org.freedesktop.DBus.Introspectable.xml
index cc86743..bab4cbd 100644
--- a/src/eggdbus/org.freedesktop.DBus.Introspectable.xml
+++ b/src/eggdbus/org.freedesktop.DBus.Introspectable.xml
@@ -3,8 +3,15 @@
 <node name="/">
 
   <interface name="org.freedesktop.DBus.Introspectable">
+    <annotation name="org.gtk.EggDBus.DocString" value="Introspection support."/>
+    <annotation name="org.gtk.EggDBus.DocString.Summary" value="org.freedesktop.DBus.Introspectable interface"/>
+
     <method name="Introspect">
-      <arg direction="out" type="s" name="xml_data"/>
+      <annotation name="org.gtk.EggDBus.DocString" value="Object instances may implement this method which returns an XML description of the object, including its interfaces (with signals, methods and properties) and objects below it in the object path tree. See the D-Bus specification for the exact format of D-Bus Introspection XML."/>
+
+      <arg direction="out" type="s" name="xml_data">
+        <annotation name="org.gtk.EggDBus.DocString" value="Valid D-Bus Introspection XML."/>
+      </arg>
     </method>
 
   </interface>
diff --git a/src/eggdbus/org.freedesktop.DBus.Peer.xml b/src/eggdbus/org.freedesktop.DBus.Peer.xml
index f62d13d..a483730 100644
--- a/src/eggdbus/org.freedesktop.DBus.Peer.xml
+++ b/src/eggdbus/org.freedesktop.DBus.Peer.xml
@@ -3,11 +3,18 @@
 <node name="/">
 
   <interface name="org.freedesktop.DBus.Peer">
+    <annotation name="org.gtk.EggDBus.DocString" value="All D-Bus objects are supposed to implement the <literal>org.freedesktop.DBus.Peer</literal> D-Bus interface. The interface is designed to be a minimal interface for checking whether the other end is reachable and, if so, what machine hosts the object."/>
+    <annotation name="org.gtk.EggDBus.DocString.Summary" value="org.freedesktop.DBus.Peer interface"/>
+
     <method name="Ping">
+      <annotation name="org.gtk.EggDBus.DocString" value="A method used to diagnose whether an object is reachable."/>
     </method>
 
     <method name="GetMachineId">
-      <arg direction="out" type="s" name="machine_uuid"/>
+      <annotation name="org.gtk.EggDBus.DocString" value="Gets the Machine UUID of the machine hosting the object."/>
+      <arg direction="out" type="s" name="machine_uuid">
+        <annotation name="org.gtk.EggDBus.DocString" value="A Universally Unique Identifier for the machine hosting the object. See the D-Bus specification for more information about D-Bus UUIDs."/>
+      </arg>
     </method>
 
   </interface>
diff --git a/src/eggdbus/org.freedesktop.DBus.Properties.xml b/src/eggdbus/org.freedesktop.DBus.Properties.xml
index a124f3e..d7341b3 100644
--- a/src/eggdbus/org.freedesktop.DBus.Properties.xml
+++ b/src/eggdbus/org.freedesktop.DBus.Properties.xml
@@ -3,27 +3,58 @@
 <node name="/">
 
   <interface name="org.freedesktop.DBus.Properties">
+    <annotation name="org.gtk.EggDBus.DocString" value="Many native APIs will have a concept of object <emphasis>properties</emphasis> or <emphasis>attributes</emphasis>. These can be exposed via the <literal>org.freedesktop.DBus.Properties</literal> interface. The available properties and whether they are writable can be determined by using the #Introspectable interface."/>
+    <annotation name="org.gtk.EggDBus.DocString.Summary" value="org.freedesktop.DBus.Properties interface"/>
+
     <method name="Get">
-      <arg direction="in"  type="s" name="interface_name"/>
-      <arg direction="in"  type="s" name="property_name"/>
-      <arg direction="out" type="v" name="value"/>
+      <annotation name="org.gtk.EggDBus.DocString" value="Gets the value of the property with name @property_name on the interface with name @interface_name."/>
+
+      <arg direction="in"  type="s" name="interface_name">
+        <annotation name="org.gtk.EggDBus.DocString" value="The name of the D-Bus interface."/>
+      </arg>
+      <arg direction="in"  type="s" name="property_name">
+        <annotation name="org.gtk.EggDBus.DocString" value="The name of the property."/>
+      </arg>
+      <arg direction="out" type="v" name="value">
+        <annotation name="org.gtk.EggDBus.DocString" value="The value of the property."/>
+      </arg>
     </method>
 
     <method name="GetAll">
-      <arg direction="in"  type="s" name="interface_name"/>
-      <arg direction="out" type="a{sv}" name="properties"/>
+      <annotation name="org.gtk.EggDBus.DocString" value="Gets all properties on the interface with the name @interface_name."/>
+
+      <arg direction="in"  type="s" name="interface_name">
+        <annotation name="org.gtk.EggDBus.DocString" value="The name of the D-Bus interface."/>
+      </arg>
+      <arg direction="out" type="a{sv}" name="properties">
+        <annotation name="org.gtk.EggDBus.DocString" value="A dictionary containing all the properties."/>
+      </arg>
     </method>
 
     <method name="Set">
-      <arg direction="in"  type="s" name="interface_name"/>
-      <arg direction="in"  type="s" name="property_name"/>
-      <arg direction="in"  type="v" name="value"/>
+      <annotation name="org.gtk.EggDBus.DocString" value="Sets the value of the property with name @property_name on the interface with name @interface_name to @value."/>
+
+      <arg direction="in"  type="s" name="interface_name">
+        <annotation name="org.gtk.EggDBus.DocString" value="The name of the D-Bus interface."/>
+      </arg>
+      <arg direction="in"  type="s" name="property_name">
+        <annotation name="org.gtk.EggDBus.DocString" value="The name of the property."/>
+      </arg>
+      <arg direction="in"  type="v" name="value">
+        <annotation name="org.gtk.EggDBus.DocString" value="The value to set."/>
+      </arg>
     </method>
 
     <!-- Changed() is not yet in the D-Bus spec so prefix it -->
     <signal name="EggDBusChanged">
-      <arg type="s" name="interface_name"/>
-      <arg type="a{sv}" name="changed_properties"/>
+      <annotation name="org.gtk.EggDBus.DocString" value="Emitted when one or more properties change on an interface. Note: this signal is proprietary to EggDBus; no other D-Bus implementation will emit it."/>
+
+      <arg type="s" name="interface_name">
+        <annotation name="org.gtk.EggDBus.DocString" value="The name of the D-Bus interface."/>
+      </arg>
+      <arg type="a{sv}" name="changed_properties">
+        <annotation name="org.gtk.EggDBus.DocString" value="A dictionary containing the changed properties."/>
+      </arg>
     </signal>
 
   </interface>
diff --git a/src/eggdbus/org.freedesktop.DBus.xml b/src/eggdbus/org.freedesktop.DBus.xml
index 190efdf..fd265ba 100644
--- a/src/eggdbus/org.freedesktop.DBus.xml
+++ b/src/eggdbus/org.freedesktop.DBus.xml
@@ -3,32 +3,42 @@
 <node>
 
   <annotation name="org.gtk.EggDBus.DeclareFlags" value="RequestNameFlags">
+    <annotation name="org.gtk.EggDBus.DocString" value="Flags used in the RequestName() method."/>
+    <annotation name="org.gtk.EggDBus.DocString.Summary" value="Flags used in the RequestName() method"/>
+
+  <!-- ################################################################################ -->
+
     <annotation name="org.gtk.EggDBus.Flags.Member" value="AllowReplacement">
       <annotation name="org.gtk.EggDBus.Flags.Member.Value" value="0x01"/>
-      <annotation name="org.gtk.EggDBus.DocString" value="If an application A specifies this flag and succeeds in becoming the owner of the name, and another application B later calls request_name() with the REPLACE_EXISTING flag, then application A will lose ownership and receive a NameLost signal, and application B will become the new owner. If ALLOW_REPLACEMENT is not specified by application A, or REPLACE_EXISTING is not specified by application B, then application B will not replace application A as the owner"/>
+      <annotation name="org.gtk.EggDBus.DocString" value="If an application A specifies this flag and succeeds in becoming the owner of the name, and another application B later calls Request() with the #ReplaceExisting flag, then application A will lose ownership and receive a NameLost signal, and application B will become the new owner. If #AllowReplacement is not specified by application A, or #ReplaceExisiting is not specified by application B, then application B will not replace application A as the owner."/>
     </annotation>
     <annotation name="org.gtk.EggDBus.Flags.Member" value="ReplaceExisting">
       <annotation name="org.gtk.EggDBus.Flags.Member.Value" value="0x02"/>
-      <annotation name="org.gtk.EggDBus.DocString" value="Try to replace the current owner if there is one. If this flag is not set the application will only become the owner of the name if there is no current owner. If this flag is set, the application will replace the current owner if the current owner specified ALLOW_REPLACEMENT"/>
+      <annotation name="org.gtk.EggDBus.DocString" value="Try to replace the current owner if there is one. If this flag is not set the application will only become the owner of the name if there is no current owner. If this flag is set, the application will replace the current owner if the current owner specified #AllowReplacement."/>
     </annotation>
     <annotation name="org.gtk.EggDBus.Flags.Member" value="DoNotQueue">
       <annotation name="org.gtk.EggDBus.Flags.Member.Value" value="0x04"/>
-      <annotation name="org.gtk.EggDBus.DocString" value="Without this flag, if an application requests a name that is already owned, the application will be placed in a queue to own the name when the current owner gives it up. If this flag is given, the application will not be placed in the queue, the request for the name will simply fail. This flag also affects behavior when an application is replaced as name owner; by default the application moves back into the waiting queue, unless this flag was provided when the application became the name owner"/>
+      <annotation name="org.gtk.EggDBus.DocString" value="Without this flag, if an application requests a name that is already owned, the application will be placed in a queue to own the name when the current owner gives it up. If this flag is given, the application will not be placed in the queue, the request for the name will simply fail. This flag also affects behavior when an application is replaced as name owner; by default the application moves back into the waiting queue, unless this flag was provided when the application became the name owner."/>
     </annotation>
   </annotation>
 
   <annotation name="org.gtk.EggDBus.DeclareEnum" value="RequestNameReply">
+    <annotation name="org.gtk.EggDBus.DocString" value="Return values for the RequestName() method."/>
+    <annotation name="org.gtk.EggDBus.DocString.Summary" value="Return values for the RequestName() method"/>
+
+  <!-- ################################################################################ -->
+
     <annotation name="org.gtk.EggDBus.Enum.Member" value="PrimaryOwner">
       <annotation name="org.gtk.EggDBus.Enum.Member.Value" value="1"/>
-      <annotation name="org.gtk.EggDBus.DocString" value="The caller is now the primary owner of the name, replacing any previous owner. Either the name had no owner before, or the caller specified REPLACE_EXISTING and the current owner specified ALLOW_REPLACEMENT"/>
+      <annotation name="org.gtk.EggDBus.DocString" value="The caller is now the primary owner of the name, replacing any previous owner. Either the name had no owner before, or the caller specified #ReplaceExisting and the current owner specified #AllowReplacement."/>
     </annotation>
     <annotation name="org.gtk.EggDBus.Enum.Member" value="InQueue">
       <annotation name="org.gtk.EggDBus.Enum.Member.Value" value="2"/>
-      <annotation name="org.gtk.EggDBus.DocString" value="The name already had an owner, DO_NOT_QUEUE was not specified, and either the current owner did not specify ALLOW_REPLACEMENT or the requesting application did not specify REPLACE_EXISTING. "/>
+      <annotation name="org.gtk.EggDBus.DocString" value="The name already had an owner, #DoNotQueue was not specified, and either the current owner did not specify #AllowReplacement or the requesting application did not specify #ReplaceExisting."/>
     </annotation>
     <annotation name="org.gtk.EggDBus.Enum.Member" value="Exists">
       <annotation name="org.gtk.EggDBus.Enum.Member.Value" value="3"/>
-      <annotation name="org.gtk.EggDBus.DocString" value="The name already has an owner, DO_NOT_QUEUE was specified, and either ALLOW_REPLACEMENT was not specified by the current owner, or REPLACE_EXISTING was not specified by the requesting application"/>
+      <annotation name="org.gtk.EggDBus.DocString" value="The name already has an owner, #DoNotQueue was specified, and either #AllowReplacement was not specified by the current owner, or #ReplaceExisting was not specified by the requesting application."/>
     </annotation>
     <annotation name="org.gtk.EggDBus.Enum.Member" value="AlreadyOwned">
       <annotation name="org.gtk.EggDBus.Enum.Member.Value" value="4"/>
@@ -36,129 +46,260 @@
     </annotation>
   </annotation>
 
+  <!-- ################################################################################ -->
+
   <annotation name="org.gtk.EggDBus.DeclareEnum" value="ReleaseNameReply">
+    <annotation name="org.gtk.EggDBus.DocString" value="Return values for the ReleaseName() method."/>
+    <annotation name="org.gtk.EggDBus.DocString.Summary" value="Return values for the ReleaseName() method"/>
+
     <annotation name="org.gtk.EggDBus.Enum.Member" value="Released">
       <annotation name="org.gtk.EggDBus.Enum.Member.Value" value="1"/>
-      <annotation name="org.gtk.EggDBus.DocString" value="The caller has released his claim on the given name. Either the caller was the primary owner of the name, and the name is now unused or taken by somebody waiting in the queue for the name, or the caller was waiting in the queue for the name and has now been removed from the queue"/>
+      <annotation name="org.gtk.EggDBus.DocString" value="The caller has released his claim on the given name. Either the caller was the primary owner of the name, and the name is now unused or taken by somebody waiting in the queue for the name, or the caller was waiting in the queue for the name and has now been removed from the queue."/>
     </annotation>
     <annotation name="org.gtk.EggDBus.Enum.Member" value="NonExistant">
       <annotation name="org.gtk.EggDBus.Enum.Member.Value" value="2"/>
-      <annotation name="org.gtk.EggDBus.DocString" value="The given name does not exist on this bus"/>
+      <annotation name="org.gtk.EggDBus.DocString" value="The given name does not exist on this bus."/>
     </annotation>
     <annotation name="org.gtk.EggDBus.Enum.Member" value="NotOwner">
       <annotation name="org.gtk.EggDBus.Enum.Member.Value" value="3"/>
-      <annotation name="org.gtk.EggDBus.DocString" value="The caller was not the primary owner of this name, and was also not waiting in the queue to own this name"/>
+      <annotation name="org.gtk.EggDBus.DocString" value="The caller was not the primary owner of this name, and was also not waiting in the queue to own this name."/>
     </annotation>
   </annotation>
 
+  <!-- ################################################################################ -->
+
+  <annotation name="org.gtk.EggDBus.DeclareEnum" value="StartServiceByNameReply">
+    <annotation name="org.gtk.EggDBus.DocString" value="Return values for the StartServiceByName() method."/>
+    <annotation name="org.gtk.EggDBus.DocString.Summary" value="Return values for the StartServiceByName() method"/>
+
+    <annotation name="org.gtk.EggDBus.Enum.Member" value="Success">
+      <annotation name="org.gtk.EggDBus.Enum.Member.Value" value="1"/>
+      <annotation name="org.gtk.EggDBus.DocString" value="The service was successfully started."/>
+    </annotation>
+    <annotation name="org.gtk.EggDBus.Enum.Member" value="AlreadyRunning">
+      <annotation name="org.gtk.EggDBus.Enum.Member.Value" value="2"/>
+      <annotation name="org.gtk.EggDBus.DocString" value="A connection already owns the given name."/>
+    </annotation>
+  </annotation>
+
+  <!-- ################################################################################ -->
+
   <interface name="org.freedesktop.DBus">
+    <annotation name="org.gtk.EggDBus.DocString" value="The <literal>org.freedesktop.DBus</literal> D-Bus interface is implemented by message bus daemons. Normally applications only use the RequestName() method to claim a well-known name on the message bus."/>
+    <annotation name="org.gtk.EggDBus.DocString.Summary" value="org.freedesktop.DBus interface"/>
+
     <annotation name="org.gtk.EggDBus.Name" value="Bus"/>
 
     <method name="Hello">
-      <arg direction="out" type="s" name="assigned_name"/>
+      <annotation name="org.gtk.EggDBus.DocString" value="Before an application is able to send messages to other applications it must invoke this method on the message bus to obtain a unique name. If an application without a unique name tries to send a message to another application, or a message to the message bus itself that isn't the Hello() method, it will be disconnected from the bus. There is no corresponding <emphasis>disconnect</emphasis> request; if a client wishes to disconnect from the bus, it simply closes the socket (or other communication channel)."/>
+
+      <arg direction="out" type="s" name="assigned_name">
+        <annotation name="org.gtk.EggDBus.DocString" value="Unique name assigned to the connection."/>
+      </arg>
     </method>
 
     <method name="RequestName">
-      <arg direction="in" type="s" name="name"/>
+      <annotation name="org.gtk.EggDBus.DocString" value="This method call should be invoked on the <literal>org.freedesktop.DBus</literal> name to request the message bus to assign the given name to the method caller. Each name maintains a queue of possible owners, where the head of the queue is the primary or current owner of the name. Each potential owner in the queue maintains the #AllowReplacement and #DoNotQueue settings from its latest RequestName() call. See the D-Bus specification for more details."/>
+
+      <arg direction="in" type="s" name="name">
+        <annotation name="org.gtk.EggDBus.DocString" value="Name to request."/>
+      </arg>
       <arg direction="in" type="u" name="flags">
         <annotation name="org.gtk.EggDBus.FlagsType" value="RequestNameFlags"/>
+        <annotation name="org.gtk.EggDBus.DocString" value="Flags."/>
       </arg>
       <arg direction="out" type="u" name="value">
         <annotation name="org.gtk.EggDBus.EnumType" value="RequestNameReply"/>
+        <annotation name="org.gtk.EggDBus.DocString" value="Return value."/>
       </arg>
     </method>
 
     <method name="ReleaseName">
-      <arg direction="in" type="s" name="name"/>
+      <annotation name="org.gtk.EggDBus.DocString" value="This method call should be invoked on the <literal>org.freedesktop.DBus</literal> name to request the message bus to release the method caller's claim to the given name. If the caller is the primary owner, a new primary owner will be selected from the queue if any other owners are waiting. If the caller is waiting in the queue for the name, the caller will removed from the queue and will not be made an owner of the name if it later becomes available. If there are no other owners in the queue for the name, it will be removed from the bus entirely."/>
+
+      <arg direction="in" type="s" name="name">
+        <annotation name="org.gtk.EggDBus.DocString" value="Name to release."/>
+      </arg>
       <arg direction="out" type="u" name="value">
         <annotation name="org.gtk.EggDBus.EnumType" value="ReleaseNameReply"/>
+        <annotation name="org.gtk.EggDBus.DocString" value="Return value."/>
       </arg>
     </method>
 
     <method name="StartServiceByName">
-      <arg direction="in" type="s" name="name"/>
-      <arg direction="in" type="u" name="flags"/>
-      <arg direction="out" type="u" name="value"/>
+      <annotation name="org.gtk.EggDBus.DocString" value="Tries to launch the executable associated with @name. See the D-Bus specification for more details on service activation."/>
+
+      <arg direction="in" type="s" name="name">
+        <annotation name="org.gtk.EggDBus.DocString" value="Name of the service to start."/>
+      </arg>
+      <arg direction="in" type="u" name="flags">
+        <annotation name="org.gtk.EggDBus.DocString" value="Flags (currently not used)."/>
+      </arg>
+      <arg direction="out" type="u" name="value">
+        <annotation name="org.gtk.EggDBus.EnumType" value="StartServiceByNameReply"/>
+        <annotation name="org.gtk.EggDBus.DocString" value="Reply"/>
+      </arg>
     </method>
 
     <method name="UpdateActivationEnvironment">
-      <arg direction="in" type="a{ss}" name="env_hash"/>
+      <annotation name="org.gtk.EggDBus.DocString" value="Normally, session bus activated services inherit the environment of the bus daemon.  This method adds to or modifies that environment when activating services. Some bus instances, such as the standard system bus, may disable access to this method for some or all callers."/>
+
+      <arg direction="in" type="a{ss}" name="env_hash">
+        <annotation name="org.gtk.EggDBus.DocString" value="Environment to add or update."/>
+      </arg>
     </method>
 
     <method name="NameHasOwner">
-      <arg direction="in" type="s" name="name"/>
-      <arg direction="out" type="b" name="has_owner"/>
+      <annotation name="org.gtk.EggDBus.DocString" value="Checks if the specified name exists (currently has an owner)."/>
+
+      <arg direction="in" type="s" name="name">
+        <annotation name="org.gtk.EggDBus.DocString" value="Name to check."/>
+      </arg>
+      <arg direction="out" type="b" name="has_owner">
+        <annotation name="org.gtk.EggDBus.DocString" value="%TRUE only if @name exists."/>
+      </arg>
     </method>
 
     <method name="ListNames">
-      <arg direction="out" type="as" name="names"/>
+      <annotation name="org.gtk.EggDBus.DocString" value="Returns a list of all currently-owned names on the bus."/>
+
+      <arg direction="out" type="as" name="names">
+        <annotation name="org.gtk.EggDBus.DocString" value="Array of strings where each string is a bus name."/>
+      </arg>
     </method>
 
     <method name="ListActivatableNames">
-      <arg direction="out" type="as" name="activatable_names"/>
+      <annotation name="org.gtk.EggDBus.DocString" value="Returns a list of all names that can be activated on the bus."/>
+
+      <arg direction="out" type="as" name="activatable_names">
+        <annotation name="org.gtk.EggDBus.DocString" value="Array of strings where each string is a bus name."/>
+      </arg>
     </method>
 
     <method name="AddMatch">
-      <arg direction="in" type="s" name="rule"/>
+      <annotation name="org.gtk.EggDBus.DocString" value="Adds a match rule to match messages going through the message bus. If the bus does not have enough resources the #OOM error is returned. See the D-Bus specification for more information about match rules."/>
+
+      <arg direction="in" type="s" name="rule">
+        <annotation name="org.gtk.EggDBus.DocString" value="Match rule to add to the connection."/>
+      </arg>
     </method>
 
     <method name="RemoveMatch">
-      <arg direction="in" type="s" name="rule"/>
+      <annotation name="org.gtk.EggDBus.DocString" value="Removes the first rule that matches. If the rule is not found the org.freedesktop.DBus.Error.MatchRuleNotFound  error is returned. See the D-Bus specification for more information about match rules."/>
+
+      <arg direction="in" type="s" name="rule">
+        <annotation name="org.gtk.EggDBus.DocString" value="Match rule to remove from the connection."/>
+      </arg>
     </method>
 
     <method name="GetNameOwner">
-      <arg direction="in" type="s" name="name"/>
-      <arg direction="out" type="s" name="unique_name"/>
+      <annotation name="org.gtk.EggDBus.DocString" value="Returns the unique connection name of the primary owner of the name given. If the requested name doesn't have an owner, returns a #NameHasNoOwner error."/>
+
+      <arg direction="in" type="s" name="name">
+        <annotation name="org.gtk.EggDBus.DocString" value="Name to get owner of."/>
+      </arg>
+      <arg direction="out" type="s" name="unique_name">
+        <annotation name="org.gtk.EggDBus.DocString" value="The unique name that owns @name."/>
+      </arg>
     </method>
 
     <method name="ListQueuedOwners">
-      <arg direction="in" type="s" name="name"/>
-      <arg direction="out" type="as" name="queued_owners"/>
+      <annotation name="org.gtk.EggDBus.DocString" value="Lists the names waiting in queue to own @name."/>
+
+      <arg direction="in" type="s" name="name">
+        <annotation name="org.gtk.EggDBus.DocString" value="A well-known name."/>
+      </arg>
+      <arg direction="out" type="as" name="queued_owners">
+        <annotation name="org.gtk.EggDBus.DocString" value="Array of unique names in queue to own @name."/>
+      </arg>
     </method>
 
     <method name="GetConnectionUnixUser">
-      <arg direction="in" type="s" name="name"/>
+      <annotation name="org.gtk.EggDBus.DocString" value="Returns the UNIX user id of the process connected to the server. If unable to determine it, a #Failed error is returned."/>
+
+      <arg direction="in" type="s" name="name">
+        <annotation name="org.gtk.EggDBus.DocString" value="Name of the connection to query."/>
+      </arg>
       <arg direction="out" type="u" name="uid">
         <annotation name="org.gtk.EggDBus.CType" value="uid_t"/>
+        <annotation name="org.gtk.EggDBus.DocString" value="UNIX user id."/>
       </arg>
     </method>
 
     <method name="GetConnectionUnixProcessID">
-      <arg direction="in" type="s" name="name"/>
+      <annotation name="org.gtk.EggDBus.DocString" value="Returns the UNIX process id of the process connected to the server. If unable to determine it, a #Failed error is returned."/>
+
+      <arg direction="in" type="s" name="name">
+        <annotation name="org.gtk.EggDBus.DocString" value="Name of the connection to query."/>
+      </arg>
       <arg direction="out" type="u" name="pid">
         <annotation name="org.gtk.EggDBus.CType" value="pid_t"/>
+        <annotation name="org.gtk.EggDBus.DocString" value="UNIX process id."/>
       </arg>
     </method>
 
     <method name="GetAdtAuditSessionData">
-      <arg direction="in" type="s" name="name"/>
-      <arg direction="out" type="ay" name="data"/>
+      <annotation name="org.gtk.EggDBus.DocString" value="Returns the Solaris/ADT auditing data of the process connected to the server. If unable to determine it, a #AdtAuditDataUnknown error is returned."/>
+
+      <arg direction="in" type="s" name="name">
+        <annotation name="org.gtk.EggDBus.DocString" value="Name of the connection to query."/>
+      </arg>
+      <arg direction="out" type="ay" name="data">
+        <annotation name="org.gtk.EggDBus.DocString" value="An array of bytes (typically a string of undefined encoding)."/>
+      </arg>
     </method>
 
     <method name="GetConnectionSELinuxSecurityContext">
-      <arg direction="in" type="s" name="name"/>
-      <arg direction="out" type="ay" name="security_context"/>
+      <annotation name="org.gtk.EggDBus.DocString" value="Returns the SELinux security context of the process connected to the server. If unable to determine it, a #SELinuxSecurityContextUnknown error is returned."/>
+
+      <arg direction="in" type="s" name="name">
+        <annotation name="org.gtk.EggDBus.DocString" value="Name of the connection to query."/>
+      </arg>
+      <arg direction="out" type="ay" name="security_context">
+        <annotation name="org.gtk.EggDBus.DocString" value="An array of bytes (typically a string of undefined encoding)."/>
+      </arg>
     </method>
 
     <method name="ReloadConfig">
+      <annotation name="org.gtk.EggDBus.DocString" value="Asks the message bus to reload configuration files."/>
     </method>
 
     <method name="GetId">
-      <arg direction="out" type="s" name="unique_id"/>
+      <annotation name="org.gtk.EggDBus.DocString" value="Gets the unique ID of the bus. The unique ID here is shared among all addresses the bus daemon is listening on (TCP, UNIX domain socket, etc.). Each address the bus is listening on also has its own unique ID. The per-bus and per-address IDs are not related. For a desktop session bus, the bus ID can be used as a way to uniquely identify a user's session. See the D-Bus specification for more information about unique IDs."/>
+
+      <arg direction="out" type="s" name="unique_id">
+        <annotation name="org.gtk.EggDBus.DocString" value="Unique ID identifying the bus daemon"/>
+      </arg>
     </method>
 
     <signal name="NameOwnerChanged">
-      <arg type="s" name="name"/>
-      <arg type="s" name="old_owner"/>
-      <arg type="s" name="new_owner"/>
+      <annotation name="org.gtk.EggDBus.DocString" value="This signal indicates that the owner of a name has changed. It's also the signal to use to detect the appearance of new names on the bus."/>
+
+      <arg type="s" name="name">
+        <annotation name="org.gtk.EggDBus.DocString" value="Name with new owner."/>
+      </arg>
+      <arg type="s" name="old_owner">
+        <annotation name="org.gtk.EggDBus.DocString" value="Old owner or empty string if none."/>
+      </arg>
+      <arg type="s" name="new_owner">
+        <annotation name="org.gtk.EggDBus.DocString" value="New owner or empty string if none."/>
+      </arg>
     </signal>
 
     <signal name="NameLost">
-      <arg type="s" name="name"/>
+      <annotation name="org.gtk.EggDBus.DocString" value="This signal is sent to a specific application when it loses ownership of a name."/>
+
+      <arg type="s" name="name">
+        <annotation name="org.gtk.EggDBus.DocString" value="Name which was lost."/>
+      </arg>
     </signal>
 
     <signal name="NameAcquired">
-      <arg type="s" name="name"/>
+      <annotation name="org.gtk.EggDBus.DocString" value="This signal is sent to a specific application when it gains ownership of a name."/>
+
+      <arg type="s" name="name">
+        <annotation name="org.gtk.EggDBus.DocString" value="Name which was acquired."/>
+      </arg>
     </signal>
 
   </interface>