core: add missing comments before functions when the result must be freed after use

src/plugins/alias/alias.c

@@ -177,6 +177,8 @@ alias_string_add_arguments (char **alias, int *length, char **argv, int start,
  *   $n-m arguments from n to m
  *   $*   all arguments
  *   $~   last argument
+ *
+ * Note: result must be freed after use.
  */
 
 char *

src/plugins/aspell/weechat-aspell.c

@@ -497,7 +497,7 @@ weechat_aspell_check_word (struct t_aspell_speller_buffer *speller_buffer,
  *
  * Returns a string with format: "suggest1,suggest2,suggest3".
  *
- * Note: result (if not NULL) must be freed after use.
+ * Note: result must be freed after use (if not NULL).
  */
 
 char *

src/plugins/irc/irc-ctcp.c

@@ -319,6 +319,8 @@ irc_ctcp_reply_to_nick (struct t_irc_server *server,
 
 /*
  * Replaces variables in CTCP format.
+ *
+ * Note: result must be freed after use.
  */
 
 char *
@@ -497,6 +499,8 @@ irc_ctcp_replace_variables (struct t_irc_server *server, const char *format)
 
 /*
  * Returns filename for DCC, without double quotes.
+ *
+ * Note: result must be freed after use.
  */
 
 char *

src/plugins/irc/irc-message.c

@@ -349,6 +349,8 @@ irc_message_parse_to_hashtable (struct t_irc_server *server,
 
 /*
  * Encodes/decodes an IRC message using a charset.
+ *
+ * Note: result must be freed after use.
  */
 
 char *

src/plugins/irc/irc-nick.c

@@ -95,6 +95,8 @@ irc_nick_is_nick (const char *string)
 /*
  * Duplicates a nick and stops at first char in list (using option
  * irc.look.nick_color_stop_chars).
+ *
+ * Note: result must be freed after use.
  */
 
 char *

src/plugins/logger/logger-tail.c

@@ -58,7 +58,7 @@ logger_tail_last_eol (const char *string_start, const char *string_ptr)
 /*
  * Returns last lines of a file.
  *
- * Note: result must be freed with function "logger_tail_free".
+ * Note: result must be freed after use with function logger_tail_free().
  */
 
 struct t_logger_line *

src/plugins/logger/logger.c

@@ -65,7 +65,7 @@ struct t_hook *logger_timer = NULL;    /* timer to flush log files          */
  *   - "~": user home
  *   - date/time specifiers (see man strftime)
  *
- * Note: returned value must freed after use.
+ * Note: result must be freed after use.
  */
 
 char *
@@ -141,7 +141,7 @@ logger_create_directory ()
 /*
  * Builds full name of buffer.
  *
- * Note: value must be freed after use.
+ * Note: result must be freed after use.
  */
 
 char *
@@ -390,6 +390,8 @@ end:
 
 /*
  * Builds log filename for a buffer.
+ *
+ * Note: result must be freed after use.
  */
 
 char *

src/plugins/plugin-api.c

@@ -741,7 +741,7 @@ plugin_api_info_color_rgb2term_cb (void *data, const char *info_name,
 /*
  * Returns WeeChat infolist "bar".
  *
- * Note: result must be freed with function "weechat_infolist_free".
+ * Note: result must be freed after use with function weechat_infolist_free().
  */
 
 struct t_infolist *
@@ -797,7 +797,7 @@ plugin_api_infolist_bar_cb (void *data, const char *infolist_name,
 /*
  * Returns WeeChat infolist "bar_item".
  *
- * Note: result must be freed with function "weechat_infolist_free".
+ * Note: result must be freed after use with function weechat_infolist_free().
  */
 
 struct t_infolist *
@@ -854,7 +854,7 @@ plugin_api_infolist_bar_item_cb (void *data, const char *infolist_name,
 /*
  * Returns WeeChat infolist "bar_window".
  *
- * Note: result must be freed with function "weechat_infolist_free".
+ * Note: result must be freed after use with function weechat_infolist_free().
  */
 
 struct t_infolist *
@@ -926,7 +926,7 @@ plugin_api_infolist_bar_window_cb (void *data, const char *infolist_name,
 /*
  * Returns WeeChat infolist "buffer".
  *
- * Note: result must be freed with function "weechat_infolist_free".
+ * Note: result must be freed after use with function weechat_infolist_free().
  */
 
 struct t_infolist *
@@ -983,7 +983,7 @@ plugin_api_infolist_buffer_cb (void *data, const char *infolist_name,
 /*
  * Returns WeeChat infolist "buffer_lines".
  *
- * Note: result must be freed with function "weechat_infolist_free".
+ * Note: result must be freed after use with function weechat_infolist_free().
  */
 
 struct t_infolist *
@@ -1028,7 +1028,7 @@ plugin_api_infolist_buffer_lines_cb (void *data, const char *infolist_name,
 /*
  * Returns WeeChat infolist "filter".
  *
- * Note: result must be freed with function "weechat_infolist_free".
+ * Note: result must be freed after use with function weechat_infolist_free().
  */
 
 struct t_infolist *
@@ -1066,7 +1066,7 @@ plugin_api_infolist_filter_cb (void *data, const char *infolist_name,
 /*
  * Returns WeeChat infolist "history".
  *
- * Note: result must be freed with function "weechat_infolist_free".
+ * Note: result must be freed after use with function weechat_infolist_free().
  */
 
 struct t_infolist *
@@ -1105,7 +1105,7 @@ plugin_api_infolist_history_cb (void *data, const char *infolist_name,
 /*
  * Returns WeeChat infolist "hook".
  *
- * Note: result must be freed with function "weechat_infolist_free".
+ * Note: result must be freed after use with function weechat_infolist_free().
  */
 
 struct t_infolist *
@@ -1137,7 +1137,7 @@ plugin_api_infolist_hook_cb (void *data, const char *infolist_name,
 /*
  * Returns WeeChat infolist "hotlist".
  *
- * Note: result must be freed with function "weechat_infolist_free".
+ * Note: result must be freed after use with function weechat_infolist_free().
  */
 
 struct t_infolist *
@@ -1172,7 +1172,7 @@ plugin_api_infolist_hotlist_cb (void *data, const char *infolist_name,
 /*
  * Returns WeeChat infolist "key".
  *
- * Note: result must be freed with function "weechat_infolist_free".
+ * Note: result must be freed after use with function weechat_infolist_free().
  */
 
 struct t_infolist *
@@ -1214,7 +1214,7 @@ plugin_api_infolist_key_cb (void *data, const char *infolist_name,
 /*
  * Returns WeeChat infolist "layout".
  *
- * Note: result must be freed with function "weechat_infolist_free".
+ * Note: result must be freed after use with function weechat_infolist_free().
  */
 
 struct t_infolist *
@@ -1249,7 +1249,7 @@ plugin_api_infolist_layout_cb (void *data, const char *infolist_name,
 /*
  * Returns WeeChat infolist "nicklist".
  *
- * Note: result must be freed with function "weechat_infolist_free".
+ * Note: result must be freed after use with function weechat_infolist_free().
  */
 
 struct t_infolist *
@@ -1281,7 +1281,7 @@ plugin_api_infolist_nicklist_cb (void *data, const char *infolist_name,
 /*
  * Returns WeeChat infolist "option".
  *
- * Note: result must be freed with function "weechat_infolist_free".
+ * Note: result must be freed after use with function weechat_infolist_free().
  */
 
 struct t_infolist *
@@ -1310,7 +1310,7 @@ plugin_api_infolist_option_cb (void *data, const char *infolist_name,
 /*
  * Returns WeeChat infolist "plugin".
  *
- * Note: result must be freed with function "weechat_infolist_free".
+ * Note: result must be freed after use with function weechat_infolist_free().
  */
 
 struct t_infolist *
@@ -1367,7 +1367,7 @@ plugin_api_infolist_plugin_cb (void *data, const char *infolist_name,
 /*
  * Returns WeeChat infolist "proxy".
  *
- * Note: result must be freed with function "weechat_infolist_free".
+ * Note: result must be freed after use with function weechat_infolist_free().
  */
 
 struct t_infolist *
@@ -1424,7 +1424,7 @@ plugin_api_infolist_proxy_cb (void *data, const char *infolist_name,
 /*
  * Returns WeeChat infolist "url_options".
  *
- * Note: result must be freed with function "weechat_infolist_free".
+ * Note: result must be freed after use with function weechat_infolist_free().
  */
 
 struct t_infolist *
@@ -1458,7 +1458,7 @@ plugin_api_infolist_url_options_cb (void *data, const char *infolist_name,
 /*
  * Returns WeeChat infolist "window".
  *
- * Note: result must be freed with function "weechat_infolist_free".
+ * Note: result must be freed after use with function weechat_infolist_free().
  */
 
 struct t_infolist *

src/plugins/plugin-script.c

@@ -411,6 +411,8 @@ plugin_script_search_by_full_name (struct t_plugin_script *scripts,
 
 /*
  * Searches for path name of a script.
+ *
+ * Note: result must be freed after use.
  */
 
 char *

src/plugins/plugin.c

@@ -285,7 +285,7 @@ plugin_check_autoload (const char *filename)
  * Returns arguments for plugins (only the relevant arguments for plugins,
  * arguments for WeeChat core not returned).
  *
- * Note: plugin_argv must be freed after use (with free()).
+ * Note: plugin_argv must be freed after use.
  */
 
 void

src/plugins/trigger/trigger-callback.c

@@ -42,7 +42,7 @@ struct t_hashtable *trigger_callback_hashtable_options_regex = NULL;
  *
  * Returns a hashtable with the parsed message, or NULL if error.
  *
- * Note: the hashtable must be freed after use.
+ * Note: hashtable must be freed after use.
  */
 
 struct t_hashtable *