[gtk/ebassi/gidocgen: 132/200] buildable: Convert docs

[Emmanuele Bassi <ebassi src gnome org>]

commit d3dd0ad54679bd2940823a972f9facdc75cc8cc7
Author: Matthias Clasen <mclasen redhat com>
Date:   Sun Feb 21 23:38:48 2021 -0500

    buildable: Convert docs
    
    Change link syntax.

 gtk/gtkbuildable.c | 71 +++++++++++++++++++++++++++---------------------------
 gtk/gtkbuildable.h | 34 +++++++++++++-------------
 2 files changed, 52 insertions(+), 53 deletions(-)
---
diff --git a/gtk/gtkbuildable.c b/gtk/gtkbuildable.c
index 2adc747d44..74017459de 100644
--- a/gtk/gtkbuildable.c
+++ b/gtk/gtkbuildable.c
@@ -17,22 +17,21 @@
  */
 
 /**
- * SECTION:gtkbuildable
- * @Short_description: Interface for objects that can be built by GtkBuilder
- * @Title: GtkBuildable
+ * GtkBuildable:
  *
- * GtkBuildable allows objects to extend and customize their deserialization
- * from [GtkBuilder UI descriptions][BUILDER-UI].
- * The interface includes methods for setting names and properties of objects, 
+ * `GtkBuildable` allows objects to extend and customize their deserialization
+ * from ui files.
+ *
+ * The interface includes methods for setting names and properties of objects,
  * parsing custom tags and constructing child objects.
  *
- * The GtkBuildable interface is implemented by all widgets and
+ * The `GtkBuildable` interface is implemented by all widgets and
  * many of the non-widget objects that are provided by GTK. The
- * main user of this interface is #GtkBuilder. There should be
+ * main user of this interface is [class@Gtk.Builder]. There should be
  * very little need for applications to call any of these functions directly.
  *
  * An object only needs to implement this interface if it needs to extend the
- * #GtkBuilder format or run any extra routines at deserialization time.
+ * `GtkBuilder` XML format or run any extra routines at deserialization time.
  */
 
 #include "config.h"
