[libgda] Added lots of annotations



commit 1cab4bf735db3ddb0a3ae866775ee1f54f62f72b
Author: Jonh Wendell <jwendell gnome org>
Date:   Thu Oct 7 17:45:17 2010 -0300

    Added lots of annotations

 libgda/gda-attributes-manager.c            |    6 ++--
 libgda/gda-batch.c                         |    4 +-
 libgda/gda-column.c                        |    2 +-
 libgda/gda-config.c                        |    4 +-
 libgda/gda-connection.c                    |   53 +++++++++++++--------------
 libgda/gda-data-access-wrapper.c           |    2 +-
 libgda/gda-data-model-array.c              |    6 ++--
 libgda/gda-data-model-dir.c                |    2 +-
 libgda/gda-data-model-import.c             |    6 ++--
 libgda/gda-data-proxy.c                    |    2 +-
 libgda/gda-data-select.c                   |    4 +-
 libgda/gda-easy.c                          |   14 ++++----
 libgda/gda-holder.c                        |    4 +-
 libgda/gda-meta-store.c                    |    6 ++--
 libgda/gda-meta-struct.c                   |    6 ++--
 libgda/gda-mutex.c                         |    2 +-
 libgda/gda-quark-list.c                    |    6 ++--
 libgda/gda-server-operation.c              |    6 ++--
 libgda/gda-server-operation.h              |    2 +-
 libgda/gda-server-provider-extra.c         |    6 +++
 libgda/gda-server-provider.c               |    8 ++--
 libgda/gda-sql-builder.c                   |   10 ++---
 libgda/gda-sql-builder.h                   |    2 +-
 libgda/gda-statement.c                     |    2 +-
 libgda/gda-transaction-status.c            |   23 +++++++++++-
 libgda/gda-tree-manager.c                  |    8 ++--
 libgda/gda-tree.c                          |    4 +-
 libgda/gda-util.c                          |    8 ++--
 libgda/gda-value.c                         |   17 ++++++++-
 libgda/gda-xa-transaction.c                |    4 +-
 libgda/handlers/gda-handler-bin.c          |    4 +-
 libgda/handlers/gda-handler-boolean.c      |    4 +-
 libgda/handlers/gda-handler-numerical.c    |    4 +-
 libgda/handlers/gda-handler-string.c       |   10 +++---
 libgda/handlers/gda-handler-time.c         |    8 ++--
 libgda/handlers/gda-handler-type.c         |    4 +-
 libgda/providers-support/gda-pstmt.c       |    2 +-
 libgda/sql-parser/gda-sql-parser.c         |    6 ++--
 libgda/sql-parser/gda-statement-struct.c   |    6 ++--
 libgda/thread-wrapper/gda-thread-wrapper.c |   10 +++---
 40 files changed, 163 insertions(+), 124 deletions(-)
---
diff --git a/libgda/gda-attributes-manager.c b/libgda/gda-attributes-manager.c
index a94b769..a591d66 100644
--- a/libgda/gda-attributes-manager.c
+++ b/libgda/gda-attributes-manager.c
@@ -91,7 +91,7 @@ objattrs_unref (ObjAttrs *attrs)
 }
 
 /**
- * gda_attributes_manager_new:
+ * gda_attributes_manager_new: (skip):
  * @for_objects: set to TRUE if attributes will be set on objects.
  * @signal_func: a function to be called whenever an attribute changes on an object (if @for_objects is TRUE), or %NULL
  * @signal_data: user data passed as last argument of @signal_func when it is called
@@ -408,8 +408,8 @@ static void foreach_foreach_func (AttName *attname, const GValue *value, FData *
  * gda_attributes_manager_foreach:
  * @mgr: a #GdaAttributesManager
  * @ptr: a pointer to the resources for which all the attributes used
- * @func: a #GdaAttributesManagerFunc function
- * @data: user data to be passed as last argument of @func each time it is called
+ * @func: (scope call): a #GdaAttributesManagerFunc function
+ * @data: (closure): user data to be passed as last argument of @func each time it is called
  *
  * Calls @func for every attribute set to @ptr.
  */
diff --git a/libgda/gda-batch.c b/libgda/gda-batch.c
index b92f320..86421ac 100644
--- a/libgda/gda-batch.c
+++ b/libgda/gda-batch.c
@@ -169,7 +169,7 @@ gda_batch_new (void)
  * 
  * Copy constructor
  *
- * Returns: a the new copy of @orig
+ * Returns: (transfer full): a the new copy of @orig
  */
 GdaBatch *
 gda_batch_copy (GdaBatch *orig)
@@ -387,7 +387,7 @@ gda_batch_get_statements (GdaBatch *batch)
 /**
  * gda_batch_get_parameters:
  * @batch: a #GdaBatch object
- * @out_params: (out) (tranfer full) (allow-none): a place to store a new #GdaSet object, or %NULL
+ * @out_params: (out) (transfer full) (allow-none): a place to store a new #GdaSet object, or %NULL
  * @error: a place to store errors, or %NULL
  *
  * Get a new #GdaSet object which groups all the execution parameters
diff --git a/libgda/gda-column.c b/libgda/gda-column.c
index fbebf62..2b9605c 100644
--- a/libgda/gda-column.c
+++ b/libgda/gda-column.c
@@ -268,7 +268,7 @@ gda_column_new (void)
  * 	 
  * Creates a new #GdaColumn object from an existing one.
  *
- * Returns: a newly allocated #GdaColumn with a copy of the data 	 
+ * Returns: (transfer full): a newly allocated #GdaColumn with a copy of the data 	 
  * in @column. 	 
  */ 	 
 GdaColumn * 	 
diff --git a/libgda/gda-config.c b/libgda/gda-config.c
index ed2524b..8db0ee0 100644
--- a/libgda/gda-config.c
+++ b/libgda/gda-config.c
@@ -1089,7 +1089,7 @@ gda_config_dsn_needs_authentication (const gchar *dsn_name)
  *  <listitem><para>Username if it exists</para></listitem>
  * </itemizedlist>
  *
- * Returns: a new #GdaDataModel
+ * Returns: (transfer full): a new #GdaDataModel
  */
 GdaDataModel *
 gda_config_list_dsn (void)
@@ -1311,7 +1311,7 @@ gda_config_get_provider (const gchar *provider_name, GError **error)
  *  <listitem><para>File name of the plugin</para></listitem>
  * </itemizedlist>
  *
- * Returns: a new #GdaDataModel
+ * Returns: (transfer full): a new #GdaDataModel
  */
 GdaDataModel *
 gda_config_list_providers (void)
