role: new role ATK_ROLE_TITLE_BAR

[platform/upstream/atk.git] / atk / atkobjectfactory.c

diff --git a/atk/atkobjectfactory.c b/atk/atkobjectfactory.c
index c50dddf..0741714 100755 (executable)
--- a/atk/atkobjectfactory.c
+++ b/atk/atkobjectfactory.c
@@ -20,6 +20,19 @@
 #include "atkobjectfactory.h"
 #include "atknoopobjectfactory.h"
 
+/**
+ * SECTION:atkobjectfactory
+ * @Short_description: The base object class for a factory used to
+ *  create accessible objects for objects of a specific GType.
+ * @Title:AtkObjectFactory
+ *
+ * This class is the base object class for a factory used to create an
+ * accessible object for a specific GType. The function
+ * atk_registry_set_factory_type() is normally called to store in the
+ * registry the factory type to be used to create an accessible of a
+ * particular GType.
+ */
+
 static void atk_object_factory_class_init   (AtkObjectFactoryClass        *klass);
 
 static gpointer    parent_class = NULL;
@@ -65,8 +78,8 @@ atk_object_factory_class_init (AtkObjectFactoryClass *klass)
  * Provides an #AtkObject that implements an accessibility interface 
  * on behalf of @obj
  *
- * Returns: an #AtkObject that implements an accessibility interface
- * on behalf of @obj
+ * Returns: (transfer full): an #AtkObject that implements an accessibility
+ * interface on behalf of @obj
  **/
 AtkObject* 
 atk_object_factory_create_accessible (AtkObjectFactory *factory,
@@ -114,8 +127,8 @@ atk_object_factory_invalidate (AtkObjectFactory *factory)
  * @factory: an #AtkObjectFactory 
  *
  * Gets the GType of the accessible which is created by the factory. 
- * The value G_TYPE_INVALID is returned if no type if found.
  * Returns: the type of the accessible which is created by the @factory.
+ * The value G_TYPE_INVALID is returned if no type if found.
  **/
 GType
 atk_object_factory_get_accessible_type (AtkObjectFactory *factory)