[gtk/ebassi/gidocgen: 324/478] customsorter: Convert docs




commit bb2914518469e4c20b0f30e71fd0670795ed6226
Author: Matthias Clasen <mclasen redhat com>
Date:   Sun Feb 28 13:01:37 2021 -0500

    customsorter: Convert docs

 gtk/gtkcustomsorter.c | 18 ++++++++----------
 1 file changed, 8 insertions(+), 10 deletions(-)
---
diff --git a/gtk/gtkcustomsorter.c b/gtk/gtkcustomsorter.c
index 87cb7b11bc..4ee526aa2c 100644
--- a/gtk/gtkcustomsorter.c
+++ b/gtk/gtkcustomsorter.c
@@ -25,12 +25,10 @@
 #include "gtktypebuiltins.h"
 
 /**
- * SECTION:gtkcustomsorter
- * @Title: GtkCustomSorter
- * @Short_description: Sorting with a callbacks
+ * GtkCustomSorter:
  *
- * GtkCustomSorter is a #GtkSorter implementation that sorts
- * via a traditional #GCompareDataFunc callback.
+ * `GtkCustomSorter` is a `GtkSorter` implementation that sorts via a callback
+ * function.
  */
 struct _GtkCustomSorter
 {
@@ -101,16 +99,16 @@ gtk_custom_sorter_init (GtkCustomSorter *self)
 
 /**
  * gtk_custom_sorter_new:
- * @sort_func: (nullable): the #GCompareDataFunc to use for sorting
+ * @sort_func: (nullable): the `GCompareDataFunc` to use for sorting
  * @user_data: (nullable): user data to pass to @sort_func
  * @user_destroy: (nullable): destroy notify for @user_data
  *
- * Creates a new #GtkSorter that works by calling
+ * Creates a new `GtkSorter` that works by calling
  * @sort_func to compare items.
  *
  * If @sort_func is %NULL, all items are considered equal.
  *
- * Returns: a new #GtkCustomSorter
+ * Returns: a new `GtkCustomSorter`
  */
 GtkCustomSorter *
 gtk_custom_sorter_new (GCompareDataFunc sort_func,
@@ -128,7 +126,7 @@ gtk_custom_sorter_new (GCompareDataFunc sort_func,
 
 /**
  * gtk_custom_sorter_set_sort_func:
- * @self: a #GtkCustomSorter
+ * @self: a `GtkCustomSorter`
  * @sort_func: (nullable): function to sort items
  * @user_data: (nullable): user data to pass to @match_func
  * @user_destroy: destroy notify for @user_data
@@ -142,7 +140,7 @@ gtk_custom_sorter_new (GCompareDataFunc sort_func,
  *
  * If a previous function was set, its @user_destroy will be
  * called now.
- **/
+ */
 void
 gtk_custom_sorter_set_sort_func (GtkCustomSorter  *self,
                                  GCompareDataFunc  sort_func,


[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]