2004-03-18 Richard Hult <richard@imendio.com>

	* dbus/dbus-message.c (dbus_message_get_auto_activation)
	(dbus_message_set_auto_activation): Add doxygen docs.

diff --git a/ChangeLog b/ChangeLog
index 809664e..afafe0a 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,8 @@
+2004-03-18  Richard Hult  <richard@imendio.com>
+
+       * dbus/dbus-message.c (dbus_message_get_auto_activation) 
+       (dbus_message_set_auto_activation): Add doxygen docs.
+
 2004-03-16  Richard Hult  <richard@imendio.com>
 
        * bus/activation.c: (bus_activation_service_created),

diff --git a/dbus/dbus-message.c b/dbus/dbus-message.c
index 696b250..63e2afe 100644 (file)
--- a/dbus/dbus-message.c
+++ b/dbus/dbus-message.c
@@ -4387,6 +4387,16 @@ dbus_message_get_no_reply (DBusMessage *message)
   return (*header & DBUS_HEADER_FLAG_NO_REPLY_EXPECTED) != 0;
 }
 
+
+/**
+ * Sets a flag indicating that the addressed service will be auto-activated
+ * before the message is delivered. When this flag is set, the message is held
+ * until the service is succesfully activated or fail to activate. In case of
+ * failure, the reply will be an activation error.
+ *
+ * @param message the message
+ * @param auto_activation #TRUE if auto-activation is desired
+ */
 void
 dbus_message_set_auto_activation (DBusMessage *message,
                                  dbus_bool_t  auto_activation)
@@ -4404,6 +4414,13 @@ dbus_message_set_auto_activation (DBusMessage *message,
     *header &= ~DBUS_HEADER_FLAG_AUTO_ACTIVATION;
 }
 
+/**
+ * Returns #TRUE if the message will cause the addressed service to be
+ * auto-activated.
+ *
+ * @param message the message
+ * @returns #TRUE if the message will use auto-activation
+ */
 dbus_bool_t
 dbus_message_get_auto_activation (DBusMessage *message)
 {