diff --git a/libgda/gda-connection.c b/libgda/gda-connection.c
index 7b0ec34..7a5fbce 100644
--- a/libgda/gda-connection.c
+++ b/libgda/gda-connection.c
@@ -945,7 +945,7 @@ _gda_connection_get_internal_thread_provider (void)
  * This method may fail with a GDA_CONNECTION_ERROR domain error (see the #GdaConnectionError error codes) 
  * or a %GDA_CONFIG_ERROR domain error (see the #GdaConfigError error codes).
  *
- * Returns: a new #GdaConnection if connection opening was sucessfull or %NULL if there was an error.
+ * Returns: (transfer full) (allow-none): a new #GdaConnection if connection opening was sucessfull or %NULL if there was an error.
  */
 GdaConnection *
 gda_connection_open_from_dsn (const gchar *dsn, const gchar *auth_string, 
@@ -1099,7 +1099,7 @@ gda_connection_open_from_dsn (const gchar *dsn, const gchar *auth_string,
  * This method may fail with a GDA_CONNECTION_ERROR domain error (see the #GdaConnectionError error codes) 
  * or a %GDA_CONFIG_ERROR domain error (see the #GdaConfigError error codes).
  *
- * Returns: a new #GdaConnection if connection opening was sucessfull or %NULL if there was an error.
+ * Returns: (transfer full) (allow-none): a new #GdaConnection if connection opening was sucessfull or %NULL if there was an error.
  */
 GdaConnection *
 gda_connection_open_from_string (const gchar *provider_name, const gchar *cnc_string, const gchar *auth_string,
@@ -1264,8 +1264,7 @@ sqlite_connection_closed_cb (GdaConnection *cnc, G_GNUC_UNUSED gpointer data)
 
 /**
  * gda_connection_open_sqlite:
- * @cnc_string: a connection string
- * @directory: the directory the database file will be in, or %NULL for the default TMP directory
+ * @directory: (allow-none): the directory the database file will be in, or %NULL for the default TMP directory
  * @filename: the database file name
  * @auto_unlink: if %TRUE, then the database file will be removed afterwards
  *
@@ -1273,7 +1272,7 @@ sqlite_connection_closed_cb (GdaConnection *cnc, G_GNUC_UNUSED gpointer data)
  * to be used by database providers which need a temporary database to store
  * some information.
  *
- * Returns: a new #GdaConnection, or %NULL if an error occurred
+ * Returns: (transfer full) (allow-none): a new #GdaConnection, or %NULL if an error occurred
  */
 GdaConnection *
 gda_connection_open_sqlite (const gchar *directory, const gchar *filename, gboolean auto_unlink)
@@ -1739,7 +1738,7 @@ gda_connection_get_authentication (GdaConnection *cnc)
 }
 
 /**
- * gda_connection_point_available_event
+ * gda_connection_point_available_event:
  * @cnc: a #GdaConnection object
  * @type: a #GdaConnectionEventType
  *
@@ -1748,7 +1747,7 @@ gda_connection_get_authentication (GdaConnection *cnc)
  * for gda_connection_event_new() which improves performances by reusing as much as possible
  * #GdaConnectionEvent objects. Newly written database providers should use this method.
  *
- * Returns: (transfer full): a pointer to the next available connection event, or %NULL if event should
+ * Returns: (transfer full) (allow-none): a pointer to the next available connection event, or %NULL if event should
  * be ignored
  *
  * Since: 4.2
@@ -1945,7 +1944,7 @@ gda_connection_clear_events_list (GdaConnection *cnc)
  * to perform the type type of action. It is a wrapper around the gda_server_provider_create_operation()
  * method.
  *
- * Returns: a new #GdaServerOperation object, or %NULL in the connection's provider does not support the @type type
+ * Returns: (transfer full) (allow-none): a new #GdaServerOperation object, or %NULL in the connection's provider does not support the @type type
  * of operation or if an error occurred
  */
 GdaServerOperation*
@@ -1993,7 +1992,7 @@ gda_connection_perform_operation (GdaConnection *cnc, GdaServerOperation *op, GE
  * then %NULL is returned, and a general SQL parser can be obtained
  * using gda_sql_parser_new().
  *
- * Returns: a new #GdaSqlParser object, or %NULL
+ * Returns: (transfer full) (allow-none): a new #GdaSqlParser object, or %NULL
  */
 GdaSqlParser *
 gda_connection_create_parser (GdaConnection *cnc)
@@ -2051,7 +2050,7 @@ change_events_array_max_size (GdaConnection *cnc, gint size)
  * the list of #GObject created by the correct execution of the previous statements. If a transaction is required,
  * then it should be started before calling this method.
  *
- * Returns: (element-type GObject): a new list of #GObject objects
+ * Returns: (transfer full) (element-type GObject): a new list of #GObject objects
  */
 GSList *
 gda_connection_batch_execute (GdaConnection *cnc, GdaBatch *batch, GdaSet *params,
@@ -2446,7 +2445,7 @@ gda_connection_async_statement_execute (GdaConnection *cnc, GdaStatement *stmt,
  * would have if the statement had been
  * executed synchronously.
  *
- * Returns: a #GObject, or %NULL if an error occurred
+ * Returns: (transfer full) (allow-none): a #GObject, or %NULL if an error occurred
  *
  * Since: 4.2
  */
@@ -2685,7 +2684,7 @@ gda_connection_statement_execute_v (GdaConnection *cnc, GdaStatement *stmt, GdaS
  * Also see the <link linkend="limitations">provider's limitations</link>, and the
  * <link linkend="data-select">Advanced GdaDataSelect usage</link> sections.
  *
- * Returns: a #GObject, or %NULL if an error occurred 
+ * Returns: (transfer full) (allow-none): a #GObject, or %NULL if an error occurred 
  */
 GObject *
 gda_connection_statement_execute (GdaConnection *cnc, GdaStatement *stmt, GdaSet *params, 
@@ -2793,7 +2792,7 @@ gda_connection_statement_execute_non_select (GdaConnection *cnc, GdaStatement *s
  * See the documentation of the gda_connection_statement_execute() for information
  * about the @params list of parameters.
  *
- * Returns: a #GdaDataModel containing the data returned by the
+ * Returns: (transfer full) (allow-none): a #GdaDataModel containing the data returned by the
  * data source, or %NULL if an error occurred
  */
 GdaDataModel *
@@ -2840,7 +2839,7 @@ gda_connection_statement_execute_select (GdaConnection *cnc, GdaStatement *stmt,
  * See the documentation of the gda_connection_statement_execute() for information
  * about the @params list of parameters.
  *
- * Returns: a #GdaDataModel containing the data returned by the
+ * Returns: (transfer full) (allow-none): a #GdaDataModel containing the data returned by the
  * data source, or %NULL if an error occurred
  */
 GdaDataModel *
@@ -2918,7 +2917,7 @@ gda_connection_statement_execute_select_fullv (GdaConnection *cnc, GdaStatement
  * See the documentation of the gda_connection_statement_execute() for information
  * about the @params list of parameters.
  *
- * Returns: a #GdaDataModel containing the data returned by the
+ * Returns: (transfer full) (allow-none): a #GdaDataModel containing the data returned by the
  * data source, or %NULL if an error occurred
  */
 GdaDataModel *
@@ -4648,7 +4647,7 @@ prepare_meta_statements_hash (void)
  * meta data section about SQL identifiers</link> for more information, and the documentation about the
  * gda_sql_identifier_quote() function which will be most useful.
  * 
- * Returns: a #GdaDataModel containing the data required. The caller is responsible
+ * Returns: (transfer full): a #GdaDataModel containing the data required. The caller is responsible
  * for freeing the returned model using g_object_unref().
  */
 GdaDataModel *
@@ -4701,7 +4700,7 @@ gda_connection_get_meta_store_data (GdaConnection *cnc,
  *
  * see #gda_connection_get_meta_store_data
  * 
- * Returns: a #GdaDataModel containing the data required. The caller is responsible
+ * Returns: (transfer full): a #GdaDataModel containing the data required. The caller is responsible
  * for freeing the returned model using g_object_unref().
  */
 GdaDataModel *
@@ -4842,8 +4841,8 @@ gda_connection_value_to_sql_string (GdaConnection *cnc, GValue *from)
 /**
  * gda_connection_internal_transaction_started: (skip)
  * @cnc: a #GdaConnection
- * @parent_trans: (allow-null): name of the parent transaction, or %NULL
- * @trans_name: (allow-null): transaction's name, or %NULL
+ * @parent_trans: name of the parent transaction, or %NULL
+ * @trans_name: transaction's name, or %NULL
  * @isol_level: isolation level.
  *
  * Internal functions to be called by database providers when a transaction has been started
@@ -4892,7 +4891,7 @@ gda_connection_internal_transaction_started (GdaConnection *cnc, const gchar *pa
 /**
  * gda_connection_internal_transaction_rolledback: (skip)
  * @cnc: a #GdaConnection
- * @trans_name: (allow-null): transaction's name, or %NULL
+ * @trans_name: transaction's name, or %NULL
  *
  * Internal functions to be called by database providers when a transaction has been rolled
  * back to keep track of the transaction status of the connection
@@ -4945,7 +4944,7 @@ gda_connection_internal_transaction_rolledback (GdaConnection *cnc, const gchar
 /**
  * gda_connection_internal_transaction_committed: (skip)
  * @cnc: a #GdaConnection
- * @trans_name: (allow-null): transaction's name, or %NULL
+ * @trans_name: transaction's name, or %NULL
  *
  * Internal functions to be called by database providers when a transaction has been committed
  * to keep track of the transaction status of the connection
@@ -4998,8 +4997,8 @@ gda_connection_internal_transaction_committed (GdaConnection *cnc, const gchar *
 /**
  * gda_connection_internal_savepoint_added: (skip)
  * @cnc: a #GdaConnection
- * @parent_trans: (allow-null): name of the parent transaction, or %NULL
- * @svp_name: (allow-null): savepoint's name, or %NULL
+ * @parent_trans: name of the parent transaction, or %NULL
+ * @svp_name: savepoint's name, or %NULL
  *
  * Internal functions to be called by database providers when a savepoint has been added
  * to keep track of the transaction status of the connection
@@ -5042,7 +5041,7 @@ gda_connection_internal_savepoint_added (GdaConnection *cnc, const gchar *parent
 /**
  * gda_connection_internal_savepoint_rolledback: (skip)
  * @cnc: a #GdaConnection
- * @svp_name: (allow-null): savepoint's name, or %NULL
+ * @svp_name: savepoint's name, or %NULL
  *
  * Internal functions to be called by database providers when a savepoint has been rolled back
  * to keep track of the transaction status of the connection
@@ -5086,7 +5085,7 @@ gda_connection_internal_savepoint_rolledback (GdaConnection *cnc, const gchar *s
 /**
  * gda_connection_internal_savepoint_removed: (skip)
  * @cnc: a #GdaConnection
- * @svp_name: (allow-null): savepoint's name, or %NULL
+ * @svp_name: savepoint's name, or %NULL
  *
  * Internal functions to be called by database providers when a savepoint has been removed
  * to keep track of the transaction status of the connection
@@ -5131,7 +5130,7 @@ gda_connection_internal_savepoint_removed (GdaConnection *cnc, const gchar *svp_
  * gda_connection_internal_statement_executed: (skip)
  * @cnc: a #GdaConnection
  * @stmt: a #GdaStatement which has been executed
- * @params: (allow-null): execution's parameters
+ * @params: execution's parameters
  * @error: a #GdaConnectionEvent if the execution failed, or %NULL
  *
  * Internal functions to be called by database providers when a statement has been executed
@@ -5434,7 +5433,7 @@ gda_connection_internal_get_provider_data (GdaConnection *cnc)
  *
  * Get or initializes the #GdaMetaStore associated to @cnc
  *
- * Returns: a #GdaMetaStore object
+ * Returns: (transfer full): a #GdaMetaStore object
  */
 GdaMetaStore *
 gda_connection_get_meta_store (GdaConnection *cnc)
diff --git a/libgda/gda-data-access-wrapper.c b/libgda/gda-data-access-wrapper.c
index 6a0fac7..d1ef79f 100644
--- a/libgda/gda-data-access-wrapper.c
+++ b/libgda/gda-data-access-wrapper.c
@@ -358,7 +358,7 @@ gda_data_access_wrapper_get_property (GObject *object,
  * Creates a new #GdaDataModel object which buffers the rows of @model. This object is useful
  * only if @model can only be accessed using cursor based method.
  *
- * Returns: a pointer to the newly created #GdaDataModel.
+ * Returns: (transfer full): a pointer to the newly created #GdaDataModel.
  */
 GdaDataModel *
 gda_data_access_wrapper_new (GdaDataModel *model)
diff --git a/libgda/gda-data-model-array.c b/libgda/gda-data-model-array.c
index d659e7b..4cc00ea 100644
--- a/libgda/gda-data-model-array.c
+++ b/libgda/gda-data-model-array.c
@@ -271,7 +271,7 @@ gda_data_model_array_get_property (GObject *object, guint prop_id, GValue *value
  * Creates a new #GdaDataModel object without initializing the column
  * types. Using gda_data_model_array_new_with_g_types() is usually better.
  *
- * Returns: a pointer to the newly created #GdaDataModel.
+ * Returns: (transfer full): a pointer to the newly created #GdaDataModel.
  */
 GdaDataModel *
 gda_data_model_array_new (gint cols)
@@ -290,7 +290,7 @@ gda_data_model_array_new (gint cols)
  * Creates a new #GdaDataModel object with the column types as
  * specified.
  *
- * Returns: a pointer to the newly created #GdaDataModel.
+ * Returns: (transfer full): a pointer to the newly created #GdaDataModel.
  */
 GdaDataModel *
 gda_data_model_array_new_with_g_types (gint cols, ...)
@@ -323,7 +323,7 @@ gda_data_model_array_new_with_g_types (gint cols, ...)
  *
  * Makes a copy of @src into a new #GdaDataModelArray object
  *
- * Returns: a new data model, or %NULL if an error occurred
+ * Returns: (transfer full) (allow-none): a new data model, or %NULL if an error occurred
  */
 GdaDataModelArray *
 gda_data_model_array_copy_model (GdaDataModel *src, GError **error)
diff --git a/libgda/gda-data-model-dir.c b/libgda/gda-data-model-dir.c
index 1687e11..0015fc6 100644
--- a/libgda/gda-data-model-dir.c
+++ b/libgda/gda-data-model-dir.c
@@ -660,7 +660,7 @@ gda_data_model_dir_get_property (GObject *object,
  *
  * Creates a new #GdaDataModel object to list all the files starting from @basedir
  *
- * Returns: a new #GdaDataModel
+ * Returns: (transfer full): a new #GdaDataModel
  */
 GdaDataModel *
 gda_data_model_dir_new (const gchar *basedir)
diff --git a/libgda/gda-data-model-import.c b/libgda/gda-data-model-import.c
index 1105be2..004d527 100644
--- a/libgda/gda-data-model-import.c
+++ b/libgda/gda-data-model-import.c
@@ -689,7 +689,7 @@ gda_data_model_import_get_property (GObject *object,
  *   <listitem><para>Other formats: no option</para></listitem>
  * </itemizedlist>
  *
- * Returns: a pointer to the newly created #GdaDataModel.
+ * Returns: (transfer full): a pointer to the newly created #GdaDataModel.
  */
 GdaDataModel *
 gda_data_model_import_new_file   (const gchar *filename, gboolean random_access, GdaSet *options)
@@ -717,7 +717,7 @@ gda_data_model_import_new_file   (const gchar *filename, gboolean random_access,
  * Important note: the @data string is not copied for memory efficiency reasons and should not
  * therefore be altered in any way as long as the returned data model exists.
  *
- * Returns: a pointer to the newly created #GdaDataModel.
+ * Returns: (transfer full): a pointer to the newly created #GdaDataModel.
  */
 GdaDataModel *
 gda_data_model_import_new_mem (const gchar *data, gboolean random_access, GdaSet *options)
@@ -739,7 +739,7 @@ gda_data_model_import_new_mem (const gchar *data, gboolean random_access, GdaSet
  * Creates a new #GdaDataModel and loads the data in @node. The resulting data model
  * can be accessed in a random way.
  *
- * Returns: a pointer to the newly created #GdaDataModel.
+ * Returns: (transfer full): a pointer to the newly created #GdaDataModel.
  */
 GdaDataModel *
 gda_data_model_import_new_xml_node (xmlNodePtr node)
diff --git a/libgda/gda-data-proxy.c b/libgda/gda-data-proxy.c
index 40168cb..8849b0e 100644
--- a/libgda/gda-data-proxy.c
+++ b/libgda/gda-data-proxy.c
@@ -759,7 +759,7 @@ static void proxied_model_reset_cb (GdaDataModel *model, GdaDataProxy *proxy);
  *
  * Creates a new proxy for @model
  *
- * Returns: a new #GdaDataProxy object
+ * Returns: (transfer full): a new #GdaDataProxy object
  */
 GObject *
 gda_data_proxy_new (GdaDataModel *model)
diff --git a/libgda/gda-data-select.c b/libgda/gda-data-select.c
index 32d2457..193c10d 100644
--- a/libgda/gda-data-select.c
+++ b/libgda/gda-data-select.c
@@ -788,7 +788,7 @@ gda_data_select_take_row (GdaDataSelect *model, GdaRow *row, gint rownum)
  *
  * Get the #GdaRow object stored within @model at row @rownum (without taking care of removed rows)
  *
- * Returns: (tranfer none): the requested #GdaRow, or %NULL if not found
+ * Returns: (transfer none): the requested #GdaRow, or %NULL if not found
  */
 GdaRow *
 gda_data_select_get_stored_row (GdaDataSelect *model, gint rownum)
@@ -811,7 +811,7 @@ gda_data_select_get_stored_row (GdaDataSelect *model, gint rownum)
  * Get a pointer to the #GdaConnection object which was used when @model was created
  * (and which may be used internally by @model).
  *
- * Returns: (tranfer none): a pointer to the #GdaConnection, or %NULL
+ * Returns: (transfer none): a pointer to the #GdaConnection, or %NULL
  */
 GdaConnection *
 gda_data_select_get_connection (GdaDataSelect *model)
diff --git a/libgda/gda-easy.c b/libgda/gda-easy.c
index eb82717..f310286 100644
--- a/libgda/gda-easy.c
+++ b/libgda/gda-easy.c
@@ -52,7 +52,7 @@ GQuark gda_easy_error_quark (void)
  * If @db_name is left %NULL, then the name of the database to create will have to be set in the
  * returned #GdaServerOperation using gda_server_operation_set_value_at().
  *
- * Returns: new #GdaServerOperation object, or %NULL if the provider does not support database
+ * Returns: (transfer full) (allow-none): new #GdaServerOperation object, or %NULL if the provider does not support database
  * creation
  */
 GdaServerOperation *
@@ -121,7 +121,7 @@ gda_perform_create_database (const gchar *provider, GdaServerOperation *op, GErr
  * If @db_name is left %NULL, then the name of the database to drop will have to be set in the
  * returned #GdaServerOperation using gda_server_operation_set_value_at().
  *
- * Returns: new #GdaServerOperation object, or %NULL if the provider does not support database
+ * Returns: (transfer full) (allow-none): new #GdaServerOperation object, or %NULL if the provider does not support database
  * destruction
  */
 GdaServerOperation *
@@ -185,7 +185,7 @@ gda_perform_drop_database (const gchar *provider, GdaServerOperation *op, GError
  * 
  * Execute a SQL SELECT command over an opened connection.
  *
- * Returns: a new #GdaDataModel if successful, NULL otherwise
+ * Returns: (transfer full) (allow-none): a new #GdaDataModel if successful, NULL otherwise
  */
 GdaDataModel *          
 gda_execute_select_command (GdaConnection *cnc, const gchar *sql, GError **error)
@@ -278,7 +278,7 @@ gda_execute_non_select_command (GdaConnection *cnc, const gchar *sql, GError **e
  * or #gda_server_operation_perform_operation
  * in order to execute the operation.
  * 
- * Returns: a #GdaServerOperation if no errors; NULL and set @error otherwise
+ * Returns: (transfer full) (allow-none): a #GdaServerOperation if no errors; NULL and set @error otherwise
  */
 GdaServerOperation*
 gda_prepare_create_table (GdaConnection *cnc, const gchar *table_name, GError **error, ...)
@@ -469,7 +469,7 @@ gda_perform_create_table (GdaServerOperation *op, GError **error)
  * This is just a convenient function to create a #GdaServerOperation to drop a 
  * table in an opened connection.
  *
- * Returns: a new #GdaServerOperation or NULL if couldn't create the opereration.
+ * Returns: (transfer full) (allow-none): a new #GdaServerOperation or NULL if couldn't create the opereration.
  */
 GdaServerOperation*
 gda_prepare_drop_table (GdaConnection *cnc, const gchar *table_name, GError **error)
@@ -1051,7 +1051,7 @@ gda_delete_row_from_table (GdaConnection *cnc, const gchar *table,
 }
 
 /**
- * gda_parse_sql_string
+ * gda_parse_sql_string:
  * @cnc: (allow-none): a #GdaConnection object, or %NULL
  * @sql: an SQL command to parse, not %NULL
  * @params: (out) (allow-none) (transfer full): a place to store a new #GdaSet, for parameters used in SQL command, or %NULL
@@ -1059,7 +1059,7 @@ gda_delete_row_from_table (GdaConnection *cnc, const gchar *table,
  *
  * This function helps to parse a SQL witch use paramenters and store them at @params.
  *
- * Returns: a #GdaStatement representing the SQL command, or %NULL if an error occurred
+ * Returns: (transfer full) (allow-none): a #GdaStatement representing the SQL command, or %NULL if an error occurred
  *
  * Since: 4.2
  */
diff --git a/libgda/gda-holder.c b/libgda/gda-holder.c
index d089163..dc1c17e 100644
--- a/libgda/gda-holder.c
+++ b/libgda/gda-holder.c
@@ -343,7 +343,7 @@ gda_holder_new (GType type)
  * Note1: if @orig is set with a static value (see gda_holder_take_static_value()) 
  * its copy will have a fresh new allocated GValue, so that user should free it when done.
  *
- * Returns: a new #GdaHolder object
+ * Returns: (transfer full): a new #GdaHolder object
  */
 GdaHolder *
 gda_holder_copy (GdaHolder *orig)
@@ -677,7 +677,7 @@ gda_holder_get_property (GObject *object,
  * 
  * Get @holder's type
  *
- * Returns: (tranfer none): the data type
+ * Returns: (transfer none): the data type
  */
 GType
 gda_holder_get_g_type (GdaHolder *holder)
diff --git a/libgda/gda-meta-store.c b/libgda/gda-meta-store.c
index 1cea7e5..0990902 100644
--- a/libgda/gda-meta-store.c
+++ b/libgda/gda-meta-store.c
@@ -830,7 +830,7 @@ gda_meta_store_set_identifiers_style (GdaMetaStore *store, GdaSqlIdentifierStyle
 /**
  * gda_meta_store_set_reserved_keywords_func:
  * @store: a #GdaMetaStore object
- * @func: (allow-none): a #GdaSqlReservedKeywordsFunc function, or %NULL
+ * @func: (allow-none) (scope call): a #GdaSqlReservedKeywordsFunc function, or %NULL
  *
  * Specifies a function which @store will use to determine if a keyword is an SQL reserved
  * keyword or not.
@@ -3241,7 +3241,7 @@ gda_meta_store_create_modify_data_model (GdaMetaStore *store, const gchar *table
  * are respected: if table B has a foreign key on table A, then table A will be listed before table B in the returned
  * list.
  *
- * Returns: (transfer container) (element type gchar*): a new list of tables names (as gchar*), the list must be freed when no longer needed, but the strings present in the list must not be modified.
+ * Returns: (transfer container) (element-type utf8): a new list of tables names (as gchar*), the list must be freed when no longer needed, but the strings present in the list must not be modified.
  */
 GSList *
 gda_meta_store_schema_get_all_tables (GdaMetaStore *store)
@@ -3281,7 +3281,7 @@ gda_meta_store_schema_get_all_tables (GdaMetaStore *store)
  * are respected: if table B has a foreign key on table A, then table A will be listed before table B in the returned
  * list.
  *
- * Returns: (transfer container) (element type gchar*): a new list of tables names (as gchar*), the list must be freed when no longer needed, but the strings present in the list must not be modified.
+ * Returns: (transfer container) (element-type utf8): a new list of tables names (as gchar*), the list must be freed when no longer needed, but the strings present in the list must not be modified.
  */
 GSList *
 gda_meta_store_schema_get_depend_tables (GdaMetaStore *store, const gchar *table_name)
diff --git a/libgda/gda-meta-struct.c b/libgda/gda-meta-struct.c
index 5081c51..35ec743 100644
--- a/libgda/gda-meta-struct.c
+++ b/libgda/gda-meta-struct.c
@@ -1608,7 +1608,7 @@ gda_meta_struct_get_db_object (GdaMetaStruct *mstruct, const GValue *catalog, co
 }
 
 /**
- * gda_meta_struct_get_table_column
+ * gda_meta_struct_get_table_column: (skip):
  * @mstruct: a #GdaMetaStruct object
  * @table: the #GdaMetaTable structure to find the column for
  * @col_name: the name of the column to find (as a G_TYPE_STRING GValue)
@@ -2342,8 +2342,8 @@ gda_meta_table_column_set_attribute (GdaMetaTableColumn *tcol, const gchar *attr
 /**
  * gda_meta_table_column_foreach_attribute:
  * @tcol: a #GdaMetaTableColumn
- * @func: a #GdaAttributesManagerFunc function
- * @data: user data to be passed as last argument of @func each time it is called
+ * @func: (scope call): a #GdaAttributesManagerFunc function
+ * @data: (closure): user data to be passed as last argument of @func each time it is called
  *
  * Calls @func for each attribute set to tcol
  */
diff --git a/libgda/gda-mutex.c b/libgda/gda-mutex.c
index 37e31ba..09823d8 100644
--- a/libgda/gda-mutex.c
+++ b/libgda/gda-mutex.c
@@ -36,7 +36,7 @@ struct _GdaMutex {
 };
 
 /**
- * gda_mutex_new:
+ * gda_mutex_new: (skip):
  *
  * Creates a new #GdaMutex.
  *
diff --git a/libgda/gda-quark-list.c b/libgda/gda-quark-list.c
index afcade3..fae89be 100644
--- a/libgda/gda-quark-list.c
+++ b/libgda/gda-quark-list.c
@@ -252,10 +252,10 @@ gda_quark_list_remove (GdaQuarkList *qlist, const gchar *name)
 }
 
 /**
- * gda_quark_list_foreach
+ * gda_quark_list_foreach:
  * @qlist: a #GdaQuarkList structure.
- * @func: the function to call for each key/value pair
- * @user_data: user data to pass to the function
+ * @func: (scope call): the function to call for each key/value pair
+ * @user_data: (closure): user data to pass to the function
  *
  * Calls the given function for each of the key/value pairs in @qlist. The function is passed the key and value 
  * of each pair, and the given user_data parameter. @qlist may not be modified while iterating over it.
diff --git a/libgda/gda-server-operation.c b/libgda/gda-server-operation.c
index 830148e..560a6ee 100644
--- a/libgda/gda-server-operation.c
+++ b/libgda/gda-server-operation.c
@@ -1052,7 +1052,7 @@ gda_server_operation_new (GdaServerOperationType op_type, const gchar *xml_file)
 }
 
 /**
- * gda_server_operation_get_node_info:
+ * gda_server_operation_get_node_info: (skip):
  * @op: a #GdaServerOperation object
  * @path_format: a complete path to a node (starting with "/") as a format string, similar to g_strdup_printf()'s argument
  * @...: the arguments to insert into the format string
@@ -1060,7 +1060,7 @@ gda_server_operation_new (GdaServerOperationType op_type, const gchar *xml_file)
  * Get information about the node identified by @path. The returned #GdaServerOperationNode structure can be 
  * copied but not modified; it may change or cease to exist if @op changes
  *
- * Returns: (transfer none): a #GdaServerOperationNode structure, or %NULL if the node was not found
+ * Returns: (transfer none) (allow-none): a #GdaServerOperationNode structure, or %NULL if the node was not found
  */
 GdaServerOperationNode *
 gda_server_operation_get_node_info (GdaServerOperation *op, const gchar *path_format, ...)
@@ -1293,7 +1293,7 @@ gda_server_operation_string_to_op_type (const gchar *str)
 static gboolean node_save (GdaServerOperation *op, Node *opnode, xmlNodePtr parent);
 
 /**
- * gda_server_operation_save_data_to_xml:
+ * gda_server_operation_save_data_to_xml: (skip):
  * @op: a #GdaServerOperation object
  * @error: (allow-none): a place to store errors or %NULL
  * 
diff --git a/libgda/gda-server-operation.h b/libgda/gda-server-operation.h
index 42ce83f..eb39d1d 100644
--- a/libgda/gda-server-operation.h
+++ b/libgda/gda-server-operation.h
@@ -143,7 +143,7 @@ guint                      gda_server_operation_get_sequence_max_size   (GdaServ
 guint                      gda_server_operation_get_sequence_min_size   (GdaServerOperation *op, const gchar *path);
 gchar                    **gda_server_operation_get_sequence_item_names (GdaServerOperation *op, const gchar *path); 
 
-guint                      gda_server_operation_add_item_to_sequence    (GdaServerOperation *op, const gchar *path);
+guint                      gda_server_operation_add_item_to_sequence    (GdaServerOperation *op, const gchar *seq_path);
 gboolean                   gda_server_operation_del_item_from_sequence  (GdaServerOperation *op, const gchar *item_path);
 
 gboolean                   gda_server_operation_is_valid                (GdaServerOperation *op, const gchar *xml_file, GError **error);
diff --git a/libgda/gda-server-provider-extra.c b/libgda/gda-server-provider-extra.c
index afafa28..765fdc7 100644
--- a/libgda/gda-server-provider-extra.c
+++ b/libgda/gda-server-provider-extra.c
@@ -566,6 +566,12 @@ gda_server_provider_test_schema_model (GdaDataModel *model, GdaConnectionSchema
 	return TRUE;
 }
 
+/**
+ * gda_server_provider_handler_find:
+ *
+ * Returns: (transfer none):
+ *
+ */
 GdaDataHandler *
 gda_server_provider_handler_find (GdaServerProvider *prov, GdaConnection *cnc, 
 				  GType g_type, const gchar *dbms_type)
diff --git a/libgda/gda-server-provider.c b/libgda/gda-server-provider.c
index 20ff1e1..7c08c43 100644
--- a/libgda/gda-server-provider.c
+++ b/libgda/gda-server-provider.c
@@ -452,7 +452,7 @@ static OpReq op_req_CREATE_USER [] = {
  *  <listitem>named values which may change the contents of the GdaServerOperation, see <link linkend="gda-server-op-information-std">this section</link> for more information</listitem>
  * </itemizedlist>
  *
- * Returns: (transfer full): a new #GdaServerOperation object, or %NULL in the provider does not support the @type type of operation or if an error occurred
+ * Returns: (transfer full) (allow-none): a new #GdaServerOperation object, or %NULL in the provider does not support the @type type of operation or if an error occurred
  */
 GdaServerOperation *
 gda_server_provider_create_operation (GdaServerProvider *provider, GdaConnection *cnc, 
@@ -560,7 +560,7 @@ gda_server_provider_create_operation (GdaServerProvider *provider, GdaConnection
  * This function's purpose is mainly informative to get the actual SQL code which would be executed to perform
  * the operation; to actually perform the operation, use gda_server_provider_perform_operation().
  *
- * Returns: (transfer full): a new string, or %NULL if an error occurred or operation cannot be rendered as SQL.
+ * Returns: (transfer full) (allow-none): a new string, or %NULL if an error occurred or operation cannot be rendered as SQL.
  */
 gchar *
 gda_server_provider_render_operation (GdaServerProvider *provider, GdaConnection *cnc, 
@@ -735,7 +735,7 @@ gda_server_provider_get_data_handler_dbms (GdaServerProvider *provider, GdaConne
 /**
  * gda_server_provider_get_default_dbms_type:
  * @provider: a server provider.
- * @cnc:(allow-none):  a #GdaConnection object or %NULL
+ * @cnc: (allow-none):  a #GdaConnection object or %NULL
  * @type: a #GType value type
  *
  * Get the name of the most common data type which has @type type.
@@ -744,7 +744,7 @@ gda_server_provider_get_data_handler_dbms (GdaServerProvider *provider, GdaConne
  * there is no DBMS data type which could contain data of the @g_type type (for example %NULL may be
  * returned if a DBMS has integers only up to 4 bytes and a G_TYPE_INT64 is requested).
  *
- * Returns: (transfer none): the name of the DBMS type, or %NULL
+ * Returns: (transfer none) (allow-none): the name of the DBMS type, or %NULL
  */
 const gchar *
 gda_server_provider_get_default_dbms_type (GdaServerProvider *provider, GdaConnection *cnc, GType type)
diff --git a/libgda/gda-sql-builder.c b/libgda/gda-sql-builder.c
index 1494058..06de52e 100644
--- a/libgda/gda-sql-builder.c
+++ b/libgda/gda-sql-builder.c
@@ -344,14 +344,13 @@ gda_sql_builder_get_statement (GdaSqlBuilder *builder, GError **error)
 /**
  * gda_sql_builder_get_sql_statement:
  * @builder: a #GdaSqlBuilder object
- * @copy_it: set to %TRUE to be able to reuse @builder
  *
  * Creates a new #GdaSqlStatement structure from @builder's contents.
  *
  * The returned pointer belongs to @builder's internal representation.
  * Use gda_sql_statement_copy() if you need to keep it.
  *
- * Returns: (transfer none): a #GdaSqlStatement pointer
+ * Returns: (transfer none) (allow-none): a #GdaSqlStatement pointer
  *
  * Since: 4.2
  */
@@ -948,7 +947,7 @@ gda_sql_builder_add_id (GdaSqlBuilder *builder, const gchar *string)
  * gda_sql_builder_add_field_id:
  * @builder: a #GdaSqlBuilder object
  * @field_name: a field name
- * @table_name: (allow-null): a table name, or %NULL
+ * @table_name: (allow-none): a table name, or %NULL
  *
  * Defines an expression representing a field in @builder,
  * which may be reused to build other parts of a statement,
@@ -1622,7 +1621,7 @@ gda_sql_builder_select_group_by (GdaSqlBuilder *builder, GdaSqlBuilderId expr_id
 /**
  * gda_sql_builder_add_function:
  * @builder: a #GdaSqlBuilder object
- * @function_id: the ID of the functions's name
+ * @func_name: the functions's name
  * @...: a list, terminated with %0, of each function's argument's ID
  *
  * Builds a new expression which reprenents a function applied to some arguments
@@ -1667,7 +1666,7 @@ gda_sql_builder_add_function (GdaSqlBuilder *builder, const gchar *func_name, ..
 /**
  * gda_sql_builder_add_function_v:
  * @builder: a #GdaSqlBuilder object
- * @function_id: the ID of the functions's name
+ * @func_name: the functions's name
  * @args: (array length=args_size): an array of IDs representing the function's arguments
  * @args_size: @args's size
  *
@@ -1711,7 +1710,6 @@ gda_sql_builder_add_function_v (GdaSqlBuilder *builder, const gchar *func_name,
  * gda_sql_builder_add_sub_select:
  * @builder: a #GdaSqlBuilder object
  * @sqlst: a pointer to a #GdaSqlStatement, which has to be a SELECT or compound SELECT. This will be copied.
- * @steal: if %TRUE, then @sqlst will be "stolen" by @b and should not be used anymore
  *
  * Adds an expression which is a subselect.
  *
diff --git a/libgda/gda-sql-builder.h b/libgda/gda-sql-builder.h
index 8c07794..90d6eb3 100644
--- a/libgda/gda-sql-builder.h
+++ b/libgda/gda-sql-builder.h
@@ -117,7 +117,7 @@ void              gda_sql_builder_select_order_by (GdaSqlBuilder *builder, GdaSq
 void              gda_sql_builder_select_set_distinct (GdaSqlBuilder *builder,
 						       gboolean distinct, GdaSqlBuilderId expr_id);
 void              gda_sql_builder_select_set_limit (GdaSqlBuilder *builder,
-						    GdaSqlBuilderId limit_count_expr_id, GdaSqlBuilderId limit_offest_expr_id);
+						    GdaSqlBuilderId limit_count_expr_id, GdaSqlBuilderId limit_offset_expr_id);
 
 void              gda_sql_builder_select_set_having (GdaSqlBuilder *builder, GdaSqlBuilderId cond_id);
 void              gda_sql_builder_select_group_by (GdaSqlBuilder *builder, GdaSqlBuilderId expr_id);
diff --git a/libgda/gda-statement.c b/libgda/gda-statement.c
index d562f4c..a96b432 100644
--- a/libgda/gda-statement.c
+++ b/libgda/gda-statement.c
@@ -205,7 +205,7 @@ _gda_statement_get_internal_struct (GdaStatement *stmt)
  * 
  * Copy constructor
  *
- * Returns: a the new copy of @orig
+ * Returns: (transfer full): a the new copy of @orig
  */
 GdaStatement *
 gda_statement_copy (GdaStatement *orig)
diff --git a/libgda/gda-transaction-status.c b/libgda/gda-transaction-status.c
index 29d2369..4aad698 100644
--- a/libgda/gda-transaction-status.c
+++ b/libgda/gda-transaction-status.c
@@ -151,6 +151,10 @@ gda_transaction_status_new (const gchar *name)
 	return tstatus;
 }
 
+/**
+ * gda_transaction_status_add_event_svp: (skip):
+ *
+ */
 GdaTransactionStatusEvent *
 gda_transaction_status_add_event_svp (GdaTransactionStatus *tstatus, const gchar *svp_name)
 {
@@ -168,6 +172,10 @@ gda_transaction_status_add_event_svp (GdaTransactionStatus *tstatus, const gchar
 	return ev;
 }
 
+/**
+ * gda_transaction_status_add_event_sql: (skip):
+ *
+ */
 GdaTransactionStatusEvent *
 gda_transaction_status_add_event_sql (GdaTransactionStatus *tstatus, const gchar *sql, GdaConnectionEvent *conn_event)
 {
@@ -189,6 +197,10 @@ gda_transaction_status_add_event_sql (GdaTransactionStatus *tstatus, const gchar
 	return ev;
 }
 
+/**
+ * gda_transaction_status_add_event_sub: (skip)
+ *
+ */
 GdaTransactionStatusEvent *
 gda_transaction_status_add_event_sub (GdaTransactionStatus *tstatus, GdaTransactionStatus *sub_trans)
 {
@@ -231,6 +243,11 @@ gda_transaction_status_free_events (GdaTransactionStatus *tstatus, GdaTransactio
 	tstatus->events = g_list_delete_link (tstatus->events, node);
 }
 
+/**
+ * gda_transaction_status_find:
+ *
+ * Returns: (transfer full) (allow-none):
+ */
 GdaTransactionStatus *
 gda_transaction_status_find (GdaTransactionStatus *tstatus, const gchar *str, GdaTransactionStatusEvent **destev)
 {
@@ -274,9 +291,13 @@ gda_transaction_status_find (GdaTransactionStatus *tstatus, const gchar *str, Gd
 	return trans;
 }
 
-/*
+/**
+ * gda_transaction_status_find_current:
+ *
  * Find a pointer to the "current" _unnamed_ transaction, which is the last
  * transaction if there are several nested transactions
+ *
+ * Returns: (transfer full) (allow-none):
  */
 GdaTransactionStatus *
 gda_transaction_status_find_current (GdaTransactionStatus *tstatus, GdaTransactionStatusEvent **destev, gboolean unnamed_only)
diff --git a/libgda/gda-tree-manager.c b/libgda/gda-tree-manager.c
index 4b391cd..640b301 100644
--- a/libgda/gda-tree-manager.c
+++ b/libgda/gda-tree-manager.c
@@ -303,7 +303,7 @@ _gda_tree_manager_update_children (GdaTreeManager *manager, GdaTreeNode *node, c
 
 /**
  * gda_tree_manager_new_with_func:
- * @update_func: the function to call when the manager object is requested to create or update its list of
+ * @update_func: (scope call): the function to call when the manager object is requested to create or update its list of
  * #GdaTreeNode nodes
  *
  * Use this method to create a new #GdaTreeManager if it's more convenient than subclassing; all is needed
@@ -439,7 +439,7 @@ gda_tree_manager_get_managers (GdaTreeManager *manager)
 /**
  * gda_tree_manager_set_node_create_func:
  * @manager: a #GdaTreeManager tree manager object
- * @func: (allow-none): a #GdaTreeManagerNodeFunc function pointer, or %NULL
+ * @func: (allow-none) (scope call): a #GdaTreeManagerNodeFunc function pointer, or %NULL
  *
  * Sets the function to be called when a new node is being created by @manager. If @func is %NULL
  * then each created node will be a #GdaTreeNode object.
@@ -457,12 +457,12 @@ gda_tree_manager_set_node_create_func (GdaTreeManager *manager, GdaTreeManagerNo
 }
 
 /**
- * gda_tree_manager_get_node_create_func:
+ * gda_tree_manager_get_node_create_func: (skip):
  * @manager: a #GdaTreeManager tree manager object
  *
  * Get the function used by @manager when creating new #GdaTreeNode nodes
  *
- * Returns: (transfer none): the #GdaTreeManagerNodeFunc function, or %NULL if the default function is used
+ * Returns: the #GdaTreeManagerNodeFunc function, or %NULL if the default function is used
  *
  * Since: 4.2
  */
diff --git a/libgda/gda-tree.c b/libgda/gda-tree.c
index 7952303..9234450 100644
--- a/libgda/gda-tree.c
+++ b/libgda/gda-tree.c
@@ -637,7 +637,7 @@ build_node_path (GdaTree *tree, GdaTreeNode *node, GArray *array)
 }
 
 /**
- * gda_tree_get_node
+ * gda_tree_get_node:
  * @tree: a #GdaTree object
  * @tree_path: full path to the required nodes (if @use_names is %TRUE, then it must start with '/')
  * @use_names: if %TRUE, then @tree_path will be interpreted as a unix style path, and if %FALSE,
@@ -645,7 +645,7 @@ build_node_path (GdaTree *tree, GdaTreeNode *node, GArray *array)
  *
  * Locates a #GdaTreeNode using the @tree_path path.
  *
- * Returns: (transfer none): the requested #GdaTreeNode pointer, or %NULL if not found
+ * Returns: (transfer none) (allow-none): the requested #GdaTreeNode pointer, or %NULL if not found
  *
  * Since: 4.2
  */
diff --git a/libgda/gda-util.c b/libgda/gda-util.c
index 536dbd7..8235de2 100644
--- a/libgda/gda-util.c
+++ b/libgda/gda-util.c
@@ -1573,7 +1573,7 @@ cmp_func (gconstpointer a, gconstpointer b)
 }
 
 /**
- * gda_completion_list_get
+ * gda_completion_list_get:
  * @cnc: a #GdaConnection object
  * @sql: a partial SQL statement which is the context of the completion proposal
  * @start: starting position within @sql of the "token" to complete (starts at 0)
@@ -1583,7 +1583,7 @@ cmp_func (gconstpointer a, gconstpointer b)
  * If no completion is available, then the returned array contains just one NULL entry, and
  * if it was not possible to try to compute a completions list, then %NULL is returned.
  *
- * Returns: a new array of strings, or %NULL (use g_strfreev() to free the returned array)
+ * Returns: (transfer full) (array zero-terminated=1) (allow-none): a new array of strings, or %NULL (use g_strfreev() to free the returned array)
  */
 gchar **
 gda_completion_list_get (GdaConnection *cnc, const gchar *sql, gint start, gint end)
@@ -1836,7 +1836,7 @@ concat_ident (const char *prefix, const gchar *ident)
 }
 
 /**
- * gda_sql_identifier_split
+ * gda_sql_identifier_split:
  * @id: an SQL identifier
  * 
  * Splits @id into an array of it sub parts. @id's format has to be "&lt;part&gt;[.&lt;part&gt;[...]]" where
@@ -1845,7 +1845,7 @@ concat_ident (const char *prefix, const gchar *ident)
  *
  * For example the <![CDATA["test.\"ATable\""]]> string will result in the array: <![CDATA[{"test", "\"ATable\"", NULL}]]>
  *
- * Returns: a new %NULL-terminated array of strings, or NULL (use g_strfreev() to free the returned array)
+ * Returns: (transfer full) (array zero-terminated=1) (allow-none): a new %NULL-terminated array of strings, or NULL (use g_strfreev() to free the returned array)
  */
 gchar **
 gda_sql_identifier_split (const gchar *id)
diff --git a/libgda/gda-value.c b/libgda/gda-value.c
index 89d6ade..116ed97 100644
--- a/libgda/gda-value.c
+++ b/libgda/gda-value.c
@@ -542,6 +542,11 @@ gda_geometricpoint_get_type (void)
 	return type;
 }
 
+/**
+ * gda_geometricpoint_copy:
+ *
+ * Returns: (transfer full):
+ */
 gpointer 
 gda_geometricpoint_copy (gpointer boxed)
 {
@@ -926,6 +931,11 @@ gda_time_get_type(void)
 	return type;
 }
 
+/**
+ * gda_time_copy:
+ *
+ * Returns: (transfer full):
+ */
 gpointer
 gda_time_copy (gpointer boxed)
 {
@@ -1059,6 +1069,11 @@ gda_timestamp_get_type (void)
 	return type;
 }
 
+/**
+ * gda_timestamp_copy:
+ *
+ * Returns: (transfer full):
+ */
 gpointer 
 gda_timestamp_copy (gpointer boxed)
 {
@@ -2425,7 +2440,7 @@ to_string (const GValue *value)
 
 
 /**
- * gda_value_to_xml:
+ * gda_value_to_xml: (skip):
  * @value: a #GValue.
  *
  * Serializes the given #GValue to an XML node string.
diff --git a/libgda/gda-xa-transaction.c b/libgda/gda-xa-transaction.c
index a62c60f..2d3705b 100644
--- a/libgda/gda-xa-transaction.c
+++ b/libgda/gda-xa-transaction.c
@@ -744,13 +744,13 @@ gda_xa_transaction_id_to_string (const GdaXaTransactionId *xid)
 }
 
 /**
- * gda_xa_transaction_string_to_id:
+ * gda_xa_transaction_string_to_id: (skip):
  * @str: a string representation of a #GdaXaTransactionId, in the "gtrid,bqual,formatID" format
  *
  * Creates a new #GdaXaTransactionId structure from its string representation, it's the opposite
  * of gda_xa_transaction_id_to_string().
  *
- * Returns: (transfer full): a new #GdaXaTransactionId structure, or %NULL in @str has a wrong format
+ * Returns: a new #GdaXaTransactionId structure, or %NULL in @str has a wrong format
  *
  * Free-function: g_free
  */
diff --git a/libgda/handlers/gda-handler-bin.c b/libgda/handlers/gda-handler-bin.c
index 6c4ccf2..3ba2453 100644
--- a/libgda/handlers/gda-handler-bin.c
+++ b/libgda/handlers/gda-handler-bin.c
@@ -148,11 +148,11 @@ gda_handler_bin_dispose (GObject   * object)
 }
 
 /**
- * gda_handler_bin_new
+ * gda_handler_bin_new:
  *
  * Creates a data handler for binary values
  *
- * Returns: the new object
+ * Returns: (transfer full): the new object
  */
 GdaDataHandler *
 gda_handler_bin_new (void)
diff --git a/libgda/handlers/gda-handler-boolean.c b/libgda/handlers/gda-handler-boolean.c
index aecceda..9f3f87c 100644
--- a/libgda/handlers/gda-handler-boolean.c
+++ b/libgda/handlers/gda-handler-boolean.c
@@ -146,11 +146,11 @@ gda_handler_boolean_dispose (GObject *object)
 }
 
 /**
- * gda_handler_boolean_new
+ * gda_handler_boolean_new:
  *
  * Creates a data handler for booleans
  *
- * Returns: the new object
+ * Returns: (transfer full): the new object
  */
 GdaDataHandler *
 gda_handler_boolean_new (void)
diff --git a/libgda/handlers/gda-handler-numerical.c b/libgda/handlers/gda-handler-numerical.c
index 065271e..2b30286 100644
--- a/libgda/handlers/gda-handler-numerical.c
+++ b/libgda/handlers/gda-handler-numerical.c
@@ -160,11 +160,11 @@ gda_handler_numerical_dispose (GObject *object)
 }
 
 /**
- * gda_handler_numerical_new
+ * gda_handler_numerical_new:
  *
  * Creates a data handler for numerical values
  *
- * Returns: the new object
+ * Returns: (transfer full): the new object
  */
 GdaDataHandler *
 gda_handler_numerical_new (void)
diff --git a/libgda/handlers/gda-handler-string.c b/libgda/handlers/gda-handler-string.c
index bb330b0..ef3e583 100644
--- a/libgda/handlers/gda-handler-string.c
+++ b/libgda/handlers/gda-handler-string.c
@@ -156,11 +156,11 @@ gda_handler_string_dispose (GObject   * object)
 }
 
 /**
- * gda_handler_string_new
+ * gda_handler_string_new:
  *
  * Creates a data handler for strings
  *
- * Returns: the new object
+ * Returns: (transfer full): the new object
  */
 GdaDataHandler *
 gda_handler_string_new (void)
@@ -173,14 +173,14 @@ gda_handler_string_new (void)
 }
 
 /**
- * gda_handler_string_new_with_provider
+ * gda_handler_string_new_with_provider:
  * @prov: a #GdaServerProvider object
- * @cnc: a #GdaConnection object, or %NULL
+ * @cnc: (allow-none): a #GdaConnection object, or %NULL
  *
  * Creates a data handler for strings, which will use some specific methods implemented
  * by the @prov object (possibly also @cnc).
  *
- * Returns: the new object
+ * Returns: (transfer full): the new object
  */
 GdaDataHandler *
 gda_handler_string_new_with_provider (GdaServerProvider *prov, GdaConnection *cnc)
diff --git a/libgda/handlers/gda-handler-time.c b/libgda/handlers/gda-handler-time.c
index 4f6fa7c..47eb371 100644
--- a/libgda/handlers/gda-handler-time.c
+++ b/libgda/handlers/gda-handler-time.c
@@ -195,11 +195,11 @@ gda_handler_time_dispose (GObject *object)
 }
 
 /**
- * gda_handler_time_new
+ * gda_handler_time_new:
  *
  * Creates a data handler for time values
  *
- * Returns: the new object
+ * Returns: (transfer full): the new object
  */
 GdaDataHandler *
 gda_handler_time_new (void)
@@ -213,12 +213,12 @@ gda_handler_time_new (void)
 }
 
 /**
- * gda_handler_time_new_no_locale
+ * gda_handler_time_new_no_locale:
  *
  * Creates a data handler for time values, but using the default C locale
  * instead of the current user locale.
  *
- * Returns: the new object
+ * Returns: (transfer full): the new object
  */
 GdaDataHandler *
 gda_handler_time_new_no_locale (void)
diff --git a/libgda/handlers/gda-handler-type.c b/libgda/handlers/gda-handler-type.c
index f6a13e8..6be3885 100644
--- a/libgda/handlers/gda-handler-type.c
+++ b/libgda/handlers/gda-handler-type.c
@@ -145,11 +145,11 @@ gda_handler_type_dispose (GObject   * object)
 }
 
 /**
- * gda_handler_type_new
+ * gda_handler_type_new:
  *
  * Creates a data handler for Gda types
  *
- * Returns: the new object
+ * Returns: (transfer full): the new object
  */
 GdaDataHandler *
 gda_handler_type_new (void)
diff --git a/libgda/providers-support/gda-pstmt.c b/libgda/providers-support/gda-pstmt.c
index 17a977f..9f41046 100644
--- a/libgda/providers-support/gda-pstmt.c
+++ b/libgda/providers-support/gda-pstmt.c
@@ -213,7 +213,7 @@ gda_pstmt_copy_contents (GdaPStmt *src, GdaPStmt *dest)
 }
 
 /**
- * gda_pstmt_get_gda_statement
+ * gda_pstmt_get_gda_statement:
  * @pstmt: a #GdaPStmt object
  *
  * Get a pointer to the #GdaStatement which led to the creation of this prepared statement.
diff --git a/libgda/sql-parser/gda-sql-parser.c b/libgda/sql-parser/gda-sql-parser.c
index 41679c0..36490b0 100644
--- a/libgda/sql-parser/gda-sql-parser.c
+++ b/libgda/sql-parser/gda-sql-parser.c
@@ -429,7 +429,7 @@ gda_sql_parser_get_property (GObject *object,
  * To include variables in the @sql string, see the
  * <link linkend="GdaSqlParser.description">GdaSqlParser's object description</link>.
  *
- * Returns: a new #GdaStatement object, or %NULL if an error occurred
+ * Returns: (transfer full) (allow-none): a new #GdaStatement object, or %NULL if an error occurred
  */
 GdaStatement *
 gda_sql_parser_parse_string (GdaSqlParser *parser, const gchar *sql, const gchar **remain, GError **error)
@@ -666,7 +666,7 @@ gda_sql_parser_parse_string (GdaSqlParser *parser, const gchar *sql, const gchar
  * To include variables in the @sql string, see the
  * <link linkend="GdaSqlParser.description">GdaSqlParser's object description</link>.
  *
- * Returns: a new #GdaBatch object, or %NULL if an error occurred
+ * Returns: (transfer full) (allow-none): a new #GdaBatch object, or %NULL if an error occurred
  */
 GdaBatch *
 gda_sql_parser_parse_string_as_batch (GdaSqlParser *parser, const gchar *sql, const gchar **remain,
@@ -752,7 +752,7 @@ gda_sql_parser_parse_string_as_batch (GdaSqlParser *parser, const gchar *sql, co
  *
  * if @sql is %NULL, then the returned #GdaBatch object will contain no statement.
  *
- * Returns: a new #GdaBatch object, or %NULL if an error occurred
+ * Returns: (transfer full) (allow-none): a new #GdaBatch object, or %NULL if an error occurred
  */
 GdaBatch *
 gda_sql_parser_parse_file_as_batch (GdaSqlParser *parser, const gchar *filename, GError **error)
diff --git a/libgda/sql-parser/gda-statement-struct.c b/libgda/sql-parser/gda-statement-struct.c
index d4ef6d4..4b27b5f 100644
--- a/libgda/sql-parser/gda-statement-struct.c
+++ b/libgda/sql-parser/gda-statement-struct.c
@@ -1172,10 +1172,10 @@ gda_sql_any_part_check_structure (GdaSqlAnyPart *node, GError **error)
 }
 
 /**
- * gda_sql_any_part_foreach
+ * gda_sql_any_part_foreach:
  * @node: the stat node
- * @func: function to call for each sub node
- * @data: data to pass to @func each time it is called
+ * @func: (scope call): function to call for each sub node
+ * @data: (closure): data to pass to @func each time it is called
  * @error: a place to store errors, or %NULL (is also passed to @func)
  *
  * Calls a function for each element of a #GdaSqlAnyPart node
diff --git a/libgda/thread-wrapper/gda-thread-wrapper.c b/libgda/thread-wrapper/gda-thread-wrapper.c
index 8c87e07..c183e8a 100644
--- a/libgda/thread-wrapper/gda-thread-wrapper.c
+++ b/libgda/thread-wrapper/gda-thread-wrapper.c
@@ -777,7 +777,7 @@ gda_thread_wrapper_iterate (GdaThreadWrapper *wrapper, gboolean may_block)
 }
 
 /**
- * gda_thread_wrapper_fetch_result
+ * gda_thread_wrapper_fetch_result:
  * @wrapper: a #GdaThreadWrapper object
  * @may_lock: TRUE if this funct must lock the caller untill a result is available
  * @exp_id: ID of the job for which a result is expected
@@ -786,7 +786,7 @@ gda_thread_wrapper_iterate (GdaThreadWrapper *wrapper, gboolean may_block)
  * Use this method to check if the execution of a function is finished. The function's execution must have
  * been requested using gda_thread_wrapper_execute().
  *
- * Returns: the pointer returned by the execution, or %NULL if no result is available
+ * Returns: (transfer none) (allow-none): the pointer returned by the execution, or %NULL if no result is available
  *
  * Since: 4.2
  */
@@ -993,7 +993,7 @@ worker_thread_closure_marshal_anythread (GClosure *closure,
 }
 
 /**
- * gda_thread_wrapper_connect_raw
+ * gda_thread_wrapper_connect_raw:
  * @wrapper: a #GdaThreadWrapper object
  * @instance: the instance to connect to
  * @sig_name: a string of the form "signal-name::detail"
@@ -1006,8 +1006,8 @@ worker_thread_closure_marshal_anythread (GClosure *closure,
  *    been emitted when a job created for the calling thread is being executed, and to %FALSE
  *    if @callback has to be called whenever the @sig_name signal is emitted by @instance. Note that
  *    this argument is not taken into account if @private_thread is set to %FALSE.
- * @callback: a #GdaThreadWrapperCallback function
- * @data: data to pass to @callback's calls
+ * @callback: (scope call): a #GdaThreadWrapperCallback function
+ * @data: (closure): data to pass to @callback's calls
  *
  * Connects a callback function to a signal for a particular object. The difference with g_signal_connect() and
  * similar functions are:



[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]