[libpeas] Fix most introspection warnings

[Garrett Regier <gregier src gnome org>]

commit 3c9b297208b8d471c688b9a4b85e184fce756ac8
Author: Garrett Regier <alias301 gmail com>
Date:   Mon Sep 20 08:48:24 2010 -0700

    Fix most introspection warnings
    
    The scanner became much more picky.

 libpeas-gtk/peas-gtk-configurable.c   |    2 +-
 libpeas-gtk/peas-gtk-plugin-manager.c |    4 ++--
 libpeas/peas-engine.c                 |   19 ++++++++++---------
 libpeas/peas-extension-set.c          |    6 +++---
 libpeas/peas-extension-set.h          |    2 +-
 libpeas/peas-object-module.c          |   15 +++++++++++++++
 libpeas/peas-object-module.h          |    2 ++
 libpeas/peas-plugin-info.c            |    4 ++--
 8 files changed, 36 insertions(+), 18 deletions(-)
---
diff --git a/libpeas-gtk/peas-gtk-configurable.c b/libpeas-gtk/peas-gtk-configurable.c
index 038757a..cbad7c0 100644
--- a/libpeas-gtk/peas-gtk-configurable.c
+++ b/libpeas-gtk/peas-gtk-configurable.c
@@ -61,7 +61,7 @@ peas_gtk_configurable_default_init (PeasGtkConfigurableInterface *iface)
  *
  * This method should always return a valid #GtkWidget instance, never %NULL.
  *
- * Returns: A #GtkWidget used for configuration.
+ * Returns: (transfer full): A #GtkWidget used for configuration.
  */
 GtkWidget *
 peas_gtk_configurable_create_configure_widget (PeasGtkConfigurable *configurable)
diff --git a/libpeas-gtk/peas-gtk-plugin-manager.c b/libpeas-gtk/peas-gtk-plugin-manager.c
index 5494a04..0bf5d42 100644
--- a/libpeas-gtk/peas-gtk-plugin-manager.c
+++ b/libpeas-gtk/peas-gtk-plugin-manager.c
@@ -534,7 +534,7 @@ peas_gtk_plugin_manager_class_init (PeasGtkPluginManagerClass *klass)
   object_class->dispose = peas_gtk_plugin_manager_dispose;
 
   /**
-   * PeasGtkPLuginManager:engine:
+   * PeasGtkPluginManager:engine:
    *
    * The #PeasEngine this manager is attached to.
    */
@@ -575,7 +575,7 @@ peas_gtk_plugin_manager_new (PeasEngine *engine)
  *
  * Returns the #PeasGtkPluginManagerView of @pm.
  *
- * Returns: the view of @pm.
+ * Returns: (transfer none): the #GtkTreeView of @pm.
  */
 GtkWidget *
 peas_gtk_plugin_manager_get_view (PeasGtkPluginManager *pm)
