[gtk/matthiasc/for-master: 27/41] filter: Cosmetic docs changes

[Matthias Clasen <matthiasc src gnome org>]

commit 786e28fec0fe66ca164e339a2cc1890ebd605a56
Author: Matthias Clasen <mclasen redhat com>
Date:   Sat May 22 14:11:53 2021 -0400

    filter: Cosmetic docs changes

 gtk/gtkfilter.c | 27 ++++++++++++++++-----------
 1 file changed, 16 insertions(+), 11 deletions(-)
---
diff --git a/gtk/gtkfilter.c b/gtk/gtkfilter.c
index fe6e5c0756..56e058017e 100644
--- a/gtk/gtkfilter.c
+++ b/gtk/gtkfilter.c
@@ -138,16 +138,18 @@ gtk_filter_match (GtkFilter *self,
  * gtk_filter_get_strictness:
  * @self: a `GtkFilter`
  *
- * Gets the known strictness of @filters. If the strictness is not known,
- * %GTK_FILTER_MATCH_SOME is returned.
+ * Gets the known strictness of @filters.
  *
- * This value may change after emission of the `GtkFilter::changed` signal.
+ * If the strictness is not known, %GTK_FILTER_MATCH_SOME is returned.
+ *
+ * This value may change after emission of the [signal@Gtk.Filter::changed]
+ * signal.
  *
  * This function is meant purely for optimization purposes, filters can
  * choose to omit implementing it, but `GtkFilterListModel` uses it.
  *
  * Returns: the strictness of @self
- **/
+ */
 GtkFilterMatch
 gtk_filter_get_strictness (GtkFilter *self)
 {
@@ -161,15 +163,18 @@ gtk_filter_get_strictness (GtkFilter *self)
  * @self: a `GtkFilter`
  * @change: How the filter changed
  *
- * Emits the `GtkFilter::changed` signal to notify all users of the filter that
- * the filter changed. Users of the filter should then check items again via
- * gtk_filter_match().
+ * Notifies all users of the filter that it has changed.
+ *
+ * This emits the [signal@Gtk.Filter::changed] signal. Users
+ * of the filter should then check items again via
+ * [method@Gtk.Filter.match].
  *
- * Depending on the @change parameter, not all items need to be changed, but
- * only some. Refer to the `GtkFilterChange` documentation for details.
+ * Depending on the @change parameter, not all items need to
+ * be changed, but only some. Refer to the [enum@Gtk.FilterChange]
+ * documentation for details.
  *
- * This function is intended for implementors of `GtkFilter` subclasses and
- * should not be called from other functions.
+ * This function is intended for implementors of `GtkFilter`
+ * subclasses and should not be called from other functions.
  */
 void
 gtk_filter_changed (GtkFilter       *self,