dbus/dbus dbus-message.c,1.121,1.122

[Richard Hult]

Update of /cvs/dbus/dbus/dbus
In directory pdx:/tmp/cvs-serv26122/dbus

Modified Files:
	dbus-message.c 
Log Message:
2004-03-18  Richard Hult  <richard at imendio.com>

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


Index: dbus-message.c
===================================================================
RCS file: /cvs/dbus/dbus/dbus/dbus-message.c,v
retrieving revision 1.121
retrieving revision 1.122
diff -u -d -r1.121 -r1.122
--- a/dbus-message.c	16 Mar 2004 18:00:35 -0000	1.121
+++ b/dbus-message.c	18 Mar 2004 11:10:59 -0000	1.122
@@ -4387,6 +4387,16 @@
   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 @@
     *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)
 {