From 15ef0ef6fbba7827453b7973e62b6c1853576601 Mon Sep 17 00:00:00 2001 From: Havoc Pennington Date: Fri, 20 Oct 2006 03:05:00 +0000 Subject: 2006-10-19 Havoc Pennington * Fix a pile of Doxygen warnings and missing docs --- dbus/dbus-message.c | 9 +++++++-- 1 file changed, 7 insertions(+), 2 deletions(-) (limited to 'dbus/dbus-message.c') 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 */ -- cgit