introspection: add some missing Returns: (nullable) annotations
authorEvan Nemerson <evan@nemerson.com>
Wed, 7 May 2014 23:29:01 +0000 (16:29 -0700)
committerMike Gorse <mgorse@suse.com>
Sat, 7 Jun 2014 20:09:55 +0000 (15:09 -0500)
atspi/atspi-accessible.c
atspi/atspi-component.c
atspi/atspi-hypertext.c
atspi/atspi-text.c

index ccf1484..7dd9fcf 100644 (file)
@@ -267,9 +267,10 @@ const char *str_parent = "Parent";
  *
  * Gets an #AtspiAccessible object's parent container.
  *
- * Returns: (transfer full): a pointer to the #AtspiAccessible object which
- *          contains the given #AtspiAccessible instance, or NULL if the @obj
- *          has no parent container.
+ * Returns: (nullable) (transfer full): a pointer to the
+ *          #AtspiAccessible object which contains the given
+ *          #AtspiAccessible instance, or NULL if the @obj has no
+ *          parent container.
  *
  **/
 AtspiAccessible *
index 31761cf..a375567 100644 (file)
@@ -100,9 +100,10 @@ atspi_component_contains (AtspiComponent *obj,
  *
  * Gets the accessible child at a given coordinate within an #AtspiComponent.
  *
- * Returns: (transfer full): a pointer to an #AtspiAccessible child of the
- *          specified component which contains the point (@x, @y), or NULL if
- *         no child contains the point.
+ * Returns: (nullable) (transfer full): a pointer to an
+ *          #AtspiAccessible child of the specified component which
+ *          contains the point (@x, @y), or NULL if no child contains
+ *          the point.
  **/
 AtspiAccessible *
 atspi_component_get_accessible_at_point (AtspiComponent *obj,
index 748d272..ca186ea 100644 (file)
@@ -56,8 +56,8 @@ atspi_hypertext_get_n_links (AtspiHypertext *obj, GError **error)
  *
  * 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)
index 67510ea..98a454b 100644 (file)
@@ -287,8 +287,8 @@ atspi_text_get_attribute_run (AtspiText *obj,
  *
  * Gets the value of a named attribute at a given offset.
  *
- * Returns: the value of a given attribute at the given offset, or NULL if
- * not present.
+ * Returns: (nullable): the value of a given attribute at the given
+ * offset, or %NULL if not present.
  *
  * Deprecated: 2.10: Use atspi_text_get_text_attribute_value instead.
  * Rename to: atspi_text_get_text_attribute_value
@@ -311,7 +311,7 @@ atspi_text_get_attribute_value (AtspiText *obj,
  *
  * Gets the value of a named attribute at a given offset.
  *
- * Returns: the value of a given attribute at the given offset, or NULL if
+ * Returns: (nullable): the value of a given attribute at the given offset, or %NULL if
  * not present.
  **/
 gchar *