[gtk/ebassi/gidocgen] iconview: Add a summary

[Matthias Clasen <matthiasc src gnome org>]

commit 123bad8a79a602133ff717aee310562af06739fb
Author: Matthias Clasen <mclasen redhat com>
Date:   Mon Mar 1 22:47:38 2021 -0500

    iconview: Add a summary

 gtk/gtkiconview.c | 20 ++++++++++----------
 gtk/gtkiconview.h |  4 +++-
 2 files changed, 13 insertions(+), 11 deletions(-)
---
diff --git a/gtk/gtkiconview.c b/gtk/gtkiconview.c
index cce12cc45d..1d7cb97fcf 100644
--- a/gtk/gtkiconview.c
+++ b/gtk/gtkiconview.c
@@ -49,15 +49,15 @@
 #include <string.h>
 
 /**
- * SECTION:gtkiconview
- * @title: GtkIconView
- * @short_description: A widget which displays a list of icons in a grid
+ * GtkIconView:
  *
- * #GtkIconView provides an alternative view on a #GtkTreeModel.
+ * `GtkIconView` is a widget which displays data in a grid of icons.
+ *
+ * `GtkIconView` provides an alternative view on a `GtkTreeModel`.
  * It displays the model as a grid of icons with labels. Like
- * #GtkTreeView, it allows to select one or multiple items
- * (depending on the selection mode, see gtk_icon_view_set_selection_mode()).
- * In addition to selection with the arrow keys, #GtkIconView supports
+ * [class@Gtk.TreeView], it allows to select one or multiple items
+ * (depending on the selection mode, see [method@Gtk.IconView.set_selection_mode]).
+ * In addition to selection with the arrow keys, `GtkIconView` supports
  * rubberband selection, which is controlled by dragging the pointer.
  *
  * Note that if the tree model is backed by an actual tree store (as
@@ -67,12 +67,12 @@
  *
  * # CSS nodes
  *
- * |[<!-- language="plain" -->
+ * ```
  * iconview.view
  * ╰── [rubberband]
- * ]|
+ * ```
  *
- * GtkIconView has a single CSS node with name iconview and style class .view.
+ * `GtkIconView` has a single CSS node with name iconview and style class .view.
  * For rubberband selection, a subnode with name rubberband is used.
  */
 
diff --git a/gtk/gtkiconview.h b/gtk/gtkiconview.h
index 7a204b54d9..3bdf57f0c8 100644
--- a/gtk/gtkiconview.h
+++ b/gtk/gtkiconview.h
@@ -43,7 +43,9 @@ typedef struct _GtkIconView           GtkIconView;
  * @data: (closure): user data
  *
  * A function used by gtk_icon_view_selected_foreach() to map all
- * selected rows.  It will be called on every selected row in the view.
+ * selected rows.
+ *
+ * It will be called on every selected row in the view.
  */
 typedef void (* GtkIconViewForeachFunc)     (GtkIconView      *icon_view,
                                              GtkTreePath      *path,