From 644a50e6b09324e03478ebe821927e2aaf73f759 Mon Sep 17 00:00:00 2001 From: Evan Nemerson Date: Wed, 7 May 2014 16:29:01 -0700 Subject: [PATCH] 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 * -- 2.7.4