[gtk+] image: Update docs

[Matthias Clasen <matthiasc src gnome org>]

commit a28cf475afe9015f67a5700e757fc3329a94761c
Author: Matthias Clasen <mclasen redhat com>
Date:   Wed Nov 15 13:23:51 2017 -0500

    image: Update docs
    
    Mention the new icon-size style classes, update the docs
    for removed arguments and return values, and add new
    functions to the docs.

 docs/reference/gtk/gtk4-sections.txt |    1 +
 gtk/gtkimage.c                       |   14 ++++++++++++--
 2 files changed, 13 insertions(+), 2 deletions(-)
---
diff --git a/docs/reference/gtk/gtk4-sections.txt b/docs/reference/gtk/gtk4-sections.txt
index 819c765..8350ef3 100644
--- a/docs/reference/gtk/gtk4-sections.txt
+++ b/docs/reference/gtk/gtk4-sections.txt
@@ -1509,6 +1509,7 @@ gtk_image_clear
 gtk_image_new
 gtk_image_set_pixel_size
 gtk_image_get_pixel_size
+gtk_image_set_icon_size
 gtk_image_get_icon_size
 <SUBSECTION Standard>
 GTK_IMAGE
diff --git a/gtk/gtkimage.c b/gtk/gtkimage.c
index c8837a1..48968f4 100644
--- a/gtk/gtkimage.c
+++ b/gtk/gtkimage.c
@@ -68,7 +68,9 @@
  *
  * # CSS nodes
  *
- * GtkImage has a single CSS node with the name image.
+ * GtkImage has a single CSS node with the name image. The style classes
+ * .normal-icons or .large-icons may appear, depending on the #GtkImage::icon-size
+ * property.
  */
 
 
@@ -1037,6 +1039,10 @@ gtk_image_get_texture (GtkImage *image)
  * The returned string is owned by the #GtkImage and should not
  * be freed.
  *
+ * Note: This function was changed in 3.94 not to use out parameters
+ * anymore, but return the icon name directly. See gtk_image_get_icon_size()
+ * for a way to get the icon size.
+ *
  * Returns: (transfer none) (allow-none): the icon name, or %NULL
  *
  * Since: 2.6
@@ -1060,7 +1066,11 @@ gtk_image_get_icon_name (GtkImage *image)
  * %GTK_IMAGE_GICON (see gtk_image_get_storage_type()).
  * The caller of this function does not own a reference to the
  * returned #GIcon.
- * 
+ *
+ * Note: This function was changed in 3.94 not to use out parameters
+ * anymore, but return the GIcon directly. See gtk_image_get_icon_size()
+ * for a way to get the icon size.
+ *
  * Returns: (transfer none) (allow-none): a #GIcon, or %NULL
  *
  * Since: 2.14