X-Git-Url: http://review.tizen.org/git/?a=blobdiff_plain;f=dbus%2Fdbus-marshal-header.c;h=88887a82a59333263f34a15a49b8ae5f740ac1ae;hb=757b80b9711d9733798c927495d74c7323e95400;hp=4a763fbaa6a7103dc82ba2a21b23920176840169;hpb=443b8ec3da541018f2979e3700bc8d4ee7095136;p=platform%2Fupstream%2Fdbus.git

diff --git a/dbus/dbus-marshal-header.c b/dbus/dbus-marshal-header.c
index 4a763fb..88887a8 100644
--- a/dbus/dbus-marshal-header.c
+++ b/dbus/dbus-marshal-header.c
@@ -1200,6 +1200,19 @@ _dbus_header_update_lengths (DBusHeader *header,
                             _dbus_header_get_byte_order (header));
 }
 
+/**
+ * Try to find the given field.
+ *
+ * @param header the header
+ * @param field the field code
+ * @param reader a type reader; on success this is left pointing at the struct
+ *  (uv) for the field, while on failure it is left pointing into empty space
+ *  at the end of the header fields
+ * @param realign_root another type reader; on success or failure it is left
+ *  pointing to the beginning of the array of fields (i.e. the thing that might
+ *  need realigning)
+ * @returns #TRUE on success
+ */
 static dbus_bool_t
 find_field_for_modification (DBusHeader     *header,
                              int             field,