From 700196f71e199f7fa4b5813e4fbe7616a9963efd Mon Sep 17 00:00:00 2001
From: Matthias Clasen <mclasen@redhat.com>
Date: Thu, 3 Jun 2010 01:18:42 -0400
Subject: [PATCH] Update documentation for orientables

Don't document these as abstract anymore, since they are now
instantiatable.
---
 docs/reference/gtk/tmpl/gtkscale.sgml     | 5 -----
 docs/reference/gtk/tmpl/gtkscrollbar.sgml | 5 +++--
 gtk/gtkbox.c                              | 6 +++---
 gtk/gtkrange.c                            | 2 +-
 4 files changed, 7 insertions(+), 11 deletions(-)

diff --git a/docs/reference/gtk/tmpl/gtkscale.sgml b/docs/reference/gtk/tmpl/gtkscale.sgml
index 56ba0734af..e4e6d512da 100644
--- a/docs/reference/gtk/tmpl/gtkscale.sgml
+++ b/docs/reference/gtk/tmpl/gtkscale.sgml
@@ -13,11 +13,6 @@ To set the value of a scale, you would normally use gtk_range_set_value().
 To detect changes to the value, you would normally use the "value_changed"
 signal.
 </para>
-<para>
-The #GtkScale widget is an abstract class, used only for deriving the
-subclasses #GtkHScale and #GtkVScale. To create a scale widget,
-call gtk_hscale_new_with_range() or gtk_vscale_new_with_range().
-</para>
 
 <refsect2 id="GtkScale-BUILDER-UI"><title>GtkScale as GtkBuildable</title>
 <para>
diff --git a/docs/reference/gtk/tmpl/gtkscrollbar.sgml b/docs/reference/gtk/tmpl/gtkscrollbar.sgml
index 59d8ef631b..9df668348f 100644
--- a/docs/reference/gtk/tmpl/gtkscrollbar.sgml
+++ b/docs/reference/gtk/tmpl/gtkscrollbar.sgml
@@ -6,8 +6,9 @@ Base class for GtkHScrollbar and GtkVScrollbar
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
-The #GtkScrollbar widget is an abstract base class for #GtkHScrollbar and
-#GtkVScrollbar. It is not very useful in itself.
+The #GtkScrollbar widget is the base class for #GtkHScrollbar and
+#GtkVScrollbar. It can be used in the same way as these, by setting
+the "orientation" property appropriately.
 </para>
 
 <para>
diff --git a/gtk/gtkbox.c b/gtk/gtkbox.c
index 1b9c1fe845..3c56196094 100644
--- a/gtk/gtkbox.c
+++ b/gtk/gtkbox.c
@@ -30,7 +30,7 @@
  * @Title: GtkBox
  * @See_also:i #GtkHBox, #GtkVBox, #GtkFrame, #GtkTable, #GtkLayout
  *
- * GtkBox is an abstract widget which encapsulates functionality for a
+ * GtkBox is an widget which encapsulates functionality for a
  * particular kind of container, one that organizes a variable number of
  * widgets into a rectangular area.  GtkBox has a number of derived
  * classes, e.g. #GtkHBox and #GtkVBox.
@@ -41,8 +41,8 @@
  * GtkBox are allocated one dimension in common, which is the height of a
  * row, or the width of a column.
  *
- * GtkBox uses a notion of <emphasis>packing</emphasis>.  Packing refers to
- * adding widgets with reference to a particular position in a
+ * GtkBox uses a notion of <emphasis>packing</emphasis>.  Packing
+ * refers to adding widgets with reference to a particular position in a
  * #GtkContainer.  For a GtkBox, there are two reference positions: the
  * <emphasis>start</emphasis> and the <emphasis>end</emphasis> of the box.
  * For a #GtkVBox, the start is defined as the top of the box and the end is
diff --git a/gtk/gtkrange.c b/gtk/gtkrange.c
index fa92d25651..b415ec75ce 100644
--- a/gtk/gtkrange.c
+++ b/gtk/gtkrange.c
@@ -48,7 +48,7 @@
  * @Title: GtkRange
  *
  * #GtkRange is the common base class for widgets which visualize an
- * adjustment, e.g #GtkScale or #GtkScroolbar.
+ * adjustment, e.g #GtkScale or #GtkScrollbar.
  *
  * Apart from signals for monitoring the parameters of the adjustment,
  * #GtkRange provides properties and methods for influencing the sensitivity