From 49e18a29b27990d18907e044773dc6a5fc07c296 Mon Sep 17 00:00:00 2001
From: Matthias Clasen <mclasen@redhat.com>
Date: Wed, 1 Sep 2010 22:19:20 -0400
Subject: [PATCH] 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(+)

diff --git a/gtk/gtkentry.c b/gtk/gtkentry.c
index 0ca94bb01d..0cd3104d61 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 bb13eb596d..6960087aa7 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 a411a60390..dca4756e51 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"),