[libgda/LIBGDA_4.2] GObject Introspection: Improved annotations, functions rename to avoid of *_v functions name in bind

[Vivien Malerba <vivien src gnome org>]

commit 7a64f5349ddd8423bbbd92f378a55151ff80a0f1
Author: Daniel Espinosa <esodan gmail com>
Date:   Mon Apr 25 19:09:06 2011 -0500

    GObject Introspection: Improved annotations, functions rename to avoid of *_v functions name in bindings

 libgda/gda-connection.c       |    2 +-
 libgda/gda-data-model-array.c |    4 +++-
 libgda/gda-meta-store.c       |   13 +++++++++----
 libgda/gda-server-operation.c |    6 ++++++
 libgda/gda-sql-builder.c      |    4 ++++
 libgda/gda-util.c             |    2 ++
 6 files changed, 25 insertions(+), 6 deletions(-)
---
diff --git a/libgda/gda-connection.c b/libgda/gda-connection.c
index 92b5ce3..695cc1c 100644
--- a/libgda/gda-connection.c
+++ b/libgda/gda-connection.c
@@ -927,7 +927,7 @@ _gda_connection_get_internal_thread_provider (void)
 /**
  * gda_connection_open_from_dsn:
  * @dsn: data source name.
- * @auth_string: authentication string, or %NULL
+ * @auth_string: (allow-none): authentication string, or %NULL
  * @options: options for the connection (see #GdaConnectionOptions).
  * @error: a place to store an error, or %NULL
  *
diff --git a/libgda/gda-data-model-array.c b/libgda/gda-data-model-array.c
index 7968579..d1e3114 100644
--- a/libgda/gda-data-model-array.c
+++ b/libgda/gda-data-model-array.c
@@ -319,7 +319,7 @@ gda_data_model_array_new_with_g_types (gint cols, ...)
 /**
  * gda_data_model_array_new_with_g_types_v:
  * @cols: number of columns for rows in this data model.
- * @types: array of types of the columns of the model to create as #GType, as many as indicated by @cols
+ * @types: (array): array of types of the columns of the model to create as #GType, as many as indicated by @cols
  *
  * Creates a new #GdaDataModel object with the column types as
  * specified.
@@ -327,6 +327,8 @@ gda_data_model_array_new_with_g_types (gint cols, ...)
  * Returns: (transfer full): a pointer to the newly created #GdaDataModel.
  *
  * Since: 4.2.6
+ *
+ * Rename to: gda_data_model_array_new_with_g_types
  */
 GdaDataModel *
 gda_data_model_array_new_with_g_types_v (gint cols, GType *types)
diff --git a/libgda/gda-meta-store.c b/libgda/gda-meta-store.c
index e90fdc3..2989548 100644
--- a/libgda/gda-meta-store.c
+++ b/libgda/gda-meta-store.c
@@ -2421,12 +2421,13 @@ gda_meta_store_extract (GdaMetaStore *store, const gchar *select_sql, GError **e
 }
 
 /**
- * gda_meta_store_extract_v: (Rename to: gda_meta_store_extract)
+ * gda_meta_store_extract_v:
  * @store: a #GdaMetaStore object
  * @select_sql: a SELECT statement
- * @vars: (allow-none): a hash table with all variables names as keys and GValue* as value, representing values for all the
- * variables mentioned in @select_sql. If there is no variable then this part can be omitted.
- * @error: (allow-none): a place to store errors, or %NULL
+ * @vars: (element-type gchar GObject.Value) (allow-none): a hash table with all variables names as keys and GValue* as 
+ * value, representing values for all the variables mentioned in @select_sql. If there is no variable then this part can be
+ * omitted.
+ * @error: a place to store errors, or %NULL
  *
  * Extracts some data stored in @store using a custom SELECT query. If the @select_sql filter involves
  * SQL identifiers (such as table or column names), then the values should have been adapted using
@@ -2439,6 +2440,8 @@ gda_meta_store_extract (GdaMetaStore *store, const gchar *select_sql, GError **e
  * Returns: (transfer full): a new #GdaDataModel, or %NULL if an error occurred
  *
  * Since: 4.2.6
+ *
+ * Rename to: gda_meta_store_extract
  */
 GdaDataModel *
 gda_meta_store_extract_v (GdaMetaStore *store, const gchar *select_sql, GHashTable *vars, GError **error)
