[gtk+/gtk-3-22] Scale: Explain how to round value when !draw-value

[Daniel Boles <dboles src gnome org>]

commit aded9632513f050fd0c6fdd19da312577b41b77a
Author: Daniel Boles <dboles src gnome org>
Date:   Tue May 2 12:18:26 2017 +0100

    Scale: Explain how to round value when !draw-value
    
    Scale:digits is (now, again) ineffective if Scale:draw-value is FALSE.
    To get rounding in that case, the base Range:round-digits must be used.

 gtk/gtkscale.c |    7 ++++---
 1 files changed, 4 insertions(+), 3 deletions(-)
---
diff --git a/gtk/gtkscale.c b/gtk/gtkscale.c
index ea58d66..065b73a 100644
--- a/gtk/gtkscale.c
+++ b/gtk/gtkscale.c
@@ -1117,9 +1117,10 @@ gtk_scale_new_with_range (GtkOrientation orientation,
  *     e.g. use 1 to display 1.0, 2 to display 1.00, etc
  *
  * Sets the number of decimal places that are displayed in the value. Also
- * causes the value of the adjustment to be rounded to this number of digits
- * whenever it is changed, so the retrieved value matches the displayed one, if
- * #GtkScale:draw-value is TRUE at the time of the change.
+ * causes the value of the adjustment to be rounded to this number of digits,
+ * so the retrieved value matches the displayed one, if #GtkScale:draw-value is
+ * %TRUE when the value changes. If you want to enforce rounding the value when
+ * #GtkScale:draw-value is %FALSE, you can set #GtkRange:round-digits instead.
  *
  * Note that rounding to a small number of digits can interfere with
  * the smooth autoscrolling that is built into #GtkScale. As an alternative,