diff --git a/ChangeLog b/ChangeLog
index 8d972b7659..5cb77bc73b 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,5 +1,9 @@
 2005-07-07  Matthias Clasen  <mclasen@redhat.com>
 
+	* gtk/gtkhscale.c (gtk_hscale_new_with_range): 
+	(gtk_vscale_new_with_range): Add some additional docs on 
+	precision here too.  (#309238, Steve Chaplin)
+
 	* gdk/x11/gdkmain-x11.c (generate_grab_broken_event): Don't
 	generate events on destroyed windows.
 
diff --git a/ChangeLog.pre-2-10 b/ChangeLog.pre-2-10
index 8d972b7659..5cb77bc73b 100644
--- a/ChangeLog.pre-2-10
+++ b/ChangeLog.pre-2-10
@@ -1,5 +1,9 @@
 2005-07-07  Matthias Clasen  <mclasen@redhat.com>
 
+	* gtk/gtkhscale.c (gtk_hscale_new_with_range): 
+	(gtk_vscale_new_with_range): Add some additional docs on 
+	precision here too.  (#309238, Steve Chaplin)
+
 	* gdk/x11/gdkmain-x11.c (generate_grab_broken_event): Don't
 	generate events on destroyed windows.
 
diff --git a/ChangeLog.pre-2-8 b/ChangeLog.pre-2-8
index 8d972b7659..5cb77bc73b 100644
--- a/ChangeLog.pre-2-8
+++ b/ChangeLog.pre-2-8
@@ -1,5 +1,9 @@
 2005-07-07  Matthias Clasen  <mclasen@redhat.com>
 
+	* gtk/gtkhscale.c (gtk_hscale_new_with_range): 
+	(gtk_vscale_new_with_range): Add some additional docs on 
+	precision here too.  (#309238, Steve Chaplin)
+
 	* gdk/x11/gdkmain-x11.c (generate_grab_broken_event): Don't
 	generate events on destroyed windows.
 
diff --git a/gtk/gtkhscale.c b/gtk/gtkhscale.c
index 87c7427898..43b84738ee 100644
--- a/gtk/gtkhscale.c
+++ b/gtk/gtkhscale.c
@@ -118,6 +118,10 @@ gtk_hscale_new (GtkAdjustment *adjustment)
  * increment @step.  @step must be nonzero; it's the distance the
  * slider moves when using the arrow keys to adjust the scale value.
  * 
+ * Note that the way in which the precision is derived works best if @step 
+ * is a power of ten. If the resulting precision is not suitable for your 
+ * needs, use gtk_scale_set_digits() to correct it.
+ * 
  * Return value: a new #GtkHScale
  **/
 GtkWidget*
diff --git a/gtk/gtkvscale.c b/gtk/gtkvscale.c
index dfb043fa6b..ed2e8e9081 100644
--- a/gtk/gtkvscale.c
+++ b/gtk/gtkvscale.c
@@ -120,6 +120,10 @@ gtk_vscale_new (GtkAdjustment *adjustment)
  * increment @step.  @step must be nonzero; it's the distance the
  * slider moves when using the arrow keys to adjust the scale value.
  * 
+ * Note that the way in which the precision is derived works best if @step 
+ * is a power of ten. If the resulting precision is not suitable for your 
+ * needs, use gtk_scale_set_digits() to correct it. 
+ * 
  * Return value: a new #GtkVScale
  **/
 GtkWidget*