diff options
| author | Havoc Pennington <hp@redhat.com> | 2003-04-18 04:18:57 +0000 |
|---|---|---|
| committer | Havoc Pennington <hp@redhat.com> | 2003-04-18 04:18:57 +0000 |
| commit | 3df260c07102745c5606c313af862558f105f83e (patch) | |
| tree | b0a9d23fc820a3bc61da1cd7e63fc810423a2210 /dbus/dbus-message.c | |
| parent | 88cd5da3c0ec86fed29942b062c2f7bf0f8fda44 (diff) | |
2003-04-18 Havoc Pennington <hp@pobox.com>
* glib/dbus-gmain.c: adapt to watch changes
* bus/bus.c, bus/activation.c, etc.: adjust to watch changes
* dbus/dbus-server.h: remove dbus_server_handle_watch
* dbus/dbus-connection.h: remove dbus_connection_handle_watch
* dbus/dbus-watch.c (dbus_watch_handle): change DBusWatch to work
like DBusTimeout, so we don't need dbus_connection_handle_watch
etc.
Diffstat (limited to 'dbus/dbus-message.c')
| -rw-r--r-- | dbus/dbus-message.c | 20 |
1 files changed, 12 insertions, 8 deletions
diff --git a/dbus/dbus-message.c b/dbus/dbus-message.c index fda50d6c..ee42947d 100644 --- a/dbus/dbus-message.c +++ b/dbus/dbus-message.c @@ -104,7 +104,7 @@ struct DBusMessage DBusList *size_counters; /**< 0-N DBusCounter used to track message size. */ long size_counter_delta; /**< Size we incremented the size counters by. */ - dbus_uint32_t changed_stamp; + dbus_uint32_t changed_stamp; /**< Incremented when iterators are invalidated. */ unsigned int locked : 1; /**< Message being sent, no modifications allowed. */ }; @@ -115,6 +115,7 @@ enum { DBUS_MESSAGE_ITER_TYPE_DICT }; +/** typedef for internals of message iterator */ typedef struct DBusMessageRealIter DBusMessageRealIter; /** @@ -1689,7 +1690,7 @@ dbus_message_iter_get_args_valist (DBusMessageIter *iter, * message passed in. * * @param message the message - * @param _iter pointer to an iterator to initialize + * @param iter pointer to an iterator to initialize */ void dbus_message_iter_init (DBusMessage *message, @@ -1825,7 +1826,7 @@ dbus_message_iter_has_next (DBusMessageIter *iter) /** * Moves the iterator to the next field. * - * @param _iter The message iter + * @param iter The message iter * @returns #TRUE if the iterator was moved to the next field */ dbus_bool_t @@ -2486,7 +2487,7 @@ dbus_message_iter_get_dict_key (DBusMessageIter *iter) * message. * * @param message the message - * @param _iter pointer to an iterator to initialize + * @param iter pointer to an iterator to initialize */ void dbus_message_append_iter_init (DBusMessage *message, @@ -2789,11 +2790,15 @@ dbus_message_iter_append_string (DBusMessageIter *iter, } /** - * Appends a named type data chunk to the message. + * Appends a named type data chunk to the message. A named + * type is simply an arbitrary UTF-8 string used as a type + * tag, plus an array of arbitrary bytes to be interpreted + * according to the type tag. * * @param iter an iterator pointing to the end of the message * @param name the name of the type - * @parame + * @param data the binary data used to store the value + * @param len the length of the binary data in bytes * @returns #TRUE on success */ dbus_bool_t @@ -3003,8 +3008,7 @@ dbus_message_iter_append_array (DBusMessageIter *iter, * can be used to append to the dict. * * @param iter an iterator pointing to the end of the message - * @param array_iter pointer to an iter that will be initialized - * @param element_type the type of the array elements + * @param dict_iter pointer to an iter that will be initialized * @returns #TRUE on success */ dbus_bool_t |