[gtk+/gtk-3-22] CellRendererPixbuf: Improve property docs



commit f1b812731dc187e84c587d89e319e1e081285401
Author: Daniel Boles <dboles src gnome org>
Date:   Wed Nov 22 18:57:48 2017 +0000

    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 files changed, 16 insertions(+), 0 deletions(-)
---
diff --git a/gtk/gtkcellrendererpixbuf.c b/gtk/gtkcellrendererpixbuf.c
index 30dcc1b..85eab79 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",


[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]