core: reformat comments for functions

1 files changed, 10 insertions, 9 deletions

diff --git a/src/gui/curses/gui-curses-bar-window.c b/src/gui/curses/gui-curses-bar-window.c
index eb53656dc..83a1375f4 100644
--- a/src/gui/curses/gui-curses-bar-window.c
+++ b/src/gui/curses/gui-curses-bar-window.c
@@ -45,7 +45,7 @@
 
 
 /*
- * gui_bar_window_objects_init: init Curses windows for bar window
+ * Initializes Curses windows for bar window.
  */
 
 int
@@ -65,7 +65,7 @@ gui_bar_window_objects_init (struct t_gui_bar_window *bar_window)
 }
 
 /*
- * gui_window_objects_free: free Curses windows for a bar window
+ * Frees Curses windows for a bar window.
  */
 
 void
@@ -84,7 +84,7 @@ gui_bar_window_objects_free (struct t_gui_bar_window *bar_window)
 }
 
 /*
- * gui_bar_window_create_win: create curses window for bar
+ * Creates curses window for bar.
  */
 
 void
@@ -143,10 +143,11 @@ gui_bar_window_create_win (struct t_gui_bar_window *bar_window)
 }
 
 /*
- * gui_bar_window_print_string: print a string text on a bar window
- *                              return 1 if all was printed, 0 if some text
- *                              was not displayed (wrapped due to bar window
- *                              width)
+ * Prints a string text on a bar window.
+ *
+ * Returns:
+ *   1: everything was printed
+ *   0: some text was not displayed (wrapped due to bar window width)
  */
 
 int
@@ -376,7 +377,7 @@ gui_bar_window_print_string (struct t_gui_bar_window *bar_window,
 }
 
 /*
- * gui_bar_window_draw: draw a bar for a window
+ * Draws a bar for a window.
  */
 
 void
@@ -786,7 +787,7 @@ gui_bar_window_draw (struct t_gui_bar_window *bar_window,
 }
 
 /*
- * gui_bar_window_objects_print_log: print bar window infos in log (usually for crash dump)
+ * Prints bar window infos in WeeChat log file (usually for crash dump).
  */
 
 void