[at-spi2-core] introspection: add some missing Returns: (nullable) annotations



commit 644a50e6b09324e03478ebe821927e2aaf73f759
Author: Evan Nemerson <evan nemerson com>
Date:   Wed May 7 16:29:01 2014 -0700

    introspection: add some missing Returns: (nullable) annotations

 atspi/atspi-accessible.c |    7 ++++---
 atspi/atspi-component.c  |    7 ++++---
 atspi/atspi-hypertext.c  |    4 ++--
 atspi/atspi-text.c       |    6 +++---
 4 files changed, 13 insertions(+), 11 deletions(-)
---
diff --git a/atspi/atspi-accessible.c b/atspi/atspi-accessible.c
index ccf1484..7dd9fcf 100644
--- a/atspi/atspi-accessible.c
+++ b/atspi/atspi-accessible.c
@@ -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 *
diff --git a/atspi/atspi-component.c b/atspi/atspi-component.c
index 31761cf..a375567 100644
--- a/atspi/atspi-component.c
+++ b/atspi/atspi-component.c
@@ -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,
diff --git a/atspi/atspi-hypertext.c b/atspi/atspi-hypertext.c
index 748d272..ca186ea 100644
--- a/atspi/atspi-hypertext.c
+++ b/atspi/atspi-hypertext.c
@@ -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)
diff --git a/atspi/atspi-text.c b/atspi/atspi-text.c
index 67510ea..98a454b 100644
--- a/atspi/atspi-text.c
+++ b/atspi/atspi-text.c
@@ -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 *


[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]