From 05b13dca558c3cf127ff7efea6a1381c789885db Mon Sep 17 00:00:00 2001
From: Matthias Clasen <mclasen@redhat.com>
Date: Sun, 28 Feb 2021 13:13:35 -0500
Subject: [PATCH] textchild: Convert docs

---
 gtk/gtktextchild.c | 36 ++++++++++++++++++++----------------
 gtk/gtktextchild.h |  7 ++++---
 2 files changed, 24 insertions(+), 19 deletions(-)

diff --git a/gtk/gtktextchild.c b/gtk/gtktextchild.c
index 915b9917dd..f1716efb75 100644
--- a/gtk/gtktextchild.c
+++ b/gtk/gtktextchild.c
@@ -398,12 +398,14 @@ gtk_text_child_anchor_class_init (GtkTextChildAnchorClass *klass)
 /**
  * gtk_text_child_anchor_new:
  * 
- * Creates a new #GtkTextChildAnchor. Usually you would then insert
- * it into a #GtkTextBuffer with gtk_text_buffer_insert_child_anchor().
- * To perform the creation and insertion in one step, use the
- * convenience function gtk_text_buffer_create_child_anchor().
+ * Creates a new `GtkTextChildAnchor`.
+ *
+ * Usually you would then insert it into a `GtkTextBuffer` with
+ * [method@Gtk.TextBuffer.insert_child_anchor]. To perform the
+ * creation and insertion in one step, use the convenience
+ * function [method@Gtk.TextBuffer.create_child_anchor].
  * 
- * Returns: a new #GtkTextChildAnchor
+ * Returns: a new `GtkTextChildAnchor`
  **/
 GtkTextChildAnchor*
 gtk_text_child_anchor_new (void)
@@ -443,7 +445,7 @@ gtk_text_child_anchor_finalize (GObject *obj)
 
 /**
  * gtk_text_child_anchor_get_widgets:
- * @anchor: a #GtkTextChildAnchor
+ * @anchor: a `GtkTextChildAnchor`
  * @out_len: (out): return location for the length of the array
  * 
  * Gets a list of all widgets anchored at this child anchor.
@@ -452,7 +454,7 @@ gtk_text_child_anchor_finalize (GObject *obj)
  *
  * Returns: (array length=out_len) (transfer container): an
  *   array of widgets anchored at @anchor
- **/
+ */
 GtkWidget **
 gtk_text_child_anchor_get_widgets (GtkTextChildAnchor *anchor,
                                    guint              *out_len)
@@ -491,17 +493,19 @@ gtk_text_child_anchor_get_widgets (GtkTextChildAnchor *anchor,
 
 /**
  * gtk_text_child_anchor_get_deleted:
- * @anchor: a #GtkTextChildAnchor
- * 
+ * @anchor: a `GtkTextChildAnchor`
+ *
  * Determines whether a child anchor has been deleted from
- * the buffer. Keep in mind that the child anchor will be
- * unreferenced when removed from the buffer, so you need to
- * hold your own reference (with g_object_ref()) if you plan
- * to use this function — otherwise all deleted child anchors
- * will also be finalized.
- * 
+ * the buffer.
+ *
+ * Keep in mind that the child anchor will be unreferenced
+ * when removed from the buffer, so you need to hold your own
+ * reference (with g_object_ref()) if you plan to use this
+ * function — otherwise all deleted child anchors will also
+ * be finalized.
+ *
  * Returns: %TRUE if the child anchor has been deleted from its buffer
- **/
+ */
 gboolean
 gtk_text_child_anchor_get_deleted (GtkTextChildAnchor *anchor)
 {
diff --git a/gtk/gtktextchild.h b/gtk/gtktextchild.h
index 990f30731b..65432262a1 100644
--- a/gtk/gtktextchild.h
+++ b/gtk/gtktextchild.h
@@ -39,9 +39,10 @@ G_BEGIN_DECLS
 /**
  * GtkTextChildAnchor:
  *
- * A #GtkTextChildAnchor is a spot in the buffer where child widgets can
- * be “anchored” (inserted inline, as if they were characters). The anchor
- * can have multiple widgets anchored, to allow for multiple views.
+ * A `GtkTextChildAnchor` is a spot in a `GtkTextBuffer` where child widgets can
+ * be “anchored”.
+ *
+ * The anchor can have multiple widgets anchored, to allow for multiple views.
  */
 typedef struct _GtkTextChildAnchor      GtkTextChildAnchor;
 typedef struct _GtkTextChildAnchorClass GtkTextChildAnchorClass;