[gtk+/gtk-2-24] Scale: Improve docs of format-value signal

[Daniel Boles <dboles src gnome org>]

commit 35744d1d9ba0d06874818c7acbb8aa0821f07e36
Author: Daniel Boles <dboles src gnome org>
Date:   Sun Feb 19 09:25:33 2017 +0000

    Scale: Improve docs of format-value signal

 gtk/gtkscale.c |    8 +++++---
 1 files changed, 5 insertions(+), 3 deletions(-)
---
diff --git a/gtk/gtkscale.c b/gtk/gtkscale.c
index 6c43af5..7e94b4c 100644
--- a/gtk/gtkscale.c
+++ b/gtk/gtkscale.c
@@ -234,7 +234,7 @@ gtk_scale_class_init (GtkScaleClass *class)
   class->get_layout_offsets = gtk_scale_real_get_layout_offsets;
 
   /**
-   * GtkScale::format-value:
+   * GtkScale:format-value:
    * @scale: the object which received the signal
    * @value: the value to format
    *
@@ -242,6 +242,9 @@ gtk_scale_class_init (GtkScaleClass *class)
    * Connect a signal handler which returns an allocated string representing 
    * @value. That string will then be used to display the scale's value.
    *
+   * If no user-provided handlers are installed, the value will be displayed on
+   * its own, rounded according to the value of the #GtkScale:digits property.
+   *
    * Here's an example signal handler which displays a value 1.0 as
    * with "--&gt;1.0&lt;--".
    * |[
@@ -1272,8 +1275,7 @@ gtk_scale_real_get_layout_offsets (GtkScale *scale,
  * @scale: a #GtkScale
  * @value: adjustment value
  * 
- * Emits #GtkScale::format-value signal to format the value, 
- * if no user signal handlers, falls back to a default format.
+ * Emits the #GtkScale:format-value signal.
  * 
  * Return value: formatted value
  */