From 9af7f45b6c6c0bced214b4ce7286eec912ba4007 Mon Sep 17 00:00:00 2001 From: Havoc Pennington Date: Sat, 15 Feb 2003 14:55:11 +0000 Subject: 2003-02-15 Havoc Pennington * dbus/dbus-message.c (dbus_message_new): fool around with the docs --- ChangeLog | 5 +++++ dbus/dbus-message.c | 11 +++++++---- 2 files changed, 12 insertions(+), 4 deletions(-) diff --git a/ChangeLog b/ChangeLog index ff3f2952..bce8784a 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,8 @@ +2003-02-15 Havoc Pennington + + * dbus/dbus-message.c (dbus_message_new): fool around with the + docs + 2003-02-14 Havoc Pennington * dbus/dbus-mempool.c: fail if the debug functions so indicate diff --git a/dbus/dbus-message.c b/dbus/dbus-message.c index 4ea2a631..91ff29da 100644 --- 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() -- cgit