diff --git a/libpeas/peas-engine.c b/libpeas/peas-engine.c
index 87883ed..10f685c 100644
--- a/libpeas/peas-engine.c
+++ b/libpeas/peas-engine.c
@@ -908,7 +908,7 @@ peas_engine_provides_extension (PeasEngine     *engine,
 }
 
 /**
- * peas_engine_create_extensionv
+ * peas_engine_create_extensionv:
  * @engine: A #PeasEngine.
  * @info: A loaded #PeasPluginInfo.
  * @extension_type: The implemented extension #GType.
@@ -921,8 +921,8 @@ peas_engine_provides_extension (PeasEngine     *engine,
  *
  * See peas_engine_create_extension() for more information.
  *
- * Returns: a new instance of #PeasExtension wrapping the @extension_type
- * instance, or %NULL.
+ * Returns: (transfer full): a new instance of #PeasExtension wrapping
+ * the @extension_type instance, or %NULL.
  */
 PeasExtension *
 peas_engine_create_extensionv (PeasEngine     *engine,
@@ -942,7 +942,7 @@ peas_engine_create_extensionv (PeasEngine     *engine,
 }
 
 /**
- * peas_engine_create_extension_valist
+ * peas_engine_create_extension_valist:
  * @engine: A #PeasEngine.
  * @info: A loaded #PeasPluginInfo.
  * @extension_type: The implemented extension #GType.
@@ -956,8 +956,8 @@ peas_engine_create_extensionv (PeasEngine     *engine,
  *
  * See peas_engine_create_extension() for more information.
  *
- * Returns: a new instance of #PeasExtension wrapping the @extension_type
- * instance, or %NULL.
+ * Returns: (transfer full): a new instance of #PeasExtension wrapping
+ * the @extension_type instance, or %NULL.
  */
 PeasExtension *
 peas_engine_create_extension_valist (PeasEngine     *engine,
@@ -1013,8 +1013,8 @@ peas_engine_create_extension_valist (PeasEngine     *engine,
  * principle of never giving you the actual object (also because it might as
  * well *not* be an actual object).
  *
- * Returns: a new instance of #PeasExtension wrapping the @extension_type
- * instance, or %NULL.
+ * Returns: (transfer full): a new instance of #PeasExtension wrapping
+ * the @extension_type instance, or %NULL.
  */
 PeasExtension *
 peas_engine_create_extension (PeasEngine     *engine,
@@ -1044,7 +1044,8 @@ peas_engine_create_extension (PeasEngine     *engine,
  * Please note that the returned array is a newly allocated one: you will need
  * to free it using g_strfreev().
  *
- * Returns: A newly-allocated NULL-terminated array of strings, or %NULL.
+ * Returns: (transfer full): A newly-allocated %NULL-terminated
+ * array of strings, or %NULL.
  */
 gchar **
 peas_engine_get_loaded_plugins (PeasEngine *engine)
diff --git a/libpeas/peas-extension-set.c b/libpeas/peas-extension-set.c
index 195d7fa..e306316 100644
--- a/libpeas/peas-extension-set.c
+++ b/libpeas/peas-extension-set.c
@@ -422,14 +422,14 @@ peas_extension_set_class_init (PeasExtensionSetClass *klass)
 }
 
 /**
- * *peas_extension_set_get_extension:
+ * peas_extension_set_get_extension:
  * @set: A #PeasExtensionSet
  * @info: a #PeasPluginInfo
  *
  * Returns the #PeasExtension object corresponding to @info, or %NULL
  * if the plugin doesn't provide such an extension.
  *
- * Returns: a reference to a #PeasExtension or %NULL
+ * Returns: (transfer none): a reference to a #PeasExtension or %NULL
  */
 PeasExtension *
 peas_extension_set_get_extension (PeasExtensionSet *set,
@@ -545,7 +545,7 @@ peas_extension_set_callv (PeasExtensionSet *set,
  *
  * See peas_extension_set_new() for more information.
  *
- * Returns: a new instance of #PeasExtensionSet.
+ * Returns: (transfer full): a new instance of #PeasExtensionSet.
  */
 PeasExtensionSet *
 peas_extension_set_newv (PeasEngine *engine,
diff --git a/libpeas/peas-extension-set.h b/libpeas/peas-extension-set.h
index a8d3c5d..67e7e28 100644
--- a/libpeas/peas-extension-set.h
+++ b/libpeas/peas-extension-set.h
@@ -58,7 +58,7 @@ struct _PeasExtensionSetClass {
 
   /* Virtual public methods */
   gboolean   (*call)                      (PeasExtensionSet *set,
-                                           const gchar      *method,
+                                           const gchar      *method_name,
                                            GIArgument       *args);
 
   /* Signals */
diff --git a/libpeas/peas-object-module.c b/libpeas/peas-object-module.c
index ede0e9e..661eb2d 100644
--- a/libpeas/peas-object-module.c
+++ b/libpeas/peas-object-module.c
@@ -285,6 +285,15 @@ peas_object_module_new (const gchar *module_name,
                                            NULL));
 }
 
+/**
+ * peas_object_module_create_object:
+ * @module:
+ * @interface:
+ * @n_parameters:
+ * @parameters:
+ *
+ * Return value: (transfer full):
+ */
 GObject *
 peas_object_module_create_object (PeasObjectModule *module,
                                   GType             interface,
@@ -337,6 +346,12 @@ peas_object_module_get_module_name (PeasObjectModule *module)
   return module->priv->module_name;
 }
 
+/**
+ * peas_object_module_get_library: (skip)
+ * @module:
+ *
+ * Return value:
+ */
 GModule *
 peas_object_module_get_library (PeasObjectModule *module)
 {
diff --git a/libpeas/peas-object-module.h b/libpeas/peas-object-module.h
index ca29e69..9932f7e 100644
--- a/libpeas/peas-object-module.h
+++ b/libpeas/peas-object-module.h
@@ -48,6 +48,8 @@ typedef struct _PeasObjectModulePrivate  PeasObjectModulePrivate;
  * extension of a given type. g_object_newv() is such a function.
  *
  * It is used with peas_object_module_register_object_factory().
+ *
+ * Return value: (transfer full):
  */
 typedef GObject *(*PeasFactoryFunc)   (guint          n_parameters,
                                        GParameter    *parameters,
diff --git a/libpeas/peas-plugin-info.c b/libpeas/peas-plugin-info.c
index 511f6d6..eefab3a 100644
--- a/libpeas/peas-plugin-info.c
+++ b/libpeas/peas-plugin-info.c
@@ -487,7 +487,7 @@ peas_plugin_info_get_data_dir (const PeasPluginInfo *info)
  *
  * The relevant key in the plugin info file is "Depends".
  *
- * Returns: the plugin's dependencies.
+ * Returns: (transfer none): the plugin's dependencies.
  */
 const gchar **
 peas_plugin_info_get_dependencies (const PeasPluginInfo *info)
@@ -598,7 +598,7 @@ peas_plugin_info_get_icon_name (const PeasPluginInfo *info)
  *
  * The relevant key in the plugin info file is "Authors".
  *
- * Returns: the plugin's author list.
+ * Returns: (transfer none): the plugin's author list.
  */
 const gchar **
 peas_plugin_info_get_authors (const PeasPluginInfo *info)