Reduce action related IPC

[platform/upstream/at-spi2-core.git] / atspi / atspi-hypertext.c

diff --git a/atspi/atspi-hypertext.c b/atspi/atspi-hypertext.c
index b7d4eb6..ca186ea 100644 (file)
--- a/atspi/atspi-hypertext.c
+++ b/atspi/atspi-hypertext.c
@@ -28,10 +28,10 @@
  * atspi_hypertext_get_n_links:
  * @obj: a pointer to the #AtspiHypertext implementor on which to operate.
  *
- * Get the total number of #AtspiHyperlinks which an
- *        #AtspiHypertext implementor has.
+ * Gets the total number of #AtspiHyperlink objects that an
+ * #AtspiHypertext implementor has.
  *
- * Returns: a #gint indicating the number of #AtspiHyperlinks
+ * Returns: a #gint indicating the number of #AtspiHyperlink objects
  *        of the #AtspiHypertext implementor, or -1 if
  *        the number cannot be determined (for example, if the
  *        #AtspiHypertext object is so large that it is not
@@ -52,12 +52,12 @@ atspi_hypertext_get_n_links (AtspiHypertext *obj, GError **error)
 /**
  * atspi_hypertext_get_link:
  * @obj: a pointer to the #AtspiHypertext implementor on which to operate.
- * @link_index: a (zero-index) integer indicating which hyperlink to query.
+ * @link_index: a (zero-index) #gint indicating which hyperlink to query.
  *
- * Get the #AtspiHyperlink object at a specified index.
+ * Gets the #AtspiHyperlink object at a specified index.
  *
- * Returns: (transfer full): the #AtspiHyperlink object specified by
- *          #link_index.
+ * Returns: (nullable) (transfer full): the #AtspiHyperlink object
+ *          specified by @link_index.
  **/
 AtspiHyperlink *
 atspi_hypertext_get_link (AtspiHypertext *obj, gint link_index, GError **error)
@@ -75,9 +75,9 @@ atspi_hypertext_get_link (AtspiHypertext *obj, gint link_index, GError **error)
 /**
  * atspi_hypertext_get_link_index:
  * @obj: a pointer to the #AtspiHypertext implementor on which to operate.
- * @character_offset: an integer specifying the character offset to query.
+ * @character_offset: a #gint specifying the character offset to query.
  *
- * Get the index of the #AtspiHyperlink object at a specified
+ * Gets the index of the #AtspiHyperlink object at a specified
  *        character offset.
  *
  * Returns: the linkIndex of the #AtspiHyperlink active at