libpurple: Fix GObject introspection annotations on a few functions

Thu, 13 Dec 2018 17:32:40 -0600

author
Mike Ruprecht <cmaiku@gmail.com>
date
Thu, 13 Dec 2018 17:32:40 -0600
changeset 39392
cfefc4838611
parent 39391
ec535138dc4a
child 39393
ef0709f52a26

libpurple: Fix GObject introspection annotations on a few functions

This patch adds some missing "transfer" and "element-type" annotations
on functions in libpurple/xfer.h. It also fixes a documentation
comment which was pointing to the wrong function.

libpurple/xfer.h file | annotate | diff | comparison | revisions
--- a/libpurple/xfer.h	Thu Dec 13 17:19:58 2018 -0600
+++ b/libpurple/xfer.h	Thu Dec 13 17:32:40 2018 -0600
@@ -307,7 +307,7 @@
  *
  * Returns the account the file transfer is using.
  *
- * Returns: The account.
+ * Returns: (transfer none): The account.
  */
 PurpleAccount *purple_xfer_get_account(const PurpleXfer *xfer);
 
@@ -935,7 +935,8 @@
  *
  * Returns all xfers
  *
- * Returns: all current xfers with refs
+ * Returns: (element-type Purple.Xfer) (transfer none): all current xfers
+ *          with refs
  */
 GList *purple_xfers_get_all(void);
 
@@ -1014,14 +1015,14 @@
 void purple_protocol_xfer_send_file(PurpleProtocolXfer *prplxfer, PurpleConnection *connection, const gchar *who, const gchar *filename);
 
 /**
- * purple_protocol_xfer_send:
+ * purple_protocol_xfer_new_xfer:
  * @prplxfer: The #PurpleProtocolXfer implementer instance
  * @connection: The #PurpleConnection that we're checking
  * @who: The user that we want to send a file transfer to.
  *
  * Creates a new #PurpleXfer to @who.
  *
- * Returns: A new #PurpleXfer instance.
+ * Returns: (transfer full): A new #PurpleXfer instance.
  */
 PurpleXfer *purple_protocol_xfer_new_xfer(PurpleProtocolXfer *prplxfer, PurpleConnection *connection, const gchar *who);
 

mercurial