diff --git a/docs/reference/ChangeLog b/docs/reference/ChangeLog
index 18bbf014f6..f677e6e77c 100644
--- a/docs/reference/ChangeLog
+++ b/docs/reference/ChangeLog
@@ -1,3 +1,10 @@
+2009-03-25   Paul Bolle <pebolle@tiscali.nl>
+
+	Bug 562863 - GtkVscrollbar is hardly documented
+
+	* gtk/tmpl/gtkvscrollbar.sgml:
+	* gtk/tmpl/gtkhscrollbar.sgml: Minor tweaks.
+
 2009-03-24  Matthias Clasen  <mclasen@redhat.com>
 
 	Bug 576150 – Doc bug for GtkMenuPositionFunc
diff --git a/docs/reference/gtk/tmpl/gtkhscrollbar.sgml b/docs/reference/gtk/tmpl/gtkhscrollbar.sgml
index 267675d402..574e851fa2 100644
--- a/docs/reference/gtk/tmpl/gtkhscrollbar.sgml
+++ b/docs/reference/gtk/tmpl/gtkhscrollbar.sgml
@@ -11,7 +11,8 @@ The #GtkHScrollbar widget is a widget arranged horizontally 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 #GtkAdjustment for details.
+will be created for you. See #GtkScrollbar for a description of what the
+fields in an adjustment represent for a scrollbar.
 </para>
 
 <!-- ##### SECTION See_Also ##### -->
diff --git a/docs/reference/gtk/tmpl/gtkvscrollbar.sgml b/docs/reference/gtk/tmpl/gtkvscrollbar.sgml
index 44ce1ec49d..84efad5e6b 100644
--- a/docs/reference/gtk/tmpl/gtkvscrollbar.sgml
+++ b/docs/reference/gtk/tmpl/gtkvscrollbar.sgml
@@ -6,11 +6,12 @@ A vertical scrollbar
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
-The #GtkVScrollbar widget is a widget arranged verticall creating a
+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 #GtkAdjustment for details.
+will be created for you. See #GtkScrollbar for a description of what the
+fields in an adjustment represent for a scrollbar.
 </para>
 
 <!-- ##### SECTION See_Also ##### -->