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

4 files changed, 12 insertions, 2 deletions

diff --git a/src/gui/curses/gui-curses-chat.c b/src/gui/curses/gui-curses-chat.c
index a662d4b24..4731058fc 100644
--- a/src/gui/curses/gui-curses-chat.c
+++ b/src/gui/curses/gui-curses-chat.c
@@ -1879,6 +1879,8 @@ gui_chat_draw_free_buffer (struct t_gui_window *window, int clear_chat)
 
 /*
  * Gets line content in bare display.
+ *
+ * Note: result must be freed after use.
  */
 
 char *
diff --git a/src/gui/gui-bar-item.c b/src/gui/gui-bar-item.c
index 1b668e159..d3eea0512 100644
--- a/src/gui/gui-bar-item.c
+++ b/src/gui/gui-bar-item.c
@@ -365,6 +365,8 @@ gui_bar_item_get_vars (const char *item_name,
  * For example:  if item == "[time]"
  *               returns: color(delimiter) + "[" +
  *                        (value of item "time") + color(delimiter) + "]"
+ *
+ * Note: result must be freed after use.
  */
 
 char *
diff --git a/src/gui/gui-bar-window.c b/src/gui/gui-bar-window.c
index 546c5aedc..842de339c 100644
--- a/src/gui/gui-bar-window.c
+++ b/src/gui/gui-bar-window.c
@@ -667,8 +667,10 @@ gui_bar_window_content_get (struct t_gui_bar_window *bar_window,
 }
 
 /*
- * Gets content of a bar window, formatted for display, according to filling for
- * bar position.
+ * Gets content of a bar window, formatted for display, according to filling
+ * for bar position.
+ *
+ * Note: result must be freed after use.
  */
 
 char *
diff --git a/src/gui/gui-chat.c b/src/gui/gui-chat.c
index 48e2e236c..ff607d937 100644
--- a/src/gui/gui-chat.c
+++ b/src/gui/gui-chat.c
@@ -548,6 +548,8 @@ gui_chat_change_time_format ()
 
 /*
  * Builds a string with prefix and message.
+ *
+ * Note: result must be freed after use.
  */
 
 char *
@@ -590,6 +592,8 @@ gui_chat_build_string_prefix_message (struct t_gui_line *line)
 
 /*
  * Builds a string with message and tags.
+ *
+ * Note: result must be freed after use.
  */