[geany/geany] cb1799: msgwin: beautify doxygen comments a bit
Thomas Martitz
git-noreply at xxxxx
Thu Apr 5 19:44:43 UTC 2018
Branch: refs/heads/master
Author: Thomas Martitz <kugel at rockbox.org>
Committer: Colomban Wendling <ban at herbesfolles.org>
Date: Thu, 05 Apr 2018 19:44:43 UTC
Commit: cb179943ad8819e7c1bf9a8e359264cf87ee27f4
https://github.com/geany/geany/commit/cb179943ad8819e7c1bf9a8e359264cf87ee27f4
Log Message:
-----------
msgwin: beautify doxygen comments a bit
Modified Paths:
--------------
src/msgwindow.c
Modified: src/msgwindow.c
93 lines changed, 51 insertions(+), 42 deletions(-)
===================================================================
@@ -106,9 +106,11 @@ void msgwin_show_hide_tabs(void)
}
-/** Sets the Messages path for opening any parsed filenames without absolute path
- * from message lines.
- * @param messages_dir The directory. **/
+/**
+ * Sets the Messages path for opening any parsed filenames without absolute path from message lines.
+ *
+ * @param messages_dir The directory.
+ **/
GEANY_API_SYMBOL
void msgwin_set_messages_dir(const gchar *messages_dir)
{
@@ -315,11 +317,13 @@ static const GdkColor *get_color(gint msg_color)
/**
- * Adds a new message in the compiler tab treeview in the messages window.
+ * Adds a new message in the compiler tab treeview in the messages window.
*
- * @param msg_color A color to be used for the text. It must be an element of #MsgColors.
- * @param format @c printf()-style format string.
- * @param ... Arguments for the @c format string.
+ * @param msg_color A color to be used for the text. It must be an element of #MsgColors.
+ * @param format @c printf()-style format string.
+ * @param ... Arguments for the @c format string.
+ *
+ * @since 0.15
**/
GEANY_API_SYMBOL
void msgwin_compiler_add(gint msg_color, const gchar *format, ...)
@@ -335,12 +339,12 @@ void msgwin_compiler_add(gint msg_color, const gchar *format, ...)
}
/**
- * Adds a new message in the compiler tab treeview in the messages window.
+ * Adds a new message in the compiler tab treeview in the messages window.
*
- * @param msg_color A color to be used for the text. It must be an element of #MsgColors.
- * @param msg Compiler message to be added.
+ * @param msg_color A color to be used for the text. It must be an element of #MsgColors.
+ * @param msg Compiler message to be added.
*
- * @since @todo
+ * @since @todo
**/
GEANY_API_SYMBOL
void msgwin_compiler_add_string(gint msg_color, const gchar *msg)
@@ -391,15 +395,16 @@ void msgwin_show_hide(gboolean show)
/**
- * Adds a new message in the messages tab treeview in the messages window.
- * If @a line and @a doc are set, clicking on this line jumps into the file which is specified
- * by @a doc into the line specified with @a line.
+ * Adds a new message in the messages tab treeview in the messages window.
*
- * @param msg_color A color to be used for the text. It must be an element of #MsgColors.
- * @param line The document's line where the message belongs to. Set to @c -1 to ignore.
- * @param doc The document. Set to @c NULL to ignore.
- * @param format @c printf()-style format string.
- * @param ... Arguments for the @c format string.
+ * If @a line and @a doc are set, clicking on this line jumps into the file
+ * which is specified by @a doc into the line specified with @a line.
+ *
+ * @param msg_color A color to be used for the text. It must be an element of #MsgColors.
+ * @param line The document's line where the message belongs to. Set to @c -1 to ignore.
+ * @param doc @nullable The document. Set to @c NULL to ignore.
+ * @param format @c printf()-style format string.
+ * @param ... Arguments for the @c format string.
*
* @since 0.15
**/
@@ -419,16 +424,17 @@ void msgwin_msg_add(gint msg_color, gint line, GeanyDocument *doc, const gchar *
/**
- * Adds a new message in the messages tab treeview in the messages window.
- * If @a line and @a doc are set, clicking on this line jumps into the
- * file which is specified by @a doc into the line specified with @a line.
+ * Adds a new message in the messages tab treeview in the messages window.
+ *
+ * If @a line and @a doc are set, clicking on this line jumps into the
+ * file which is specified by @a doc into the line specified with @a line.
*
- * @param msg_color A color to be used for the text. It must be an element of #MsgColors.
- * @param line The document's line where the message belongs to. Set to @c -1 to ignore.
- * @param doc The document. Set to @c NULL to ignore.
- * @param string Message to be added.
+ * @param msg_color A color to be used for the text. It must be an element of #MsgColors.
+ * @param line The document's line where the message belongs to. Set to @c -1 to ignore.
+ * @param doc @nullable The document. Set to @c NULL to ignore.
+ * @param string Message to be added.
*
- * @since @todo
+ * @since @todo
**/
GEANY_API_SYMBOL
void msgwin_msg_add_string(gint msg_color, gint line, GeanyDocument *doc, const gchar *string)
@@ -468,12 +474,13 @@ void msgwin_msg_add_string(gint msg_color, gint line, GeanyDocument *doc, const
/**
- * Logs a status message *without* setting the status bar.
- * (Use ui_set_statusbar() to display text on the statusbar)
+ * Logs a status message *without* setting the status bar.
+ *
+ * Use @ref ui_set_statusbar() to display text on the statusbar.
*
- * @param string Status message to be logged.
+ * @param string Status message to be logged.
*
- * @since @todo
+ * @since @todo
**/
GEANY_API_SYMBOL
void msgwin_status_add_string(const gchar *string)
@@ -503,11 +510,12 @@ void msgwin_status_add_string(const gchar *string)
}
/**
- * Logs a status message *without* setting the status bar.
- * (Use ui_set_statusbar() to display text on the statusbar)
+ * Logs a status message *without* setting the status bar.
*
- * @param format @c printf()-style format string.
- * @param ... Arguments for the @c format string.
+ * Use @ref ui_set_statusbar() to display text on the statusbar.
+ *
+ * @param format @c printf()-style format string.
+ * @param ... Arguments for the @c format string.
**/
GEANY_API_SYMBOL
void msgwin_status_add(const gchar *format, ...)
@@ -1272,12 +1280,13 @@ static gboolean on_msgwin_button_press_event(GtkWidget *widget, GdkEventButton *
/**
- * Switches to the given notebook tab of the messages window and shows the messages window
- * if it was previously hidden and @a show is set to @c TRUE.
+ * Switches to the given notebook tab of the messages window.
+ *
+ * The messages window is shown if it was previously hidden and @a show is set to @c TRUE.
*
- * @param tabnum An index of a tab in the messages window. Valid values are all elements of
- * #MessageWindowTabNum.
- * @param show Whether to show the messages window at all if it was hidden before.
+ * @param tabnum An index of a tab in the messages window. Valid values are
+ * all elements of #MessageWindowTabNum.
+ * @param show Whether to show the messages window at all if it was hidden before.
*
* @since 0.15
**/
@@ -1309,9 +1318,9 @@ void msgwin_switch_tab(gint tabnum, gboolean show)
/**
- * Removes all messages from a tab specified by @a tabnum in the messages window.
+ * Removes all messages from a tab specified by @a tabnum in the messages window.
*
- * @param tabnum An index of a tab in the messages window which should be cleared.
+ * @param tabnum An index of a tab in the messages window which should be cleared.
* Valid values are @c MSG_STATUS, @c MSG_COMPILER and @c MSG_MESSAGE.
*
* @since 0.15
--------------
This E-Mail was brought to you by github_commit_mail.py (Source: https://github.com/geany/infrastructure).
More information about the Commits
mailing list