Don't use *DISABLE_DEPRECATED guards

[~andy/gtk] / gtk / gtkvscrollbar.c

diff --git a/gtk/gtkvscrollbar.c b/gtk/gtkvscrollbar.c
index a5f34e169517818fa32d9c396ae9ba0ab73b9ae6..402398831b3ee96c0aa855cdb4c6db0f6aedb8e7 100644 (file)
--- a/gtk/gtkvscrollbar.c
+++ b/gtk/gtkvscrollbar.c
@@ -28,9 +28,27 @@
 #include "config.h"
 
 #include "gtkorientable.h"
+#include "gtkscrollbar.h"
+
 #include "gtkvscrollbar.h"
 #include "gtkintl.h"
-#include "gtkalias.h"
+
+
+/**
+ * SECTION:gtkvscrollbar
+ * @Short_description: A vertical scrollbar
+ * @Title: GtkVScrollbar
+ * @See_also:#GtkScrollbar, #GtkScrolledWindow
+ *
+ * The #GtkVScrollbar widget is a widget arranged vertically creating a
+ * scrollbar. See #GtkScrollbar for details on
+ * scrollbars. #GtkAdjustment pointers may be added to handle the
+ * adjustment of the scrollbar or it may be left %NULL in which case one
+ * will be created for you. See #GtkScrollbar for a description of what the
+ * fields in an adjustment represent for a scrollbar.
+ *
+ * GtkVScrollbar has been deprecated, use #GtkScrollbar instead.
+ */
 
 G_DEFINE_TYPE (GtkVScrollbar, gtk_vscrollbar, GTK_TYPE_SCROLLBAR)
 
@@ -49,11 +67,13 @@ gtk_vscrollbar_init (GtkVScrollbar *vscrollbar)
 
 /**
  * gtk_vscrollbar_new:
- * @adjustment: the #GtkAdjustment to use, or %NULL to create a new adjustment
+ * @adjustment: (allow-none): the #GtkAdjustment to use, or %NULL to create a new adjustment
  *
  * Creates a new vertical scrollbar.
  *
  * Returns: the new #GtkVScrollbar
+ *
+ * Deprecated: 3.2: Use gtk_scrollbar_new() with %GTK_ORIENTATION_VERTICAL instead
  */
 GtkWidget *
 gtk_vscrollbar_new (GtkAdjustment *adjustment)
@@ -65,6 +85,3 @@ gtk_vscrollbar_new (GtkAdjustment *adjustment)
                        "adjustment", adjustment,
                        NULL);
 }
-
-#define __GTK_VSCROLLBAR_C__
-#include "gtkaliasdef.c"