Include the marshallers header, not the source

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

diff --git a/atk/atkregistry.c b/atk/atkregistry.c
index 1fbf443..45fabde 100644 (file)
--- a/atk/atkregistry.c
+++ b/atk/atkregistry.c
@@ -17,9 +17,26 @@
  * Boston, MA 02111-1307, USA.
  */
 
+#include "config.h"
+
 #include "atkregistry.h"
 #include "atknoopobjectfactory.h"
 
+/**
+ * SECTION:atkregistry
+ * @Short_description: An object used to store the GType of the
+ * factories used to create an accessible object for an object of a
+ * particular GType.
+ * @Title:AtkRegistry
+ *
+ * The AtkRegistry is normally used to create appropriate ATK "peers"
+ * for user interface components.  Application developers usually need
+ * only interact with the AtkRegistry by associating appropriate ATK
+ * implementation classes with GObject classes via the
+ * atk_registry_set_factory_type call, passing the appropriate GType
+ * for application custom widget classes.
+ */
+
 static AtkRegistry *default_registry = NULL;
 
 static void              atk_registry_init           (AtkRegistry      *instance,
@@ -67,20 +84,6 @@ atk_registry_class_init (AtkRegistryClass *klass)
   object_class->finalize = atk_registry_finalize;
 }
 
-#if 0
-/*
- * Cannot define a class_finalize function when calling
- * g_type_register_static()
- */
-static void
-atk_registry_class_finalize (GObjectClass *klass)
-{
-  g_return_if_fail (ATK_IS_REGISTRY_CLASS (klass));
-
-  g_object_unref (G_OBJECT (default_registry));
-}
-#endif
-
 static void
 atk_registry_init (AtkRegistry *instance, AtkRegistryClass *klass)
 {
@@ -206,8 +209,8 @@ atk_registry_get_factory_type (AtkRegistry *registry,
  * Gets an #AtkObjectFactory appropriate for creating #AtkObjects
  * appropriate for @type.
  *
- * Returns: an #AtkObjectFactory appropriate for creating #AtkObjects
- * appropriate for @type.
+ * Returns: (transfer none): an #AtkObjectFactory appropriate for creating
+ * #AtkObjects appropriate for @type.
  **/
 AtkObjectFactory*
 atk_registry_get_factory (AtkRegistry *registry,
@@ -247,7 +250,7 @@ atk_registry_get_factory (AtkRegistry *registry,
 }
 
 /**
- *atk_get_default_registry:
+ * atk_get_default_registry:
  *
  * Gets a default implementation of the #AtkObjectFactory/type
  * registry.
@@ -257,8 +260,8 @@ atk_registry_get_factory (AtkRegistry *registry,
  * to associate an #AtkObjectFactory subclass with the GType of objects
  * for whom accessibility information will be provided.
  *
- * Returns: a default implementation of the #AtkObjectFactory/type
- * registry
+ * Returns: (transfer full): a default implementation of the
+ * #AtkObjectFactory/type registry
  **/
 AtkRegistry*
 atk_get_default_registry (void)