Mercurial > pidgin3 / file diff

--- a/libpurple/mime.h	Fri Jan 31 18:25:09 2014 +0530
+++ b/libpurple/mime.h	Fri Jan 31 18:46:39 2014 +0530
@@ -63,7 +63,7 @@
  *
  * @buf: The NULL-terminated string containing the MIME-encoded data.
  *
- * Returns:s A MIME document.
+ * Returns: A MIME document.
  */
 PurpleMimeDocument *purple_mime_document_parse(const char *buf);
 
@@ -73,7 +73,7 @@
  * @buf: The string containing the MIME-encoded data.
  * @len: Length of buf.
  *
- * Returns:s   A MIME document.
+ * Returns:   A MIME document.
  */
 PurpleMimeDocument *purple_mime_document_parsen(const char *buf, gsize len);
 
@@ -87,8 +87,8 @@
  *
  * @doc: The MIME document.
  *
- * Returns: (TODO const): A list of strings indicating the fields (but not the values
- *              of the fields) in the header of doc.
+ * Returns: (transfer none): A list of strings indicating the fields (but not
+ *          the values of the fields) in the header of doc.
  */
 GList *purple_mime_document_get_fields(PurpleMimeDocument *doc);
 
@@ -98,7 +98,7 @@
  * @doc:   The MIME document.
  * @field: Case-insensitive field name.
  *
- * Returns:s     Value associated with the indicated header field, or
+ * Returns:     Value associated with the indicated header field, or
  *              NULL if the field doesn't exist.
  */
 const char *purple_mime_document_get_field(PurpleMimeDocument *doc,
@@ -122,7 +122,7 @@
  *
  * @doc: The MIME document.
  *
- * Returns: (TODO const):   List of PurpleMimePart contained within doc.
+ * Returns: (transfer none):   List of PurpleMimePart contained within doc.
  */
 GList *purple_mime_document_get_parts(PurpleMimeDocument *doc);
 
@@ -139,8 +139,8 @@
  *
  * @part: The MIME document part.
  *
- * Returns: (TODO const): List of strings indicating the fields (but not the values
- *              of the fields) in the header of part.
+ * Returns: (transfer none): List of strings indicating the fields (but not the
+ *          values of the fields) in the header of part.
  */
 GList *purple_mime_part_get_fields(PurpleMimePart *part);
 
@@ -151,7 +151,7 @@
  * @part:  The MIME document part.
  * @field: Case-insensitive name of the header field.
  *
- * Returns:s     Value of the specified header field, or NULL if the
+ * Returns:     Value of the specified header field, or NULL if the
  *              field doesn't exist.
  */
 const char *purple_mime_part_get_field(PurpleMimePart *part,
@@ -182,7 +182,7 @@
  *
  * @part: The MIME document part.
  *
- * Returns:s    NULL-terminated data found in the document part
+ * Returns:    NULL-terminated data found in the document part
  */
 const char *purple_mime_part_get_data(PurpleMimePart *part);
 
@@ -203,7 +203,7 @@
  * Get the length of the data portion of a MIME document part.
  *
  * @part: The MIME document part.
- * Returns:s    Length of the data in the document part.
+ * Returns:    Length of the data in the document part.
  */
 gsize purple_mime_part_get_length(PurpleMimePart *part);