@@ -77,15 +76,14 @@ gtk_buildable_set_buildable_id (GtkBuildable *buildable,
 
 /**
  * gtk_buildable_get_buildable_id:
- * @buildable: a #GtkBuildable
+ * @buildable: a `GtkBuildable`
  *
  * Gets the ID of the @buildable object.
- * 
- * #GtkBuilder sets the name based on the
- * [GtkBuilder UI definition][BUILDER-UI] 
- * used to construct the @buildable.
  *
- * Returns: the ID set with gtk_buildable_set_buildable_id()
+ * `GtkBuilder` sets the name based on the ID attribute
+ * of the <object> tag used to construct the @buildable.
+ *
+ * Returns: the ID set with [method@Gtk.Buildable.set_buildable_id]
  **/
 const char *
 gtk_buildable_get_buildable_id (GtkBuildable *buildable)
@@ -105,8 +103,8 @@ gtk_buildable_get_buildable_id (GtkBuildable *buildable)
 
 /*< private >
  * gtk_buildable_add_child:
- * @buildable: a #GtkBuildable
- * @builder: a #GtkBuilder
+ * @buildable: a `GtkBuildable`
+ * @builder: a `GtkBuilder`
  * @child: child to add
  * @type: (nullable): kind of child or %NULL
  *
@@ -132,13 +130,14 @@ gtk_buildable_add_child (GtkBuildable *buildable,
 
 /*< private >
  * gtk_buildable_parser_finished:
- * @buildable: a #GtkBuildable
- * @builder: a #GtkBuilder
+ * @buildable: a `GtkBuildable`
+ * @builder: a `GtkBuilder`
  *
- * Called when the builder finishes the parsing of a 
- * [GtkBuilder UI definition][BUILDER-UI]. 
- * Note that this will be called once for each time 
- * gtk_builder_add_from_file() or gtk_builder_add_from_string() 
+ * Called when the builder finishes the parsing of a
+ * GtkBuilder UI definition.
+ *
+ * Note that this will be called once for each time
+ * gtk_builder_add_from_file() or gtk_builder_add_from_string()
  * is called on a builder.
  */
 void
@@ -157,8 +156,8 @@ gtk_buildable_parser_finished (GtkBuildable *buildable,
 
 /*< private >
  * gtk_buildable_construct_child:
- * @buildable: A #GtkBuildable
- * @builder: #GtkBuilder used to construct this object
+ * @buildable: A `GtkBuildable`
+ * @builder: `GtkBuilder` used to construct this object
  * @name: name of child to construct
  *
  * Constructs a child of @buildable with the name @name.
@@ -187,16 +186,16 @@ gtk_buildable_construct_child (GtkBuildable *buildable,
 
 /*< private >
  * gtk_buildable_custom_tag_start:
- * @buildable: a #GtkBuildable
- * @builder: a #GtkBuilder used to construct this object
+ * @buildable: a `GtkBuildable`
+ * @builder: a `GtkBuilder` used to construct this object
  * @child: (allow-none): child object or %NULL for non-child tags
  * @tagname: name of tag
  * @parser: (out): a #GMarkupParser to fill in
- * @data: (out): return location for user data that will be passed in 
+ * @data: (out): return location for user data that will be passed in
  *   to parser functions
  *
  * This is called for each unknown element under <child>.
- * 
+ *
  * Returns: %TRUE if an object has a custom implementation, %FALSE
  *          if it doesn't.
  */
@@ -223,13 +222,13 @@ gtk_buildable_custom_tag_start (GtkBuildable       *buildable,
 
 /*< private >
  * gtk_buildable_custom_tag_end:
- * @buildable: A #GtkBuildable
- * @builder: #GtkBuilder used to construct this object
+ * @buildable: A `GtkBuildable`
+ * @builder: `GtkBuilder` used to construct this object
  * @child: (allow-none): child object or %NULL for non-child tags
  * @tagname: name of tag
  * @data: user data that will be passed in to parser functions
  *
- * This is called at the end of each custom element handled by 
+ * This is called at the end of each custom element handled by
  * the buildable.
  */
 void
@@ -252,8 +251,8 @@ gtk_buildable_custom_tag_end (GtkBuildable  *buildable,
 
 /*< private >
  * gtk_buildable_custom_finished:
- * @buildable: a #GtkBuildable
- * @builder: a #GtkBuilder
+ * @buildable: a `GtkBuildable`
+ * @builder: a `GtkBuilder`
  * @child: (allow-none): child object or %NULL for non-child tags
  * @tagname: the name of the tag
  * @data: user data created in custom_tag_start
@@ -280,8 +279,8 @@ gtk_buildable_custom_finished (GtkBuildable  *buildable,
 
 /*< private >
  * gtk_buildable_get_internal_child:
- * @buildable: a #GtkBuildable
- * @builder: a #GtkBuilder
+ * @buildable: a `GtkBuildable`
+ * @builder: a `GtkBuilder`
  * @childname: name of child
  *
  * Get the internal child called @childname of the @buildable object.
diff --git a/gtk/gtkbuildable.h b/gtk/gtkbuildable.h
index b446b570b9..5527337b19 100644
--- a/gtk/gtkbuildable.h
+++ b/gtk/gtkbuildable.h
@@ -46,7 +46,7 @@ typedef struct _GtkBuildableParser GtkBuildableParser;
  * @text: function called for character data
  * @error: function called on error
  *
- * A sub-parser for #GtkBuildable implementations.
+ * A sub-parser for `GtkBuildable` implementations.
  */
 struct _GtkBuildableParser
 {
@@ -86,22 +86,22 @@ struct _GtkBuildableParser
 /**
  * GtkBuildableIface:
  * @g_iface: the parent class
- * @set_id: Stores the id attribute given in the GtkBuilder UI definition.
- *  #GtkWidget stores the name as object data. Implement this method if your
- *  object has some notion of “ID” and it makes sense to map the XML id
- *  attribute to it.
+ * @set_id: Stores the id attribute given in the `GtkBuilder` UI definition.
+ *   `GtkWidget` stores the name as object data. Implement this method if your
+ *   object has some notion of “ID” and it makes sense to map the XML id
+ *   attribute to it.
  * @get_id: The getter corresponding to @set_id. Implement this
- *  if you implement @set_id.
+ *   if you implement @set_id.
  * @add_child: Adds a child. The @type parameter can be used to
- *  differentiate the kind of child. #GtkWidget implements this
- *  to add event controllers to the widget, #GtkNotebook uses
- *  the @type to distinguish between page labels (of type "page-label")
- *  and normal children.
+ *   differentiate the kind of child. `GtkWidget` implements this
+ *   to add event controllers to the widget, `GtkNotebook` uses
+ *   the @type to distinguish between page labels (of type "page-label")
+ *   and normal children.
  * @set_buildable_property: Sets a property of a buildable object.
  *  It is normally not necessary to implement this, g_object_set_property()
- *  is used by default. #GtkWindow implements this to delay showing itself
- *  (i.e. setting the #GtkWidget:visible property) until the whole interface
- *  is created.
+ *  is used by default. `GtkWindow` implements this to delay showing itself
+ *  (i.e. setting the [property@GtkWidget:visible] property) until the whole
+ *  interface is created.
  * @construct_child: Constructs a child of a buildable that has been
  *  specified as “constructor” in the UI definition. This can be used to
  *  reference a widget created in a <ui> tag which is outside
@@ -122,14 +122,14 @@ struct _GtkBuildableParser
  *  unless you need to perform special cleanup actions. #GtkWindow sets
  *  the #GtkWidget:visible property here.
  * @get_internal_child: Returns an internal child of a buildable.
- *  #GtkDialog implements this to give access to its @vbox, making
+ *  `GtkDialog` implements this to give access to its @vbox, making
  *  it possible to add children to the vbox in a UI definition.
  *  Implement this if the buildable has internal children that may
  *  need to be accessed from a UI definition.
  *
- * The #GtkBuildableIface interface contains method that are
- * necessary to allow #GtkBuilder to construct an object from
- * a #GtkBuilder UI definition.
+ * The `GtkBuildableIface` interface contains methods that are
+ * necessary to allow `GtkBuilder` to construct an object from
+ * a `GtkBuilder` UI definition.
  */
 struct _GtkBuildableIface
 {