[gtk/ebassi/a11y/accessible-range: 7/14] Improve documentation

[Emmanuele Bassi <ebassi src gnome org>]

commit 006b473c0cff1a91396a0ce42150c4ec15af2bab
Author: Lukáš Tyrychtr <lukastyrychtr gmail com>
Date:   Thu Sep 15 18:09:53 2022 +0200

    Improve documentation

 gtk/gtkaccessiblerange.c |  4 ++++
 gtk/gtkaccessiblerange.h | 17 +++++++++++++++++
 2 files changed, 21 insertions(+)
---
diff --git a/gtk/gtkaccessiblerange.c b/gtk/gtkaccessiblerange.c
index 363e954515..7593012cf2 100644
--- a/gtk/gtkaccessiblerange.c
+++ b/gtk/gtkaccessiblerange.c
@@ -32,6 +32,10 @@
  * In addition to this interface, its implementors are expected to provide the
  * correct values for the following properties: %GTK_ACCESSIBLE_PROPERTY_VALUE_MAX,
  * %GTK_ACCESSIBLE_PROPERTY_VALUE_MIN and %GTK_ACCESSIBLE_PROPERTY_VALUE_NOW.
+ * 
+ * For controls where a minimum increment makes no sense and which do not allow
+ * setting the current value from the user, the default implementation of this
+ * interface suffices.
  */
 
 #include "config.h"
diff --git a/gtk/gtkaccessiblerange.h b/gtk/gtkaccessiblerange.h
index 45ffefc257..55da3d688c 100644
--- a/gtk/gtkaccessiblerange.h
+++ b/gtk/gtkaccessiblerange.h
@@ -37,7 +37,24 @@ struct _GtkAccessibleRangeInterface
 {
   GTypeInterface g_iface;
 
+  /**
+   * GtkAccessibleRangeInterface::get_minimum_increment:
+   * @self: a `GtkAccessibleRange`
+   * 
+   * Returns the minimum increment for this `GtkAccessibleRange`.
+   * The default implementation returns 0.0, which indicates that a minimum
+   * increment does not make sense for this implementation.
+   * @returns: the minimum increment
+   */
   double (* get_minimum_increment) (GtkAccessibleRange *self);
+  /**
+   * GtkAccessibleRangeInterface::set_current_value:
+   * @self: a `GtkAccessibleRange`
+   * @value: the value to set
+   * 
+   * Sets the current value of @self to @value.
+   * This operation should behave similarly as if the user performed the action.
+   */
   void (* set_current_value) (GtkAccessibleRange *self, double value);
 };