@@ -2674,6 +2677,8 @@ gda_meta_store_modify_with_context (GdaMetaStore *store, GdaMetaContext *context
  * Returns: %TRUE if no error occurred
  *
  * Since: 4.2.6
+ *
+ * Rename to: gda_meta_store_modify
  */
 gboolean
 gda_meta_store_modify_v (GdaMetaStore *store, const gchar *table_name, 
diff --git a/libgda/gda-server-operation.c b/libgda/gda-server-operation.c
index 63a6c6b..7f9170f 100644
--- a/libgda/gda-server-operation.c
+++ b/libgda/gda-server-operation.c
@@ -1987,6 +1987,8 @@ gda_server_operation_del_item_from_sequence (GdaServerOperation *op, const gchar
  * Returns: (transfer none): a constant #GValue if a value has been defined, or %NULL if the value is undefined or if the @path is not defined or @path does not hold any value.
  *
  * Since: 4.2.6
+ *
+ * Rename to: gda_server_operation_get_value_at
  */
 const GValue *
 gda_server_operation_get_value_at_path (GdaServerOperation *op, const gchar *path)
@@ -2131,6 +2133,8 @@ gda_server_operation_get_sql_identifier_at (GdaServerOperation *op, GdaConnectio
  * (in that last case a warning is shown).
  *
  * Since: 4.2.6
+ *
+ * Rename to: gda_server_operation_get_sql_identifier_at
  */
 gchar *
 gda_server_operation_get_sql_identifier_at_path (GdaServerOperation *op, GdaConnection *cnc, GdaServerProvider *prov,
@@ -2193,6 +2197,8 @@ gda_server_operation_get_sql_identifier_at_path (GdaServerOperation *op, GdaConn
  * Returns: %TRUE if no error occurred
  *
  * Since: 4.2.6
+ *
+ * Rename to: gda_server_operation_set_value_at
  */
 gboolean
 gda_server_operation_set_value_at_path (GdaServerOperation *op, const gchar *value, 
diff --git a/libgda/gda-sql-builder.c b/libgda/gda-sql-builder.c
index aa6a827..c1f458f 100644
--- a/libgda/gda-sql-builder.c
+++ b/libgda/gda-sql-builder.c
@@ -1680,6 +1680,8 @@ gda_sql_builder_add_function (GdaSqlBuilder *builder, const gchar *func_name, ..
  * Returns: the ID of the new expression, or %0 if there was an error
  *
  * Since: 4.2
+ *
+ * Rename to: gda_sql_builder_add_function
  */
 GdaSqlBuilderId
 gda_sql_builder_add_function_v (GdaSqlBuilder *builder, const gchar *func_name,
@@ -1885,6 +1887,8 @@ gda_sql_builder_add_case (GdaSqlBuilder *builder,
  * Returns: the ID of the new expression, or %0 if there was an error
  *
  * Since: 4.2
+ *
+ * Rename to: gda_sql_builder_add_case
  */
 GdaSqlBuilderId
 gda_sql_builder_add_case_v (GdaSqlBuilder *builder,
diff --git a/libgda/gda-util.c b/libgda/gda-util.c
index 4a2118a..c89aa76 100644
--- a/libgda/gda-util.c
+++ b/libgda/gda-util.c
@@ -275,6 +275,8 @@ gda_default_unescape_string (const gchar *string)
  * Returns: %TRUE if the data model's columns match the provided data types and number
  *
  * Since: 4.2.6
+ *
+ * Rename to: gda_utility_check_data_model
  */
 gboolean
 gda_utility_check_data_model_v (GdaDataModel *model, gint nbcols, GType* types)