diff --git a/docs/reference/ChangeLog b/docs/reference/ChangeLog
index 0a3186e252..d5dfd7d7e4 100644
--- a/docs/reference/ChangeLog
+++ b/docs/reference/ChangeLog
@@ -1,5 +1,7 @@
 2007-06-25  Matthias Clasen <mclasen@redhat.com>
 
+	* gtk/tmpl/gtkscalebutton.sgml:
+	* gtk/tmpl/gtkvolumebutton.sgml:
 	* gtk/tmpl/gtkvscrollbar.sgml:
 	* gtk/tmpl/gtkrange.sgml:
 	* gtk/tmpl/gtkrecentaction.sgml:
diff --git a/docs/reference/gtk/tmpl/gtkscalebutton.sgml b/docs/reference/gtk/tmpl/gtkscalebutton.sgml
index df23b8d320..4589ab99c2 100644
--- a/docs/reference/gtk/tmpl/gtkscalebutton.sgml
+++ b/docs/reference/gtk/tmpl/gtkscalebutton.sgml
@@ -6,9 +6,13 @@ A button which pops up a scale
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
-
+#GtkScaleButton provides a button which pops up a scale widget. 
+This kind of widget is commonly used for volume controls in multimedia
+applications, and GTK+ provides a #GtkVolumeButton subclass that
+is tailored for this use case.
 </para>
 
+
 <!-- ##### SECTION See_Also ##### -->
 <para>
 
diff --git a/docs/reference/gtk/tmpl/gtkvolumebutton.sgml b/docs/reference/gtk/tmpl/gtkvolumebutton.sgml
index a4c3fb643c..91c8c0caa9 100644
--- a/docs/reference/gtk/tmpl/gtkvolumebutton.sgml
+++ b/docs/reference/gtk/tmpl/gtkvolumebutton.sgml
@@ -6,7 +6,9 @@ A button which pops up a volume control
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
-
+#GtkVolumeButton is a subclass of #GtkScaleButton that has
+been tailored for use as a volume control widget with suitable 
+icons, tooltips and accessible labels.
 </para>
 
 <!-- ##### SECTION See_Also ##### -->