changeset 8794:4048e93b8ece

[gaim-migrate @ 9556] Yay committer: Tailor Script <tailor@pidgin.im>
author Mark Doliner <mark@kingant.net>
date Sat, 24 Apr 2004 12:03:43 +0000
parents d72a23b2bfb5
children f7ee50e4d534
files src/protocols/oscar/tlv.c
diffstat 1 files changed, 5 insertions(+), 4 deletions(-) [+]
line wrap: on
line diff
--- a/src/protocols/oscar/tlv.c	Sat Apr 24 11:58:42 2004 +0000
+++ b/src/protocols/oscar/tlv.c	Sat Apr 24 12:03:43 2004 +0000
@@ -570,8 +570,9 @@
  * @param list Destination chain.
  * @param type TLV type to add.
  * @param t1 The TLV chain you want to write.
- * @return The number of bytes that would be needed to
- *         write the passed TLV chain to a data buffer.
+ * @return The number of bytes written to the destination TLV chain.
+ *         0 is returned if there was an error or if the destination
+ *         TLV chain has length 0.
  */
 faim_internal int aim_tlvlist_add_frozentlvlist(aim_tlvlist_t **list, fu16_t type, aim_tlvlist_t **tl)
 {
@@ -717,7 +718,7 @@
 }
 
 /**
- * aim_tlvlist_write - Write a TLV chain into a data buffer.
+ * Write a TLV chain into a data buffer.
  *
  * Copies a TLV chain into a raw data buffer, writing only the number
  * of bytes specified. This operation does not free the chain; 
@@ -728,7 +729,7 @@
  *
  * @param bs Input bstream
  * @param list Source TLV chain
- * @return Return 0 if there is not enough buffer, otherwise return 1.
+ * @return Return 0 if the destination bstream is too small.
  */
 faim_internal int aim_tlvlist_write(aim_bstream_t *bs, aim_tlvlist_t **list)
 {