[gtk/ebassi/gidocgen: 99/465] treeview: Update the description format

[Emmanuele Bassi <ebassi src gnome org>]

commit 802372e7f9065b837b4cca0eee76ec3e099dc6e0
Author: Emmanuele Bassi <ebassi gnome org>
Date:   Mon Feb 22 19:08:05 2021 +0000

    treeview: Update the description format

 gtk/gtktreeview.c | 54 +++++++++++++++++++++++++++---------------------------
 1 file changed, 27 insertions(+), 27 deletions(-)
---
diff --git a/gtk/gtktreeview.c b/gtk/gtktreeview.c
index d1396e0d8a..d8ac607770 100644
--- a/gtk/gtktreeview.c
+++ b/gtk/gtktreeview.c
@@ -80,20 +80,19 @@
  *   #GtkCellRenderer, #GtkCellEditable, #GtkCellRendererPixbuf,
  *   #GtkCellRendererText, #GtkCellRendererToggle
  *
- * Widget that displays any object that implements the #GtkTreeModel interface.
+ * Widget that displays any object that implements the [iface@Gtk.TreeModel] interface.
  *
- * Please refer to the
- * [tree widget conceptual overview][TreeWidget]
- * for an overview of all the objects and data types related
- * to the tree widget and how they work together.
+ * Please refer to the [tree widget conceptual overview](section-tree-widget.html)
+ * for an overview of all the objects and data types related to the tree
+ * widget and how they work together.
  *
- * Several different coordinate systems are exposed in the GtkTreeView API.
+ * ## Coordinate systems in GtkTreeView API
+ *
+ * Several different coordinate systems are exposed in the `GtkTreeView` API.
  * These are:
  *
  * ![](tree-view-coordinates.png)
  *
- * Coordinate systems in GtkTreeView API:
- *
  * - Widget coordinates: Coordinates relative to the widget (usually `widget->window`).
  *
  * - Bin window coordinates: Coordinates relative to the window that GtkTreeView renders to.
@@ -104,18 +103,19 @@
  * Several functions are available for converting between the different
  * coordinate systems.  The most common translations are between widget and bin
  * window coordinates and between bin window and tree coordinates. For the
- * former you can use gtk_tree_view_convert_widget_to_bin_window_coords()
- * (and vice versa), for the latter gtk_tree_view_convert_bin_window_to_tree_coords()
+ * former you can use [method@Gtk.TreeView.convert_widget_to_bin_window_coords]
+ * (and vice versa), for the latter [method@Gtk.TreeView.convert_bin_window_to_tree_coords]
  * (and vice versa).
  *
- * # GtkTreeView as GtkBuildable
+ * ## `GtkTreeView` as `GtkBuildable`
+ *
+ * The `GtkTreeView` implementation of the `GtkBuildable` interface accepts
+ * [class@Gtk.TreeViewColumn] objects as `<child>` elements and exposes the
+ * internal [class@Gtk.TreeSelection] in UI definitions.
  *
- * The GtkTreeView implementation of the GtkBuildable interface accepts
- * #GtkTreeViewColumn objects as <child> elements and exposes the internal
- * #GtkTreeSelection in UI definitions.
+ * An example of a UI definition fragment with `GtkTreeView`:
  *
- * An example of a UI definition fragment with GtkTreeView:
- * |[
+ * ```xml
  * <object class="GtkTreeView" id="treeview">
  *   <property name="model">liststore1</property>
  *   <child>
@@ -135,11 +135,11 @@
  *     </object>
  *   </child>
  * </object>
- * ]|
+ * ```
  *
- * # CSS nodes
+ * ## CSS nodes
  *
- * |[<!-- language="plain" -->
+ * ```
  * treeview.view
  * ├── header
  * │   ├── button
@@ -150,20 +150,20 @@
  * │
  * ├── [rubberband]
  * ╰── [dndtarget]
- * ]|
+ * ```
  *
- * GtkTreeView has a main CSS node with name treeview and style class .view.
- * It has a subnode with name header, which is the parent for all the column
+ * `GtkTreeView` has a main CSS node with name `treeview` and style class `.view`.
+ * It has a subnode with name `header`, which is the parent for all the column
  * header widgets' CSS nodes.
  *
- * Each column header consists of a button, which among other content, has a
- * child with name sort-indicator, which carries the .ascending or .descending
+ * Each column header consists of a `button`, which among other content, has a
+ * child with name `sort-indicator`, which carries the `.ascending` or `.descending`
  * style classes when the column header should show a sort indicator. The CSS
- * is expected to provide a suitable image using the -gtk-icon-source property.
+ * is expected to provide a suitable image using the `-gtk-icon-source` property.
  *
- * For rubberband selection, a subnode with name rubberband is used.
+ * For rubberband selection, a subnode with name `rubberband` is used.
  *
- * For the drop target location during DND, a subnode with name dndtarget is used.
+ * For the drop target location during DND, a subnode with name `dndtarget` is used.
  */
 
 enum