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 --- dbus/dbus-message.c | 11 +++++++---- 1 file changed, 7 insertions(+), 4 deletions(-) (limited to 'dbus') 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