[grilo] core: Fix introspection scanner warnings

[Juan A. Suarez Romero <jasuarez src gnome org>]

commit 968a7ea8f8ae2a866738cc4b507b44eae772bffe
Author: Bastien Nocera <hadess hadess net>
Date:   Tue Feb 18 11:10:47 2014 +0100

    core: Fix introspection scanner warnings
    
    https://bugzilla.gnome.org/show_bug.cgi?id=724620

 src/grl-operation-options.c |    4 +---
 src/grl-operation.c         |    2 +-
 src/grl-plugin.c            |    2 +-
 src/grl-range-value.c       |    4 ++--
 src/grl-value-helper.c      |   17 +++++++++++++++--
 5 files changed, 20 insertions(+), 9 deletions(-)
---
diff --git a/src/grl-operation-options.c b/src/grl-operation-options.c
index b60054b..010578e 100644
--- a/src/grl-operation-options.c
+++ b/src/grl-operation-options.c
@@ -633,12 +633,10 @@ grl_operation_options_set_key_filters (GrlOperationOptions *options,
 }
 
 /**
- * grl_operation_options_set_key_filter_dictionary:
+ * grl_operation_options_set_key_filter_dictionary: (rename-to grl_operation_options_set_key_filters)
  * @options: a #GrlOperationOptions instance
  * @filters: (transfer none) (element-type GrlKeyID GValue):
  *
- * Rename to: grl_operation_options_set_key_filters
- *
  * Returns: %TRUE on success
  *
  * Since: 0.2.0
diff --git a/src/grl-operation.c b/src/grl-operation.c
index 946afdf..bbe12a9 100644
--- a/src/grl-operation.c
+++ b/src/grl-operation.c
@@ -93,7 +93,7 @@ grl_operation_set_private_data (guint                operation_id,
   data->private_data = private_data;
 }
 
-/*
+/**
  * grl_operation_get_private_data: (skip)
  * @operation_id: operation identifier
  */
diff --git a/src/grl-plugin.c b/src/grl-plugin.c
index 40fe4ff..c8634ff 100644
--- a/src/grl-plugin.c
+++ b/src/grl-plugin.c
@@ -199,7 +199,7 @@ grl_plugin_set_unload_func (GrlPlugin *plugin,
   plugin->priv->unload_func = unload_function;
 }
 
-/*
+/**
  * grl_plugin_load:
  * @plugin: a plugin
  * @configurations: (element-type GrlConfig): a list of configurations
diff --git a/src/grl-range-value.c b/src/grl-range-value.c
index 1510f96..34e8a8d 100644
--- a/src/grl-range-value.c
+++ b/src/grl-range-value.c
@@ -66,10 +66,10 @@ grl_range_value_free (GrlRangeValue *range)
   g_slice_free (GrlRangeValue, range);
 }
 
-/*
+/**
  * grl_range_value_hashtable_new:
  *
- * Returns: a #GHashTable
+ * Returns: (transfer full) (element-type gpointer GrlRangeValue): a #GHashTable
  */
 GHashTable *
 grl_range_value_hashtable_new (void)
diff --git a/src/grl-value-helper.c b/src/grl-value-helper.c
index c9ff7b4..35479b1 100644
--- a/src/grl-value-helper.c
+++ b/src/grl-value-helper.c
@@ -48,8 +48,10 @@ grl_g_value_free (GValue *value)
   g_slice_free (GValue, value);
 }
 
-/*
- * Returns: a new hash table made to contain GValues.
+/**
+ * grl_g_value_hashtable_new:
+ *
+ * Returns: (element-type utf8 GValue) (transfer full): a new hash table made to contain GValues.
  */
 GHashTable *
 grl_g_value_hashtable_new (void)
@@ -57,12 +59,23 @@ grl_g_value_hashtable_new (void)
   return g_hash_table_new_full (g_str_hash, g_str_equal, g_free, (GDestroyNotify)grl_g_value_free);
 }
 
+/**
+ * grl_g_value_hashtable_new_direct:
+ *
+ * Returns: (element-type gpointer GValue) (transfer full): a new hash table made to contain GValues.
+ */
 GHashTable *
 grl_g_value_hashtable_new_direct (void)
 {
   return g_hash_table_new_full (g_direct_hash, g_direct_equal, NULL, (GDestroyNotify)grl_g_value_free);
 }
 
+/**
+ * grl_g_value_dup:
+ * @value: the #GValue to copy
+ *
+ * Returns: (transfer full): a duplicated #GValue
+ */
 GValue *
 grl_g_value_dup (const GValue *value)
 {