[atk/wip/tintou/introspection-fix: 1/2] gobject-introspection: fix virtual annotations and missing type descriptions

[Corentin Noël <corentinnoel src gnome org>]

commit edfb58925d87301466bc288c9baa49c47aba3c70
Author: Corentin Noël <corentin elementary io>
Date:   Thu Mar 29 21:52:30 2018 +0100

    gobject-introspection: fix virtual annotations and missing type descriptions

 atk/atkdocument.c |   12 ++++++------
 atk/atkobject.c   |    8 ++++----
 atk/atktext.c     |    2 +-
 3 files changed, 11 insertions(+), 11 deletions(-)
---
diff --git a/atk/atkdocument.c b/atk/atkdocument.c
index 4e7245a..ff08ca8 100644
--- a/atk/atkdocument.c
+++ b/atk/atkdocument.c
@@ -162,7 +162,7 @@ atk_document_base_init (AtkDocumentIface *class)
 }
 
 /**
- * atk_document_get_document_type:
+ * atk_document_get_document_type: (virtual get_document_type)
  * @document: a #GObject instance that implements AtkDocumentIface
  *
  * Gets a string indicating the document type.
@@ -192,7 +192,7 @@ atk_document_get_document_type (AtkDocument *document)
 }
 
 /**
- * atk_document_get_document:
+ * atk_document_get_document: (virtual get_document)
  * @document: a #GObject instance that implements AtkDocumentIface
  *
  * Gets a %gpointer that points to an instance of the DOM.  It is
@@ -225,7 +225,7 @@ atk_document_get_document (AtkDocument *document)
 }
 
 /**
- * atk_document_get_locale:
+ * atk_document_get_locale: (virtual get_document_locale)
  * @document: a #GObject instance that implements AtkDocumentIface
  *
  * Gets a UTF-8 string indicating the POSIX-style LC_MESSAGES locale
@@ -261,7 +261,7 @@ atk_document_get_locale (AtkDocument *document)
 
 
 /**
- * atk_document_get_attributes:
+ * atk_document_get_attributes: (virtual get_document_attributes)
  * @document: a #GObject instance that implements AtkDocumentIface
  *
  * Gets an AtkAttributeSet which describes document-wide
@@ -293,7 +293,7 @@ atk_document_get_attributes (AtkDocument *document)
 }
 
 /**
- * atk_document_get_attribute_value:
+ * atk_document_get_attribute_value: (virtual get_document_attribute_value)
  * @document: a #GObject instance that implements AtkDocumentIface
  * @attribute_name: a character string representing the name of the attribute
  *            whose value is being queried.
@@ -325,7 +325,7 @@ atk_document_get_attribute_value (AtkDocument *document,
 }
 
 /**
- * atk_document_set_attribute_value:
+ * atk_document_set_attribute_value: (virtual set_document_attribute)
  * @document: a #GObject instance that implements AtkDocumentIface
  * @attribute_name: a character string representing the name of the attribute
  *            whose value is being set.
diff --git a/atk/atkobject.c b/atk/atkobject.c
index 9dbd443..d50be54 100644
--- a/atk/atkobject.c
+++ b/atk/atkobject.c
@@ -539,7 +539,7 @@ atk_object_class_init (AtkObjectClass *klass)
    * @arg1: The index of the added or removed child. The value can be
    * -1. This is used if the value is not known by the implementor
    * when the child is added/removed or irrelevant.
-   * @arg2: A gpointer to the child AtkObject which was added or
+   * @arg2: (type AtkObject): A gpointer to the child AtkObject which was added or
    * removed. If the child was removed, it is possible that it is not
    * available for the implementor. In that case this pointer can be
    * NULL.
@@ -581,8 +581,8 @@ atk_object_class_init (AtkObjectClass *klass)
   /**
    * AtkObject::property-change:
    * @atkobject: the object which received the signal.
-   * @arg1: an #AtkPropertyValues containing the new value of the
-   *   property which changed.
+   * @arg1: (type AtkPropertyValues): an #AtkPropertyValues containing the new
+   * value of the property which changed.
    *
    * The signal "property-change" is emitted when an object's property
    * value changes. @arg1 contains an #AtkPropertyValues with the name
@@ -648,7 +648,7 @@ atk_object_class_init (AtkObjectClass *klass)
   /**
    * AtkObject::active-descendant-changed:
    * @atkobject: the object which received the signal.
-   * @arg1: the newly focused object.
+   * @arg1: (type AtkObject): the newly focused object.
    *
    * The "active-descendant-changed" signal is emitted by an object
    * which has the state ATK_STATE_MANAGES_DESCENDANTS when the focus
diff --git a/atk/atktext.c b/atk/atktext.c
index 5244015..e29caba 100644
--- a/atk/atktext.c
+++ b/atk/atktext.c
@@ -1079,7 +1079,7 @@ atk_text_get_range_extents (AtkText          *text,
 }
 
 /**
- * atk_text_get_bounded_ranges:
+ * atk_text_get_bounded_ranges: (virtual get_bounded_ranges)
  * @text: an #AtkText
  * @rect: An AtkTextRectangle giving the dimensions of the bounding box.
  * @coord_type: Specify whether coordinates are relative to the screen or widget window.