2003-02-15 Havoc Pennington <hp@pobox.com>

	* dbus/dbus-message.c (dbus_message_new): fool around with the
	docs

diff --git a/ChangeLog b/ChangeLog
index ff3f295..bce8784 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,8 @@
+2003-02-15  Havoc Pennington  <hp@pobox.com>
+
+       * dbus/dbus-message.c (dbus_message_new): fool around with the
+       docs
+
 2003-02-14  Havoc Pennington  <hp@pobox.com>
 
        * dbus/dbus-mempool.c: fail if the debug functions so indicate

diff --git a/dbus/dbus-message.c b/dbus/dbus-message.c
index 4ea2a63..91ff29d 100644 (file)
--- a/dbus/dbus-message.c
+++ b/dbus/dbus-message.c
@@ -746,12 +746,15 @@ dbus_message_new_empty_header (void)
 
 
 /**
- * Constructs a new message. Returns #NULL if memory
- * can't be allocated for the message.
+ * Constructs a new message. Returns #NULL if memory can't be
+ * allocated for the message. The service may be #NULL in which case
+ * no service is set; this is appropriate when using D-BUS in a
+ * peer-to-peer context (no message bus).
  *
- * @todo use DBusString internally to store service and name.
+ * @todo reverse the arguments, first 'name' then 'service'
+ * as 'name' is more fundamental
  *
- * @param service service that the message should be sent to
+ * @param service service that the message should be sent to or #NULL
  * @param name name of the message
  * @returns a new DBusMessage, free with dbus_message_unref()
  * @see dbus_message_unref()