summaryrefslogtreecommitdiffstats
path: root/dbus/dbus-message.c
diff options
context:
space:
mode:
authorHavoc Pennington <hp@redhat.com>2006-10-20 03:05:00 +0000
committerHavoc Pennington <hp@redhat.com>2006-10-20 03:05:00 +0000
commit15ef0ef6fbba7827453b7973e62b6c1853576601 (patch)
treeed41d284f4b698c44d9a9e202be4d4f25c1aab60 /dbus/dbus-message.c
parentfe1f793a4f8296fb00d409a4a52b12ed7526caac (diff)
2006-10-19 Havoc Pennington <hp@redhat.com>
* Fix a pile of Doxygen warnings and missing docs
Diffstat (limited to 'dbus/dbus-message.c')
-rw-r--r--dbus/dbus-message.c9
1 files changed, 7 insertions, 2 deletions
diff --git a/dbus/dbus-message.c b/dbus/dbus-message.c
index 9b0d7a0b..80eee1cb 100644
--- a/dbus/dbus-message.c
+++ b/dbus/dbus-message.c
@@ -126,6 +126,12 @@ _dbus_message_byteswap (DBusMessage *message)
_dbus_header_byteswap (&message->header, DBUS_COMPILER_BYTE_ORDER);
}
+/** byte-swap the message if it doesn't match our byte order.
+ * Called only when we need the message in our own byte order,
+ * normally when reading arrays of integers or doubles.
+ * Otherwise should not be called since it would do needless
+ * work.
+ */
#define ensure_byte_order(message) \
if (message->byte_order != DBUS_COMPILER_BYTE_ORDER) \
_dbus_message_byteswap (message)
@@ -1119,10 +1125,9 @@ dbus_message_unref (DBusMessage *message)
* #DBUS_MESSAGE_TYPE_METHOD_CALL, #DBUS_MESSAGE_TYPE_METHOD_RETURN,
* #DBUS_MESSAGE_TYPE_ERROR, #DBUS_MESSAGE_TYPE_SIGNAL, but other
* types are allowed and all code must silently ignore messages of
- * unknown type. DBUS_MESSAGE_TYPE_INVALID will never be returned,
+ * unknown type. #DBUS_MESSAGE_TYPE_INVALID will never be returned,
* however.
*
- *
* @param message the message
* @returns the type of the message
*/