docs: Clean up the first paragraph for various symbols

The documentation engine will use the first paragraph as the summary for
a type or constant.

1 files changed, 8 insertions, 7 deletions

diff --git a/gtk/gtkimage.h b/gtk/gtkimage.h
index 6700b3d525..c63b37a1c1 100644
--- a/gtk/gtkimage.h
+++ b/gtk/gtkimage.h
@@ -49,13 +49,14 @@ typedef struct _GtkImage              GtkImage;
  * @GTK_IMAGE_GICON: the widget contains a #GIcon
  * @GTK_IMAGE_PAINTABLE: the widget contains a #GdkPaintable
  *
- * Describes the image data representation used by a #GtkImage. If you
- * want to get the image from the widget, you can only get the
- * currently-stored representation. e.g.  if the
- * gtk_image_get_storage_type() returns #GTK_IMAGE_PAINTABLE, then you can
- * call gtk_image_get_paintable().  For empty images, you can request any
- * storage type (call any of the "get" functions), but they will all
- * return %NULL values.
+ * Describes the image data representation used by a [class@Gtk.Image].
+ *
+ * If you want to get the image from the widget, you can only get the
+ * currently-stored representation; for instance, if the gtk_image_get_storage_type()
+ * returns %GTK_IMAGE_PAINTABLE, then you can call gtk_image_get_paintable().
+ *
+ * For empty images, you can request any storage type (call any of the "get"
+ * functions), but they will all return %NULL values.
  */
 typedef enum
 {