Mercurial > pidgin3 / file diff

--- a/libpurple/log.h	Tue Jul 23 11:52:27 2019 -0500
+++ b/libpurple/log.h	Sat Aug 03 02:33:05 2019 -0400
@@ -272,7 +272,7 @@
  *
  * Returns a list of all available logs
  *
- * Returns: (element-type PurpleLog): A sorted list of logs
+ * Returns: (element-type PurpleLog) (transfer full): A sorted list of logs.
  */
 GList *purple_log_get_logs(PurpleLogType type, const char *name, PurpleAccount *account);
 
@@ -292,8 +292,8 @@
  * destroyed. If a PurpleLogSet is removed from the GHashTable, it
  * must be freed with purple_log_set_free().
  *
- * Returns: (element-type PurpleLogSet PurpleLogSet): All available unique log
- *          sets.
+ * Returns: (element-type PurpleLogSet PurpleLogSet) (transfer full): All
+ *          available unique log sets.
  */
 GHashTable *purple_log_get_log_sets(void);
 
@@ -303,7 +303,7 @@
  *
  * Returns a list of all available system logs
  *
- * Returns: (element-type PurpleLog): A sorted list of logs
+ * Returns: (element-type PurpleLog) (transfer full): A sorted list of logs.
  */
 GList *purple_log_get_system_logs(PurpleAccount *account);
 
@@ -449,7 +449,8 @@
  * It should only be passed to purple_log_logger_new() and never
  * called directly.
  *
- * Returns: (element-type PurpleLog): A sorted list of logs matching the parameters.
+ * Returns: (element-type PurpleLog) (transfer full): A sorted list of logs
+ *          matching the parameters.
  */
 GList *purple_log_common_lister(PurpleLogType type, const char *name,
 							  PurpleAccount *account, const char *ext,
@@ -554,7 +555,7 @@
  *
  * Creates a new logger
  *
- * Returns: The new logger
+ * Returns: (transfer full): The new logger.
  */
 PurpleLogLogger *purple_log_logger_new(const char *id, const char *name, int functions, ...);
 
@@ -595,9 +596,9 @@
  *
  * Returns the current logger
  *
- * Returns: logger      The current logger
+ * Returns: (transfer none): The current logger.
  */
-PurpleLogLogger *purple_log_logger_get (void);
+PurpleLogLogger *purple_log_logger_get(void);
 
 /**
  * purple_log_logger_get_options: