[gtk+/gtk-2-22] Deprecate 'opt-in' style properties

[Matthias Clasen <matthiasc src gnome org>]

commit 49e18a29b27990d18907e044773dc6a5fc07c296
Author: Matthias Clasen <mclasen redhat com>
Date:   Wed Sep 1 22:19:20 2010 -0400

    Deprecate 'opt-in' style properties
    
    The following style properties are there to let theme engines 'opt-in'
    to more correct behaviour while maintaining compatibility with existing
    themes. GTK+ 3 engines are expected to handle the more correct behaviour,
    and these properties will no longer be there in GTK+ 3:
    GtkEntry::state-hint
    GtkTreeView::row-ending-details
    GtkRange::trough-side-details
    GtkRange::stepper-position-details
    GtkRange::activate-slider

 gtk/gtkentry.c    |    2 ++
 gtk/gtkrange.c    |   12 ++++++++++++
 gtk/gtktreeview.c |    7 +++++++
 3 files changed, 21 insertions(+), 0 deletions(-)
---
diff --git a/gtk/gtkentry.c b/gtk/gtkentry.c
index 0ca94bb..0cd3104 100644
--- a/gtk/gtkentry.c
+++ b/gtk/gtkentry.c
@@ -1749,6 +1749,8 @@ gtk_entry_class_init (GtkEntryClass *class)
     * drawing the shadow and the widget background.
     *
     * Since: 2.16
+    *
+    * Deprecated: 2.22: This style property will be removed in GTK+ 3
     */
    gtk_widget_class_install_style_property (widget_class,
                                             g_param_spec_boolean ("state-hint",
diff --git a/gtk/gtkrange.c b/gtk/gtkrange.c
index bb13eb5..6960087 100644
--- a/gtk/gtkrange.c
+++ b/gtk/gtkrange.c
@@ -512,6 +512,14 @@ gtk_range_class_init (GtkRangeClass *class)
 							     0,
 							     GTK_PARAM_READABLE));
 
+  /**
+   * GtkRange:activate-slider:
+   *
+   * When %TRUE, sliders will be drawn active and with shadow in
+   * while they are dragged.
+   *
+   * Deprecated: 2.22: This style property will be removed in GTK+ 3
+   */
   gtk_widget_class_install_style_property (widget_class,
 					   g_param_spec_boolean ("activate-slider",
                                                                  P_("Draw slider ACTIVE during drag"),
@@ -526,6 +534,8 @@ gtk_range_class_init (GtkRangeClass *class)
    * slider are drawn with different details.
    *
    * Since: 2.10
+   *
+   * Deprecated: 2.22: This style property will be removed in GTK+ 3
    */
   gtk_widget_class_install_style_property (widget_class,
                                            g_param_spec_boolean ("trough-side-details",
@@ -572,6 +582,8 @@ gtk_range_class_init (GtkRangeClass *class)
    * suffixed with information about the stepper position.
    *
    * Since: 2.22
+   *
+   * Deprecated: 2.22: This style property will be removed in GTK+ 3
    */
   gtk_widget_class_install_style_property (widget_class,
                                            g_param_spec_boolean ("stepper-position-details",
diff --git a/gtk/gtktreeview.c b/gtk/gtktreeview.c
index a411a60..dca4756 100644
--- a/gtk/gtktreeview.c
+++ b/gtk/gtktreeview.c
@@ -830,6 +830,13 @@ gtk_tree_view_class_init (GtkTreeViewClass *class)
 							       GDK_TYPE_COLOR,
 							       GTK_PARAM_READABLE));
 
+  /**
+   * GtkTreeView:row-ending-details:
+   *
+   * Enable extended row background themeing
+   *
+   * Deprecated: 2.22: This style property will be removed in GTK+ 3
+   */
   gtk_widget_class_install_style_property (widget_class,
 					   g_param_spec_boolean ("row-ending-details",
 								 P_("Row Ending details"),