summaryrefslogtreecommitdiffstats
path: root/dbus/dbus-message.c
diff options
context:
space:
mode:
Diffstat (limited to 'dbus/dbus-message.c')
-rw-r--r--dbus/dbus-message.c11
1 files changed, 7 insertions, 4 deletions
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()