[at-spi2-core] introspection: add some missing Returns: (nullable) annotations
- From: Mike Gorse <mgorse src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [at-spi2-core] introspection: add some missing Returns: (nullable) annotations
- Date: Sat, 7 Jun 2014 20:08:31 +0000 (UTC)
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]