[gtk+/gtk-3-22] scale: doc: set_digits doesn’t round retroactively



commit 837785012717c6487f3db23ccfdb08bb48b5282a
Author: Daniel Boles <dboles src gnome org>
Date:   Wed Jan 18 23:42:55 2017 +0000

    scale: doc: set_digits doesn’t round retroactively
    
    Whether it should is an open question, but for now, the documentation
    should clearly indicate that currently rounding is only applied upon
    changes to the value, not to the existing value when ::digits changes.
    This is already clear in the doc for the underlying Range::round-digits.
    
    https://bugzilla.gnome.org/show_bug.cgi?id=358970

 gtk/gtkscale.c |    6 +++---
 1 files changed, 3 insertions(+), 3 deletions(-)
---
diff --git a/gtk/gtkscale.c b/gtk/gtkscale.c
index eb1d110..4f85849 100644
--- a/gtk/gtkscale.c
+++ b/gtk/gtkscale.c
@@ -1113,9 +1113,9 @@ gtk_scale_new_with_range (GtkOrientation orientation,
  * @digits: the number of decimal places to display,
  *     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 off to this
- * number of digits, so the retrieved value matches the value the user saw.
+ * 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.
  *
  * Note that rounding to a small number of digits can interfere with
  * the smooth autoscrolling that is built into #GtkScale. As an alternative,


[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]