*
* Copyright 2001, 2002 Sun Microsystems Inc.,
* Copyright 2001, 2002 Ximian, Inc.
+ * Copyright 2010, 2011 Novell, Inc.
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Library General Public
* 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
/**
* 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)
/**
* 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