Mercurial > pidgin3 / changeset

--- a/pidgin/gtkstyle.h	Tue Dec 26 05:28:40 2017 +0000
+++ b/pidgin/gtkstyle.h	Tue Dec 26 05:56:57 2017 +0000
@@ -1,8 +1,3 @@
-/**
- * @file gtkstyle.h GTK+ Style utility functions
- * @ingroup pidgin
- */
-
 /* pidgin
  *
  * Pidgin is the legal property of its developers, whose names are too numerous
@@ -23,6 +18,14 @@
  * along with this program; if not, write to the Free Software
  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02111-1301  USA
  */
+
+/**
+ * SECTION:gtkstyle
+ * @section_id: pidgin-gtkstyle
+ * @short_description: <filename>gtkstyle.h</filename>
+ * @title: Style API
+ */
+
 #ifndef _PIDGINSTYLE_H_
 #define _PIDGINSTYLE_H_
 
@@ -30,30 +33,27 @@
 
 G_BEGIN_DECLS
 
-/*@{*/
-
 /**
- * Returns TRUE if dark mode is enabled and foreground colours should be invertred
+ * pidgin_style_is_dark:
+ * @style: The GtkStyle in use, or NULL to use a cached version.
  *
- * @param style The GtkStyle in use, or NULL to use a cached version.
+ * Returns whether or not dark mode is enabled.
  *
- * @return @c TRUE if dark mode, @c FALSE otherwise
+ * Returns: TRUE if dark mode is enabled and foreground colours should be invertred
  */
 
 gboolean pidgin_style_is_dark(GtkStyle *style);
 
 /**
- * Lighten a color if dark mode is enabled.
+ * pidgin_style_adjust_contrast:
+ * @style: The GtkStyle in use.
+ * @color: Color to be lightened. Transformed color will be written here.
  *
- * @param style The GtkStyle in use.
- *
- * @param color Color to be lightened. Transformed color will be written here.
+ * Lighten a color if dark mode is enabled.
  */
 
 void pidgin_style_adjust_contrast(GtkStyle *style, GdkColor *color);
 
-/*@}*/
-
 G_END_DECLS
 
 #endif /* _PIDGINSTYLE_H_ */