From f1b812731dc187e84c587d89e319e1e081285401 Mon Sep 17 00:00:00 2001
From: Daniel Boles <dboles@src.gnome.org>
Date: Wed, 22 Nov 2017 18:57:48 +0000
Subject: [PATCH] CellRendererPixbuf: Improve property docs

Add Since annotations for the stock-* properties.
Add a doc comment for :stock-size in order to link to GtkIconSize.
Document :stock-detail as deprecated. It does nothing & is gone in GTK+4
---
 gtk/gtkcellrendererpixbuf.c | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/gtk/gtkcellrendererpixbuf.c b/gtk/gtkcellrendererpixbuf.c
index 30dcc1b871..85eab79d69 100644
--- a/gtk/gtkcellrendererpixbuf.c
+++ b/gtk/gtkcellrendererpixbuf.c
@@ -185,6 +185,8 @@ gtk_cell_renderer_pixbuf_class_init (GtkCellRendererPixbufClass *class)
   /**
    * GtkCellRendererPixbuf:stock-id:
    *
+   * Since: 2.2
+   *
    * Deprecated: 3.10: Use #GtkCellRendererPixbuf:icon-name instead.
    */
   g_object_class_install_property (object_class,
@@ -195,6 +197,13 @@ gtk_cell_renderer_pixbuf_class_init (GtkCellRendererPixbufClass *class)
 							NULL,
 							GTK_PARAM_READWRITE | G_PARAM_DEPRECATED));
 
+  /**
+   * GtkCellRendererPixbuf:stock-size:
+   *
+   * The #GtkIconSize value that specifies the size of the rendered icon.
+   *
+   * Since: 2.2
+   */
   g_object_class_install_property (object_class,
 				   PROP_STOCK_SIZE,
 				   g_param_spec_uint ("stock-size",
@@ -205,6 +214,13 @@ gtk_cell_renderer_pixbuf_class_init (GtkCellRendererPixbufClass *class)
 						      GTK_ICON_SIZE_MENU,
 						      GTK_PARAM_READWRITE));
 
+  /*
+   * GtkCellRendererPixbuf:stock-detail:
+   *
+   * Since: 2.2
+   *
+   * Deprecated: 3.22: This property does nothing. Use CSS to theme widgets.
+   */
   g_object_class_install_property (object_class,
 				   PROP_STOCK_DETAIL,
 				   g_param_spec_string ("stock-detail",