/soc/2013/ankitkv/gobjectification: f4740b6e7525: Add (scope) an...

[Ankit Vani]

Changeset: f4740b6e75254bc9687e4091c4c908a3af25b65b
Author:	 Ankit Vani <a at nevitus.org>
Date:	 2014-04-03 09:37 +0530
Branch:	 soc.2013.gobjectification.plugins
URL: https://hg.pidgin.im/soc/2013/ankitkv/gobjectification/rev/f4740b6e7525

Description:

Add (scope) annotation to callback parameters in plugins.h, protocol.h, protocols.h

diffstat:

 libpurple/plugins.h   |   3 ++-
 libpurple/protocol.h  |  14 ++++++++++++++
 libpurple/protocols.h |   3 ++-
 3 files changed, 18 insertions(+), 2 deletions(-)

diffs (62 lines):

diff --git a/libpurple/plugins.h b/libpurple/plugins.h
--- a/libpurple/plugins.h
+++ b/libpurple/plugins.h
@@ -893,7 +893,8 @@ GType purple_plugin_action_get_type(void
 /**
  * purple_plugin_action_new:
  * @label:    The description of the action to show to the user.
- * @callback: The callback to call when the user selects this action.
+ * @callback: (scope call): The callback to call when the user selects this
+ *            action.
  *
  * Allocates and returns a new PurplePluginAction. Use this to add actions in a
  * list in the "actions-cb" callback for your plugin.
diff --git a/libpurple/protocol.h b/libpurple/protocol.h
--- a/libpurple/protocol.h
+++ b/libpurple/protocol.h
@@ -921,6 +921,10 @@ GType purple_protocol_server_iface_get_t
 void purple_protocol_server_iface_register_user(PurpleProtocol *,
 		PurpleAccount *);
 
+/**
+ * purple_protocol_server_iface_unregister_user:
+ * @cb: (scope call):
+ */
 void purple_protocol_server_iface_unregister_user(PurpleProtocol *,
 		PurpleAccount *, PurpleAccountUnregistrationCb cb, void *user_data);
 
@@ -976,11 +980,21 @@ void purple_protocol_server_iface_remove
 int purple_protocol_server_iface_send_raw(PurpleProtocol *,
 		PurpleConnection *gc, const char *buf, int len);
 
+/**
+ * purple_protocol_server_iface_set_public_alias:
+ * @success_cb: (scope call):
+ * @failure_cb: (scope call):
+ */
 void purple_protocol_server_iface_set_public_alias(PurpleProtocol *,
 		PurpleConnection *gc, const char *alias,
 		PurpleSetPublicAliasSuccessCallback success_cb,
 		PurpleSetPublicAliasFailureCallback failure_cb);
 
+/**
+ * purple_protocol_server_iface_get_public_alias:
+ * @success_cb: (scope call):
+ * @failure_cb: (scope call):
+ */
 void purple_protocol_server_iface_get_public_alias(PurpleProtocol *,
 		PurpleConnection *gc, PurpleGetPublicAliasSuccessCallback success_cb,
 		PurpleGetPublicAliasFailureCallback failure_cb);
diff --git a/libpurple/protocols.h b/libpurple/protocols.h
--- a/libpurple/protocols.h
+++ b/libpurple/protocols.h
@@ -315,7 +315,8 @@ GType purple_protocol_action_get_type(vo
 /**
  * purple_protocol_action_new:
  * @label:    The description of the action to show to the user.
- * @callback: The callback to call when the user selects this action.
+ * @callback: (scope call): The callback to call when the user selects this
+ *            action.
  *
  * Allocates and returns a new PurpleProtocolAction. Use this to add actions in
  * a list in the get_actions function of the protocol.