[libgda/LIBGDA_4.0] More GObject introspection annotations



commit eba242387714736928a079cca023664e082265f4
Author: Vivien Malerba <malerba gnome-db org>
Date:   Fri Jun 11 22:39:51 2010 +0200

    More GObject introspection annotations

 libgda/gda-data-model-dir.c    |   10 +++---
 libgda/gda-data-model-import.c |   24 ++++++------
 libgda/gda-data-model-iter.c   |   36 +++++++++---------
 libgda/gda-data-proxy.c        |   74 +++++++++++++++++++-------------------
 libgda/gda-data-select.c       |   32 ++++++++--------
 libgda/gda-easy.c              |   44 ++++++++++++------------
 libgda/gda-holder.c            |   75 +++++++++++++++++++--------------------
 libgda/gda-lockable.c          |    8 ++--
 libgda/gda-log.c               |   12 +++---
 9 files changed, 157 insertions(+), 158 deletions(-)
---
diff --git a/libgda/gda-data-model-dir.c b/libgda/gda-data-model-dir.c
index 2c80cc3..fd24281 100644
--- a/libgda/gda-data-model-dir.c
+++ b/libgda/gda-data-model-dir.c
@@ -1,5 +1,5 @@
 /* GDA common library
- * Copyright (C) 2007 - 2009 The GNOME Foundation
+ * Copyright (C) 2007 - 2010 The GNOME Foundation
  *
  * AUTHORS:
  *      Vivien Malerba <malerba gnome-db org>
@@ -670,7 +670,7 @@ gda_data_model_dir_get_property (GObject *object,
 }
 
 /**
- * gda_data_model_dir_new
+ * gda_data_model_dir_new:
  * @basedir: a directory
  *
  * Creates a new #GdaDataModel object to list all the files starting from @basedir
@@ -690,12 +690,12 @@ gda_data_model_dir_new (const gchar *basedir)
 }
 
 /**
- * gda_data_model_dir_get_errors
+ * gda_data_model_dir_get_errors:
  * @model: a #GdaDataModelDir object
  *
  * Get the list of errors which have occurred while using @model
  *
- * Returns: a read-only list of #GError pointers, or %NULL if no error has occurred
+ * Returns: (transfer none) (element-type GObject.Error) : a read-only list of #GError pointers, or %NULL if no error has occurred
  */
 const GSList *
 gda_data_model_dir_get_errors (GdaDataModelDir *model)
@@ -707,7 +707,7 @@ gda_data_model_dir_get_errors (GdaDataModelDir *model)
 }
 
 /**
- * gda_data_model_dir_clean_errors
+ * gda_data_model_dir_clean_errors:
  * @model: a #GdaDataModelDir object
  *
  * Reset the list of errors which have occurred while using @model
diff --git a/libgda/gda-data-model-import.c b/libgda/gda-data-model-import.c
index 89a5dc0..13f8390 100644
--- a/libgda/gda-data-model-import.c
+++ b/libgda/gda-data-model-import.c
@@ -1,5 +1,5 @@
 /* GDA library
- * Copyright (C) 2006 - 2008 The GNOME Foundation.
+ * Copyright (C) 2006 - 2010 The GNOME Foundation.
  *
  * AUTHORS:
  *      Vivien Malerba <malerba gnome-db org>
@@ -174,7 +174,7 @@ static void         add_error (GdaDataModelImport *model, const gchar *err);
 static GObjectClass *parent_class = NULL;
 
 /**
- * gda_data_model_import_get_type
+ * gda_data_model_import_get_type:
  *
  * Returns: the #GType of GdaDataModelImport.
  */
@@ -667,10 +667,10 @@ gda_data_model_import_get_property (GObject *object,
 }
 
 /**
- * gda_data_model_import_new_file
+ * gda_data_model_import_new_file:
  * @filename: the file to import data from
  * @random_access: TRUE if random access will be required
- * @options: list of importing options
+ * @options: (transfer none) (allow-none): importing options
  *
  * Creates a new #GdaDataModel object which contains the data stored within the @filename file.
  *
@@ -706,10 +706,10 @@ gda_data_model_import_new_file   (const gchar *filename, gboolean random_access,
 }
 
 /**
- * gda_data_model_import_new_mem
- * @data: a string containng the data to import
+ * gda_data_model_import_new_mem:
+ * @data: a string containing the data to import
  * @random_access: TRUE if random access will be required
- * @options: list of importing options, see gda_data_model_import_new_file() for more information
+ * @options: (transfer none) (allow-none): importing options, see gda_data_model_import_new_file() for more information
  *
  * Creates a new #GdaDataModel object which contains the data stored in the @data string. 
  *
@@ -732,8 +732,8 @@ gda_data_model_import_new_mem (const gchar *data, gboolean random_access, GdaSet
 }
 
 /**
- * gda_data_model_import_new_xml_node
- * @node: an XML node corresponding to a &lt;data-array&gt; tag
+ * gda_data_model_import_new_xml_node:
+ * @node: (transfer none): an XML node corresponding to a &lt;data-array&gt; tag
  *
  * Creates a new #GdaDataModel and loads the data in @node. The resulting data model
  * can be accessed in a random way.
@@ -1586,13 +1586,13 @@ add_error (GdaDataModelImport *model, const gchar *err)
 }
 
 /**
- * gda_data_model_import_get_errors
+ * gda_data_model_import_get_errors:
  * @model: a #GdaDataModelImport object
  *
  * Get the list of errors which @model has to report. The returned list is a list of
  * #GError structures, and must not be modified
  *
- * Returns: the list of errors (which must not be modified), or %NULL
+ * Returns: (transfer none) (element-type GObject.Error): the list of errors (which must not be modified), or %NULL
  */
 GSList *
 gda_data_model_import_get_errors (GdaDataModelImport *model)
@@ -1604,7 +1604,7 @@ gda_data_model_import_get_errors (GdaDataModelImport *model)
 }
 
 /**
- * gda_data_model_import_clean_errors
+ * gda_data_model_import_clean_errors:
  * @model: a #GdaDataModelImport object
  *
  * Clears the history of errors @model has to report
diff --git a/libgda/gda-data-model-iter.c b/libgda/gda-data-model-iter.c
index 9af1a68..a8b535a 100644
--- a/libgda/gda-data-model-iter.c
+++ b/libgda/gda-data-model-iter.c
@@ -1,6 +1,6 @@
 /* gda-data-model-iter.c
  *
- * Copyright (C) 2005 - 2008 Vivien Malerba
+ * Copyright (C) 2005 - 2010 Vivien Malerba
  *
  * This Library is free software; you can redistribute it and/or
  * modify it under the terms of the GNU Library General Public License as
@@ -562,7 +562,7 @@ gda_data_model_iter_get_property (GObject *object,
 }
 
 /**
- * gda_data_model_iter_move_to_row
+ * gda_data_model_iter_move_to_row:
  * @iter: a #GdaDataModelIter object
  * @row: the row to set @iter to
  *
@@ -636,7 +636,7 @@ set_param_attributes (GdaHolder *holder, GdaValueAttribute flags)
 }
 
 /**
- * gda_data_model_iter_move_to_row_default
+ * gda_data_model_iter_move_to_row_default: (skip)
  */
 gboolean
 gda_data_model_iter_move_to_row_default (GdaDataModel *model, GdaDataModelIter *iter, gint row)
@@ -687,7 +687,7 @@ gda_data_model_iter_move_to_row_default (GdaDataModel *model, GdaDataModelIter *
 
 
 /**
- * gda_data_model_iter_move_next
+ * gda_data_model_iter_move_next:
  * @iter: a #GdaDataModelIter object
  *
  * Moves @iter one row further than where it already is 
@@ -723,7 +723,7 @@ gda_data_model_iter_move_next (GdaDataModelIter *iter)
 }
 
 /**
- * gda_data_model_iter_move_next_default
+ * gda_data_model_iter_move_next_default: (skip)
  */
 gboolean
 gda_data_model_iter_move_next_default (GdaDataModel *model, GdaDataModelIter *iter)
@@ -774,7 +774,7 @@ gda_data_model_iter_move_next_default (GdaDataModel *model, GdaDataModelIter *it
 }
 
 /**
- * gda_data_model_iter_move_prev
+ * gda_data_model_iter_move_prev:
  * @iter: a #GdaDataModelIter object
  *
  * Moves @iter one row before where it already is (synchronizes the values of the parameters in @iter 
@@ -811,7 +811,7 @@ gda_data_model_iter_move_prev (GdaDataModelIter *iter)
 }
 
 /**
- * gda_data_model_iter_move_prev_default
+ * gda_data_model_iter_move_prev_default: (skip)
  */
 gboolean
 gda_data_model_iter_move_prev_default (GdaDataModel *model, GdaDataModelIter *iter)
@@ -863,7 +863,7 @@ gda_data_model_iter_move_prev_default (GdaDataModel *model, GdaDataModelIter *it
 
 
 /**
- * gda_data_model_iter_get_row
+ * gda_data_model_iter_get_row:
  * @iter: a #GdaDataModelIter object
  *
  * Get the row which @iter represents in the data model
@@ -880,7 +880,7 @@ gda_data_model_iter_get_row (GdaDataModelIter *iter)
 }
 
 /**
- * gda_data_model_iter_invalidate_contents
+ * gda_data_model_iter_invalidate_contents:
  * @iter: a #GdaDataModelIter object
  *
  * Declare all the parameters in @iter invalid, without modifying the
@@ -901,7 +901,7 @@ gda_data_model_iter_invalidate_contents (GdaDataModelIter *iter)
 }
 
 /**
- * gda_data_model_iter_is_valid
+ * gda_data_model_iter_is_valid:
  * @iter: a #GdaDataModelIter object
  *
  * Tells if @iter is a valid iterator (if it actually corresponds to a valid row in the model)
@@ -918,7 +918,7 @@ gda_data_model_iter_is_valid (GdaDataModelIter *iter)
 }
 
 /**
- * gda_data_model_iter_get_column_for_param
+ * gda_data_model_iter_get_column_for_param:
  * @iter: a #GdaDataModelIter object
  * @param: a #GdaHolder object, listed in @iter
  *
@@ -939,14 +939,14 @@ gda_data_model_iter_get_column_for_param (GdaDataModelIter *iter, GdaHolder *par
 }
 
 /**
- * gda_data_model_iter_get_holder_for_field
+ * gda_data_model_iter_get_holder_for_field:
  * @iter: a #GdaDataModelIter object
  * @col: the requested column
  *
  * Fetch a pointer to the #GdaHolder object which is synchronized with data at 
  * column @col
  *
- * Returns: the #GdaHolder, or %NULL if an error occurred
+ * Returns: (transfer none): the #GdaHolder, or %NULL if an error occurred
  */
 GdaHolder *
 gda_data_model_iter_get_holder_for_field (GdaDataModelIter *iter, gint col)
@@ -958,13 +958,13 @@ gda_data_model_iter_get_holder_for_field (GdaDataModelIter *iter, gint col)
 }
 
 /**
- * gda_data_model_iter_get_value_at
+ * gda_data_model_iter_get_value_at:
  * @iter: a #GdaDataModelIter object
  * @col: the requested column
  *
  * Get the value stored at the column @col in @iter. The returned value must not be modified.
  *
- * Returns: the #GValue, or %NULL if the value could not be fetched
+ * Returns: (transfer none): the #GValue, or %NULL if the value could not be fetched
  */
 const GValue *
 gda_data_model_iter_get_value_at (GdaDataModelIter *iter, gint col)
@@ -982,7 +982,7 @@ gda_data_model_iter_get_value_at (GdaDataModelIter *iter, gint col)
 }
 
 /**
- * gda_data_model_iter_set_value_at
+ * gda_data_model_iter_set_value_at:
  * @iter: a #GdaDataModelIter object
  * @col: the column number
  * @value: a #GValue (not %NULL)
@@ -1012,13 +1012,13 @@ gda_data_model_iter_set_value_at (GdaDataModelIter *iter, gint col, const GValue
 }
 
 /**
- * gda_data_model_iter_get_value_for_field
+ * gda_data_model_iter_get_value_for_field:
  * @iter: a #GdaDataModelIter object
  * @field_name: the requested column name
  *
  * Get the value stored at the column @field_name in @iter
  *
- * Returns: the #GValue, or %NULL
+ * Returns: (transfer none): the #GValue, or %NULL
  */
 const GValue *
 gda_data_model_iter_get_value_for_field (GdaDataModelIter *iter, const gchar *field_name)
diff --git a/libgda/gda-data-proxy.c b/libgda/gda-data-proxy.c
index f10156b..9a715ff 100644
--- a/libgda/gda-data-proxy.c
+++ b/libgda/gda-data-proxy.c
@@ -1,6 +1,6 @@
 /* gda-data-proxy.c
  *
- * Copyright (C) 2005 - 2009 Vivien Malerba
+ * Copyright (C) 2005 - 2010 Vivien Malerba
  *
  * This Library is free software; you can redistribute it and/or
  * modify it under the terms of the GNU Library General Public License as
@@ -752,8 +752,8 @@ static void proxied_model_reset_cb (GdaDataModel *model, GdaDataProxy *proxy);
 
 
 /**
- * gda_data_proxy_new
- * @model: Data model to be proxied
+ * gda_data_proxy_new:
+ * @model: (transfer none): Data model to be proxied
  *
  * Creates a new proxy for @model
  *
@@ -1193,12 +1193,12 @@ proxied_model_reset_cb (GdaDataModel *model, GdaDataProxy *proxy)
 }
 
 /**
- * gda_data_proxy_get_proxied_model
+ * gda_data_proxy_get_proxied_model:
  * @proxy: a #GdaDataProxy object
  *
  * Fetch the #GdaDataModel which @proxy does proxy
  *
- * Returns: the proxied data model
+ * Returns: (transfer none): the proxied data model
  */
 GdaDataModel *
 gda_data_proxy_get_proxied_model (GdaDataProxy *proxy)
@@ -1210,7 +1210,7 @@ gda_data_proxy_get_proxied_model (GdaDataProxy *proxy)
 }
 
 /**
- * gda_data_proxy_get_proxied_model_n_cols
+ * gda_data_proxy_get_proxied_model_n_cols:
  * @proxy: a #GdaDataProxy object
  * 
  * Get the number of columns in the proxied data model
@@ -1227,7 +1227,7 @@ gda_data_proxy_get_proxied_model_n_cols (GdaDataProxy *proxy)
 }
 
 /**
- * gda_data_proxy_get_proxied_model_n_rows
+ * gda_data_proxy_get_proxied_model_n_rows:
  * @proxy: a #GdaDataProxy object
  * 
  * Get the number of rows in the proxied data model
@@ -1244,7 +1244,7 @@ gda_data_proxy_get_proxied_model_n_rows (GdaDataProxy *proxy)
 }
 
 /**
- * gda_data_proxy_is_read_only
+ * gda_data_proxy_is_read_only:
  * @proxy: a #GdaDataProxy object
  *
  * Returns: TRUE if the proxied data model is itself read-only
@@ -1304,17 +1304,17 @@ find_or_create_row_modif (GdaDataProxy *proxy, gint proxy_row, gint col, RowValu
 
 
 /**
- * gda_data_proxy_get_values
+ * gda_data_proxy_get_values:
  * @proxy: a #GdaDataProxy object
  * @proxy_row: a proxy row
- * @cols_index: array containing the columns for which the values are requested
+ * @cols_index: (array) (array length=n_cols): array containing the columns for which the values are requested
  * @n_cols: size of @cols_index
  *
  * Retreive a whole list of values from the @proxy data model. This function 
  * calls gda_data_proxy_get_value()
  * for each column index specified in @cols_index, and generates a #GSList on the way.
  *
- * Returns: a new list of values (the list must be freed, not the values), 
+ * Returns: (element-type GValue) (transfer container): a new list of values (the list must be freed, not the values), 
  * or %NULL if an error occurred
  */
 GSList *
@@ -1345,7 +1345,7 @@ gda_data_proxy_get_values (GdaDataProxy *proxy, gint proxy_row, gint *cols_index
 }
 
 /**
- * gda_data_proxy_get_value_attributes
+ * gda_data_proxy_get_value_attributes:
  * @proxy: a #GdaDataProxy object
  * @proxy_row: a proxy row
  * @col: a valid proxy column
@@ -1353,7 +1353,7 @@ gda_data_proxy_get_values (GdaDataProxy *proxy, gint proxy_row, gint *cols_index
  * Get the attributes of the value stored at (proxy_row, col) in @proxy, which
  * is an ORed value of #GdaValueAttribute flags
  *
- * Returns: the attribute
+ * Returns: (transfer none): the attribute
  */
 GdaValueAttribute
 gda_data_proxy_get_value_attributes (GdaDataProxy *proxy, gint proxy_row, gint col)
@@ -1417,11 +1417,11 @@ gda_data_proxy_get_value_attributes (GdaDataProxy *proxy, gint proxy_row, gint c
 }
 
 /**
- * gda_data_proxy_alter_value_attributes
+ * gda_data_proxy_alter_value_attributes:
  * @proxy: a #GdaDataProxy object
  * @proxy_row: A proxy row number
  * @col: a valid column number
- * @alter_flags: flags to alter the attributes
+ * @alter_flags: (transfer none): flags to alter the attributes
  *
  * Alters the attributes of the value stored at (proxy_row, col) in @proxy. the @alter_flags
  * can only contain the GDA_VALUE_ATTR_IS_NULL, GDA_VALUE_ATTR_IS_DEFAULT and GDA_VALUE_ATTR_IS_UNCHANGED
@@ -1496,7 +1496,7 @@ gda_data_proxy_alter_value_attributes (GdaDataProxy *proxy, gint proxy_row, gint
 }
 
 /**
- * gda_data_proxy_get_proxied_model_row
+ * gda_data_proxy_get_proxied_model_row:
  * @proxy: a #GdaDataProxy object
  * @proxy_row: A proxy row number
  *
@@ -1515,7 +1515,7 @@ gda_data_proxy_get_proxied_model_row (GdaDataProxy *proxy, gint proxy_row)
 }
 
 /**
- * gda_data_proxy_delete
+ * gda_data_proxy_delete:
  * @proxy: a #GdaDataProxy object
  * @proxy_row: A proxy row number
  *
@@ -1600,7 +1600,7 @@ gda_data_proxy_delete (GdaDataProxy *proxy, gint proxy_row)
 }
 
 /**
- * gda_data_proxy_undelete
+ * gda_data_proxy_undelete:
  * @proxy: a #GdaDataProxy object
  * @proxy_row: A proxy row number
  *
@@ -1649,7 +1649,7 @@ gda_data_proxy_undelete (GdaDataProxy *proxy, gint proxy_row)
 }
 
 /**
- * gda_data_proxy_row_is_deleted
+ * gda_data_proxy_row_is_deleted:
  * @proxy: a #GdaDataProxy object
  * @proxy_row: A proxy row number
  *
@@ -1671,7 +1671,7 @@ gda_data_proxy_row_is_deleted (GdaDataProxy *proxy, gint proxy_row)
 }
 
 /**
- * gda_data_proxy_row_is_inserted
+ * gda_data_proxy_row_is_inserted:
  * @proxy: a #GdaDataProxy object
  * @proxy_row: A proxy row number
  *
@@ -1791,7 +1791,7 @@ gda_data_proxy_append (GdaDataProxy *proxy)
 }
 
 /**
- * gda_data_proxy_cancel_row_changes
+ * gda_data_proxy_cancel_row_changes:
  * @proxy: a #GdaDataProxy object
  * @proxy_row: the row to cancel changes
  * @col: the column to cancel changes, or less than 0 to cancel any change on the @row row
@@ -1884,7 +1884,7 @@ gda_data_proxy_cancel_row_changes (GdaDataProxy *proxy, gint proxy_row, gint col
 static gboolean commit_row_modif (GdaDataProxy *proxy, RowModif *rm, gboolean adjust_display, GError **error);
 
 /**
- * gda_data_proxy_apply_row_changes
+ * gda_data_proxy_apply_row_changes:
  * @proxy: a #GdaDataProxy object
  * @proxy_row: the row number to commit
  * @error: place to store the error, or %NULL
@@ -2104,7 +2104,7 @@ commit_row_modif (GdaDataProxy *proxy, RowModif *rm, gboolean adjust_display, GE
 }
 
 /**
- * gda_data_proxy_has_changed
+ * gda_data_proxy_has_changed:
  * @proxy: a #GdaDataProxy object
  *
  * Tells if @proxy contains any modifications not applied to the proxied data model.
@@ -2121,7 +2121,7 @@ gda_data_proxy_has_changed (GdaDataProxy *proxy)
 }
 
 /**
- * gda_data_proxy_row_has_changed
+ * gda_data_proxy_row_has_changed:
  * @proxy: a #GdaDataProxy object
  * @proxy_row: A proxy row number
  *
@@ -2143,7 +2143,7 @@ gda_data_proxy_row_has_changed (GdaDataProxy *proxy, gint proxy_row)
 }
 
 /**
- * gda_data_proxy_get_n_new_rows
+ * gda_data_proxy_get_n_new_rows:
  * @proxy: a #GdaDataProxy object
  *
  * Get the number of rows which have been added to @proxy and which are not part of
@@ -2161,7 +2161,7 @@ gda_data_proxy_get_n_new_rows (GdaDataProxy *proxy)
 }
 
 /**
- * gda_data_proxy_get_n_modified_rows
+ * gda_data_proxy_get_n_modified_rows:
  * @proxy: a #GdaDataProxy object
  *
  * Get the number of rows which have been modified in the proxy (the sum of rows existing in
@@ -2179,7 +2179,7 @@ gda_data_proxy_get_n_modified_rows (GdaDataProxy *proxy)
 }
 
 /**
- * gda_data_proxy_set_sample_size
+ * gda_data_proxy_set_sample_size:
  * @proxy: a #GdaDataProxy object
  * @sample_size: the requested size of a chunk, or 0
  *
@@ -2219,7 +2219,7 @@ gda_data_proxy_set_sample_size (GdaDataProxy *proxy, gint sample_size)
 }
 
 /**
- * gda_data_proxy_get_sample_size
+ * gda_data_proxy_get_sample_size:
  * @proxy: a #GdaDataProxy object
  *
  * Get the size of each chunk of data displayed at a time.
@@ -2236,7 +2236,7 @@ gda_data_proxy_get_sample_size (GdaDataProxy *proxy)
 }
 
 /**
- * gda_data_proxy_set_sample_start
+ * gda_data_proxy_set_sample_start:
  * @proxy: a #GdaDataProxy object
  * @sample_start: the number of the first row to be displayed
  *
@@ -2263,7 +2263,7 @@ gda_data_proxy_set_sample_start (GdaDataProxy *proxy, gint sample_start)
 }
 
 /**
- * gda_data_proxy_get_sample_start
+ * gda_data_proxy_get_sample_start:
  * @proxy: a #GdaDataProxy object
  *
  * Get the number of the first row to be available in @proxy (in reference to the proxied data model)
@@ -2280,7 +2280,7 @@ gda_data_proxy_get_sample_start (GdaDataProxy *proxy)
 }
 
 /**
- * gda_data_proxy_get_sample_end
+ * gda_data_proxy_get_sample_end:
  * @proxy: a #GdaDataProxy object
  *
  * Get the number of the last row to be available in @proxy (in reference to the proxied data model)
@@ -2736,7 +2736,7 @@ adjust_displayed_chunk (GdaDataProxy *proxy)
 }
 
 /**
- * gda_data_proxy_apply_all_changes
+ * gda_data_proxy_apply_all_changes:
  * @proxy: a #GdaDataProxy object
  * @error: a place to store errors, or %NULL
  *
@@ -2773,7 +2773,7 @@ gda_data_proxy_apply_all_changes (GdaDataProxy *proxy, GError **error)
 }
 
 /**
- * gda_data_proxy_cancel_all_changes
+ * gda_data_proxy_cancel_all_changes:
  * @proxy: a #GdaDataProxy object
  *
  * Cancel all the changes stored in the proxy (the @proxy will be reset to its state
@@ -3032,7 +3032,7 @@ apply_filter_statement (GdaDataProxy *proxy, GError **error)
 }
 
 /**
- * gda_data_proxy_set_filter_expr
+ * gda_data_proxy_set_filter_expr:
  * @proxy: a #GdaDataProxy object
  * @filter_expr: an SQL based expression which will filter the contents of @proxy, or %NULL to remove any previous filter
  * @error: a place to store errors, or %NULL
@@ -3117,7 +3117,7 @@ gda_data_proxy_set_filter_expr (GdaDataProxy *proxy, const gchar *filter_expr, G
 }
 
 /**
- * gda_data_proxy_set_ordering_column
+ * gda_data_proxy_set_ordering_column:
  * @proxy: a #GdaDataProxy object
  * @col: the column number to order from
  * @error: a place to store errors, or %NULL
@@ -3208,7 +3208,7 @@ gda_data_proxy_set_ordering_column (GdaDataProxy *proxy, gint col, GError **erro
 }
 
 /**
- * gda_data_proxy_get_filter_expr
+ * gda_data_proxy_get_filter_expr:
  * @proxy: a #GdaDataProxy object
  *
  * Get the current filter expression used by @proxy.
@@ -3225,7 +3225,7 @@ gda_data_proxy_get_filter_expr (GdaDataProxy *proxy)
 }
 
 /**
- * gda_data_proxy_get_filtered_n_rows
+ * gda_data_proxy_get_filtered_n_rows:
  * @proxy: a #GdaDataProxy object
  *
  * Get the total number of filtered rows in @proxy if a filter has been applied. As new rows
diff --git a/libgda/gda-data-select.c b/libgda/gda-data-select.c
index 491e9d2..68dd7da 100644
--- a/libgda/gda-data-select.c
+++ b/libgda/gda-data-select.c
@@ -1,5 +1,5 @@
 /* GDA library
- * Copyright (C) 2008 - 2009 The GNOME Foundation.
+ * Copyright (C) 2008 - 2010 The GNOME Foundation.
  *
  * AUTHORS:
  *      Vivien Malerba <malerba gnome-db org>
@@ -169,7 +169,7 @@ static gboolean             gda_data_select_get_notify      (GdaDataModel *model
 static GObjectClass *parent_class = NULL;
 
 /**
- * gda_data_select_get_type
+ * gda_data_select_get_type:
  *
  * Returns: the #GType of GdaDataSelect.
  */
@@ -778,9 +778,9 @@ gda_data_select_get_property (GObject *object,
 }
 
 /**
- * gda_data_select_take_row
+ * gda_data_select_take_row:
  * @model: a #GdaDataSelect data model
- * @row: a #GdaRow row
+ * @row: (transfer full): a #GdaRow row
  * @rownum: "external" advertized row number
  *
  * Stores @row into @model, externally advertized at row number @rownum (if no row has been removed). 
@@ -802,13 +802,13 @@ gda_data_select_take_row (GdaDataSelect *model, GdaRow *row, gint rownum)
 }
 
 /**
- * gda_data_select_get_stored_row
+ * gda_data_select_get_stored_row:
  * @model: a #GdaDataSelect data model
  * @rownum: "external" advertized row number
  *
  * Get the #GdaRow object stored within @model at row @rownum (without taking care of removed rows)
  *
- * Returns: the requested #GdaRow, or %NULL if not found
+ * Returns: (tranfer none): the requested #GdaRow, or %NULL if not found
  */
 GdaRow *
 gda_data_select_get_stored_row (GdaDataSelect *model, gint rownum)
@@ -825,13 +825,13 @@ gda_data_select_get_stored_row (GdaDataSelect *model, gint rownum)
 }
 
 /**
- * gda_data_select_get_connection
+ * gda_data_select_get_connection:
  * @model: a #GdaDataSelect data model
  *
  * Get a pointer to the #GdaConnection object which was used when @model was created
  * (and which may be used internally by @model).
  *
- * Returns: a pointer to the #GdaConnection, or %NULL
+ * Returns: (tranfer none): a pointer to the #GdaConnection, or %NULL
  */
 GdaConnection *
 gda_data_select_get_connection (GdaDataSelect *model)
@@ -914,7 +914,7 @@ param_name_to_int (const gchar *pname, gint *result, gboolean *old_val)
 }
 
 /**
- * gda_data_select_set_modification_statement_sql
+ * gda_data_select_set_modification_statement_sql:
  * @model: a #GdaDataSelect data model
  * @sql: an SQL text
  * @error: a place to store errors, or %NULL
@@ -996,7 +996,7 @@ check_acceptable_statement (GdaDataSelect *model, GError **error)
 }
 
 /**
- * gda_data_select_set_modification_statement
+ * gda_data_select_set_modification_statement:
  * @model: a #GdaDataSelect data model
  * @mod_stmt: a #GdaStatement (INSERT, UPDATE or DELETE)
  * @error: a place to store errors, or %NULL
@@ -1233,7 +1233,7 @@ gda_data_select_set_modification_statement (GdaDataSelect *model, GdaStatement *
 }
 
 /**
- * gda_data_select_compute_modification_statements
+ * gda_data_select_compute_modification_statements:
  * @model: a #GdaDataSelect data model
  * @error: a place to store errors, or %NULL
  *
@@ -1313,9 +1313,9 @@ row_selection_condition_foreach_func (GdaSqlAnyPart *part, gpointer data, GError
 }
 
 /**
- * gda_data_select_set_row_selection_condition
+ * gda_data_select_set_row_selection_condition:
  * @model: a #GdaDataSelect data model
- * @expr: a #GdaSqlExpr expression
+ * @expr: (transfer none): a #GdaSqlExpr expression
  * @error: a place to store errors, or %NULL
  *
  * Offers the same features as gda_data_select_set_row_selection_condition_sql() but using a #GdaSqlExpr
@@ -1352,7 +1352,7 @@ gda_data_select_set_row_selection_condition  (GdaDataSelect *model, GdaSqlExpr *
 }
 
 /**
- * gda_data_select_set_row_selection_condition_sql
+ * gda_data_select_set_row_selection_condition_sql:
  * @model: a #GdaDataSelect data model
  * @sql_where: an SQL condition (withouth the WHERE keyword)
  * @error: a place to store errors, or %NULL
@@ -1428,7 +1428,7 @@ gda_data_select_set_row_selection_condition_sql (GdaDataSelect *model, const gch
 }
 
 /**
- * gda_data_select_compute_row_selection_condition
+ * gda_data_select_compute_row_selection_condition:
  * @model: a #GdaDataSelect object
  * @error: a place to store errors, or %NULL
  *
@@ -3241,7 +3241,7 @@ set_column_properties_from_select_stmt (GdaDataSelect *model, GdaConnection *cnc
 
 
 /**
- * gda_data_select_compute_columns_attributes
+ * gda_data_select_compute_columns_attributes:
  * @model: a #GdaDataSelect data model
  * @error: a place to store errors, or %NULL
  *
diff --git a/libgda/gda-easy.c b/libgda/gda-easy.c
index c186988..7bd6502 100644
--- a/libgda/gda-easy.c
+++ b/libgda/gda-easy.c
@@ -1,5 +1,5 @@
 /* GDA Library
- * Copyright (C) 2008 The GNOME Foundation.
+ * Copyright (C) 2008 - 2010 The GNOME Foundation.
  *
  * This Library is free software; you can redistribute it and/or
  * modify it under the terms of the GNU Library General Public License as
@@ -40,7 +40,7 @@ GQuark gda_easy_error_quark (void)
 }
 
 /**
- * gda_prepare_create_database
+ * gda_prepare_create_database:
  * @provider: the database provider to use
  * @db_name: the name of the database to create, or %NULL
  * @error: a place to store errors, or %NULL
@@ -79,7 +79,7 @@ gda_prepare_create_database (const gchar *provider, const gchar *db_name, GError
 }
 
 /**
- * gda_perform_create_database
+ * gda_perform_create_database:
  * @provider: the database provider to use, or %NULL if @op has been created using gda_prepare_create_database()
  * @op: a #GdaServerOperation object obtained using gda_prepare_create_database()
  * @error: a place to store en error, or %NULL
@@ -109,7 +109,7 @@ gda_perform_create_database (const gchar *provider, GdaServerOperation *op, GErr
 }
 
 /**
- * gda_prepare_drop_database
+ * gda_prepare_drop_database:
  * @provider: the database provider to use
  * @db_name: the name of the database to drop, or %NULL
  * @error: a place to store errors, or %NULL
@@ -148,7 +148,7 @@ gda_prepare_drop_database (const gchar *provider, const gchar *db_name, GError *
 }
 
 /**
- * gda_perform_drop_database
+ * gda_perform_drop_database:
  * @provider: the database provider to use, or %NULL if @op has been created using gda_prepare_drop_database()
  * @op: a #GdaServerOperation object obtained using gda_prepare_drop_database()
  * @error: a place to store en error, or %NULL
@@ -178,7 +178,7 @@ gda_perform_drop_database (const gchar *provider, GdaServerOperation *op, GError
 }
 
 /**
- * gda_execute_select_command
+ * gda_execute_select_command:
  * @cnc: an opened connection
  * @sql: a query statament must begin with "SELECT"
  * @error: a place to store errors, or %NULL
@@ -214,7 +214,7 @@ gda_execute_select_command (GdaConnection *cnc, const gchar *sql, GError **error
 }
 
 /**
- * gda_execute_sql_command
+ * gda_execute_sql_command:
  * @cnc: an opened connection
  * @sql: a query statament must begin with "SELECT"
  * @error: a place to store errors, or %NULL
@@ -248,7 +248,7 @@ gda_execute_non_select_command (GdaConnection *cnc, const gchar *sql, GError **e
 }
 
 /**
- * gda_prepare_create_table
+ * gda_prepare_create_table:
  * @cnc: an opened connection
  * @table_name: name of the table to create
  * @error: a place to store errors, or %NULL
@@ -392,7 +392,7 @@ gda_prepare_create_table (GdaConnection *cnc, const gchar *table_name, GError **
 }
 
 /**
- * gda_perform_create_table
+ * gda_perform_create_table:
  * @op: a valid #GdaServerOperation
  * @error: a place to store errors, or %NULL
  * 
@@ -421,7 +421,7 @@ gda_perform_create_table (GdaServerOperation *op, GError **error)
 }
 
 /**
- * gda_prepare_drop_table
+ * gda_prepare_drop_table:
  * @cnc: an opened connection
  * @table_name: name of the table to drop
  * @error: a place to store errors, or %NULL
@@ -460,7 +460,7 @@ gda_prepare_drop_table (GdaConnection *cnc, const gchar *table_name, GError **er
 }
 
 /**
- * gda_perform_drop_table
+ * gda_perform_drop_table:
  * @op: a #GdaServerOperation object
  * @error: a place to store errors, or %NULL
  * 
@@ -499,7 +499,7 @@ gtype_equal (gconstpointer a, gconstpointer b)
 }
 
 /**
- * gda_get_default_handler
+ * gda_get_default_handler:
  * @for_type: a #GType type
  * 
  * Obtain a pointer to a #GdaDataHandler which can manage #GValue values of type @for_type. The returned
@@ -508,7 +508,7 @@ gtype_equal (gconstpointer a, gconstpointer b)
  *
  * The returned pointer is %NULL if there is no default data handler available for the @for_type data type
  *
- * Returns: a #GdaDataHandler which must not be modified or destroyed.
+ * Returns: (transfer none): a #GdaDataHandler which must not be modified or destroyed.
  */
 GdaDataHandler *
 gda_get_default_handler (GType for_type)
@@ -551,7 +551,7 @@ gda_get_default_handler (GType for_type)
 }
 
 /**
- * gda_insert_row_into_table
+ * gda_insert_row_into_table:
  * @cnc: an opened connection
  * @table: table's name to insert into
  * @error: a place to store errors, or %NULL
@@ -603,11 +603,11 @@ gda_insert_row_into_table (GdaConnection *cnc, const gchar *table, GError **erro
 }
 
 /**
- * gda_insert_row_into_table_v
+ * gda_insert_row_into_table_v:
  * @cnc: an opened connection
  * @table: table's name to insert into
- * @col_names: a list of column names (as const gchar *)
- * @values: a list of values (as #GValue)
+ * @col_names: (element-type utf8): a list of column names (as const gchar *)
+ * @values: (element-type GValue): a list of values (as #GValue)
  * @error: a place to store errors, or %NULL
  *
  * @col_names and @values must have length (&gt;= 1).
@@ -713,7 +713,7 @@ gda_insert_row_into_table_v (GdaConnection *cnc, const gchar *table,
 
 
 /**
- * gda_update_row_in_table
+ * gda_update_row_in_table:
  * @cnc: an opened connection
  * @table: the table's name with the row's values to be updated
  * @condition_column_name: the name of the column to used in the WHERE condition clause
@@ -769,13 +769,13 @@ gda_update_row_in_table (GdaConnection *cnc, const gchar *table,
 }
 
 /**
- * gda_update_row_in_table_v
+ * gda_update_row_in_table_v:
  * @cnc: an opened connection
  * @table: the table's name with the row's values to be updated
  * @condition_column_name: the name of the column to used in the WHERE condition clause
  * @condition_value: the @condition_column_type's GType
- * @col_names: a list of column names (as const gchar *)
- * @values: a list of values (as #GValue)
+ * @col_names: (element-type utf8): a list of column names (as const gchar *)
+ * @values: (element-type GValue): a list of values (as #GValue)
  * @error: a place to store errors, or %NULL
  *
  * @col_names and @values must have length (&gt;= 1).
@@ -917,7 +917,7 @@ gda_update_row_in_table_v (GdaConnection *cnc, const gchar *table,
 }
 
 /**
- * gda_delete_row_from_table
+ * gda_delete_row_from_table:
  * @cnc: an opened connection
  * @table: the table's name with the row's values to be updated
  * @condition_column_name: the name of the column to used in the WHERE condition clause
diff --git a/libgda/gda-holder.c b/libgda/gda-holder.c
index 5908fc7..8113f62 100644
--- a/libgda/gda-holder.c
+++ b/libgda/gda-holder.c
@@ -1,6 +1,6 @@
 /* gda-holder.c
  *
- * Copyright (C) 2003 - 2008 Vivien Malerba
+ * Copyright (C) 2003 - 2010 Vivien Malerba
  *
  * This Library is free software; you can redistribute it and/or
  * modify it under the terms of the GNU Library General Public License as
@@ -317,8 +317,8 @@ gda_holder_init (GdaHolder *holder)
 }
 
 /**
- * gda_holder_new
- * @type: the #GType requested
+ * gda_holder_new:
+ * @type: (transfer none): the #GType requested
  *
  * Creates a new holder of type @type
  *
@@ -331,7 +331,7 @@ gda_holder_new (GType type)
 }
 
 /**
- * gda_holder_copy
+ * gda_holder_copy:
  * @orig: a #GdaHolder object to copy
  *
  * Copy constructor.
@@ -397,7 +397,7 @@ gda_holder_copy (GdaHolder *orig)
 }
 
 /**
- * gda_holder_new_inline
+ * gda_holder_new_inline:
  * @type: a valid GLib type
  * @id: the id of the holder to create, or %NULL
  * @...: value to set
@@ -668,12 +668,12 @@ gda_holder_get_property (GObject *object,
 }
 
 /**
- * gda_holder_get_g_type
+ * gda_holder_get_g_type:
  * @holder: a #GdaHolder object
  * 
  * Get @holder's type
  *
- * Returns: the data type
+ * Returns: (tranfer none): the data type
  */
 GType
 gda_holder_get_g_type (GdaHolder *holder)
@@ -685,7 +685,7 @@ gda_holder_get_g_type (GdaHolder *holder)
 }
 
 /**
- * gda_holder_get_id
+ * gda_holder_get_id:
  * @holder: a #GdaHolder object
  *
  * Get the ID of @holder. The ID can be set using @holder's "id" property
@@ -703,7 +703,7 @@ gda_holder_get_id (GdaHolder *holder)
 
 
 /**
- * gda_holder_get_value
+ * gda_holder_get_value:
  * @holder: a #GdaHolder object
  *
  * Get the value held into the holder. If @holder is set to use its default value
@@ -738,14 +738,14 @@ gda_holder_get_value (GdaHolder *holder)
 }
 
 /**
- * gda_holder_get_value_str
+ * gda_holder_get_value_str:
  * @holder: a #GdaHolder object
- * @dh: a #GdaDataHandler to use, or %NULL
+ * @dh: (allow-none): a #GdaDataHandler to use, or %NULL
  *
  * Same functionality as gda_holder_get_value() except that it returns the value as a string
  * (the conversion is done using @dh if not %NULL, or the default data handler otherwise).
  *
- * Returns: the value, or %NULL
+ * Returns: (transfer full): the value, or %NULL
  */
 gchar *
 gda_holder_get_value_str (GdaHolder *holder, GdaDataHandler *dh)
@@ -771,9 +771,9 @@ gda_holder_get_value_str (GdaHolder *holder, GdaDataHandler *dh)
 static gboolean real_gda_holder_set_value (GdaHolder *holder, GValue *value, gboolean do_copy, GError **error);
 
 /**
- * gda_holder_set_value
+ * gda_holder_set_value:
  * @holder: a #GdaHolder object
- * @value: a value to set the holder to, or %NULL
+ * @value: (allow-none): a value to set the holder to, or %NULL
  * @error: a place to store errors, or %NULL
  *
  * Sets the value within the holder. If @holder is an alias for another
@@ -806,7 +806,7 @@ gda_holder_set_value (GdaHolder *holder, const GValue *value, GError **error)
 }
 
 /**
- * gda_holder_set_value_str
+ * gda_holder_set_value_str:
  * @holder: a #GdaHolder object
  * @dh: a #GdaDataHandler to use, or %NULL
  * @value: a value to set the holder to, as a string
@@ -851,9 +851,9 @@ gda_holder_set_value_str (GdaHolder *holder, GdaDataHandler *dh, const gchar *va
 }
 
 /**
- * gda_holder_take_value
+ * gda_holder_take_value:
  * @holder: a #GdaHolder object
- * @value: a value to set the holder to
+ * @value: (transfer full): a value to set the holder to
  * @error: a place to store errors, or %NULL
  *
  * Sets the value within the holder. If @holder is an alias for another
@@ -1156,7 +1156,7 @@ real_gda_holder_set_const_value (GdaHolder *holder, const GValue *value,
 }
 
 /**
- * gda_holder_take_static_value
+ * gda_holder_take_static_value:
  * @holder: a #GdaHolder object
  * @value: a const value to set the holder to
  * @value_changed: a boolean set with TRUE if the value changes, FALSE elsewhere.
@@ -1178,13 +1178,12 @@ real_gda_holder_set_const_value (GdaHolder *holder, const GValue *value,
  * of which can prevent the change from happening) which can be connected to to have a greater control
  * of which values @holder can have, or implement some business rules.
  *
- * Returns: NULL if an error occurred or if the previous GValue was NULL itself. It returns
+ * Returns: (transfer none): NULL if an error occurred or if the previous GValue was NULL itself. It returns
  * the static GValue user set previously, so that he can free it.
- *
  */
 GValue *
 gda_holder_take_static_value (GdaHolder *holder, const GValue *value, gboolean *value_changed,
-							  GError **error)
+			      GError **error)
 {
 	g_return_val_if_fail (GDA_IS_HOLDER (holder), FALSE);
 	g_return_val_if_fail (holder->priv, FALSE);
@@ -1193,7 +1192,7 @@ gda_holder_take_static_value (GdaHolder *holder, const GValue *value, gboolean *
 }
 
 /**
- * gda_holder_force_invalid
+ * gda_holder_force_invalid:
  * @holder: a #GdaHolder object
  *
  * Forces a holder to be invalid; to set it valid again, a new value must be assigned
@@ -1232,7 +1231,7 @@ gda_holder_force_invalid (GdaHolder *holder)
 
 
 /**
- * gda_holder_is_valid
+ * gda_holder_is_valid:
  * @holder: a #GdaHolder object
  *
  * Get the validity of @holder (that is, of the value held by @holder)
@@ -1259,7 +1258,7 @@ gda_holder_is_valid (GdaHolder *holder)
 }
 
 /**
- * gda_holder_set_value_to_default
+ * gda_holder_set_value_to_default:
  * @holder: a #GdaHolder object
  *
  * Set @holder's value to its default value.
@@ -1297,7 +1296,7 @@ gda_holder_set_value_to_default (GdaHolder *holder)
 }
 
 /**
- * gda_holder_value_is_default
+ * gda_holder_value_is_default:
  * @holder: a #GdaHolder object
  *
  * Tells if @holder's current value is the default one.
@@ -1315,7 +1314,7 @@ gda_holder_value_is_default (GdaHolder *holder)
 
 
 /**
- * gda_holder_get_default_value
+ * gda_holder_get_default_value:
  * @holder: a #GdaHolder object
  *
  * Get the default value held into the holder. WARNING: the default value does not need to be of 
@@ -1334,7 +1333,7 @@ gda_holder_get_default_value (GdaHolder *holder)
 
 
 /**
- * gda_holder_set_default_value
+ * gda_holder_set_default_value:
  * @holder: a #GdaHolder object
  * @value: a value to set the holder's default value, or %NULL
  *
@@ -1386,7 +1385,7 @@ gda_holder_set_default_value (GdaHolder *holder, const GValue *value)
 }
 
 /**
- * gda_holder_set_not_null
+ * gda_holder_set_not_null:
  * @holder: a #GdaHolder object
  * @not_null: TRUE if @holder should not accept %NULL values
  *
@@ -1402,7 +1401,7 @@ gda_holder_set_not_null (GdaHolder *holder, gboolean not_null)
 }
 
 /**
- * gda_holder_get_not_null
+ * gda_holder_get_not_null:
  * @holder: a #GdaHolder object
  *
  * Get wether the holder can be NULL or not
@@ -1419,7 +1418,7 @@ gda_holder_get_not_null (GdaHolder *holder)
 }
 
 /**
- * gda_holder_set_source_model
+ * gda_holder_set_source_model:
  * @holder: a #GdaHolder object
  * @model: a #GdaDataModel object or NULL
  * @col: the reference column in @model
@@ -1472,7 +1471,7 @@ gda_holder_set_source_model (GdaHolder *holder, GdaDataModel *model,
 
 
 /**
- * gda_holder_get_source_model
+ * gda_holder_get_source_model:
  * @holder: a #GdaHolder
  * @col: a place to store the column in the model sourcing the holder, or %NULL
  *
@@ -1483,7 +1482,7 @@ gda_holder_set_source_model (GdaHolder *holder, GdaDataModel *model,
  *
  * Otherwise, this method returns %NULL, and if @col is not %NULL, then it is set to 0.
  *
- * Returns: a pointer to a #GdaDataModel, or %NULL
+ * Returns: (transfer none): a pointer to a #GdaDataModel, or %NULL
  */
 GdaDataModel *
 gda_holder_get_source_model (GdaHolder *holder, gint *col)
@@ -1519,7 +1518,7 @@ bind_to_notify_cb (GdaHolder *bind_to, GParamSpec *pspec, GdaHolder *holder)
 }
 
 /**
- * gda_holder_set_bind
+ * gda_holder_set_bind:
  * @holder: a #GdaHolder
  * @bind_to: a #GdaHolder or %NULL
  * @error: a place to store errors, or %NULL
@@ -1706,12 +1705,12 @@ full_bind_changed_cb (GdaHolder *alias_of, GdaHolder *holder)
 }
 
 /**
- * gda_holder_get_bind
+ * gda_holder_get_bind:
  * @holder: a #GdaHolder
  *
  * Get the holder which makes @holder change its value when the holder's value is changed.
  *
- * Returns: the #GdaHolder or %NULL
+ * Returns: (transfer none): the #GdaHolder or %NULL
  */
 GdaHolder *
 gda_holder_get_bind (GdaHolder *holder)
@@ -1723,7 +1722,7 @@ gda_holder_get_bind (GdaHolder *holder)
 }
 
 /**
- * gda_holder_get_alphanum_id
+ * gda_holder_get_alphanum_id:
  * @holder: a #GdaHolder object
  *
  * Get an "encoded" version of @holder's name. The "encoding" consists in replacing non
@@ -1743,7 +1742,7 @@ gda_holder_get_alphanum_id (GdaHolder *holder)
 }
 
 /**
- * gda_holder_get_attribute
+ * gda_holder_get_attribute:
  * @holder: a #GdaHolder
  * @attribute: attribute name as a string
  *
@@ -1763,7 +1762,7 @@ gda_holder_get_attribute (GdaHolder *holder, const gchar *attribute)
 }
 
 /**
- * gda_holder_set_attribute
+ * gda_holder_set_attribute:
  * @holder: a #GdaHolder
  * @attribute: attribute name
  * @value: a #GValue, or %NULL
diff --git a/libgda/gda-lockable.c b/libgda/gda-lockable.c
index 32df32f..0a94307 100644
--- a/libgda/gda-lockable.c
+++ b/libgda/gda-lockable.c
@@ -1,6 +1,6 @@
 /* 
  * GDA common library
- * Copyright (C) 2008 The GNOME Foundation.
+ * Copyright (C) 2008 - 2010 The GNOME Foundation.
  *
  * AUTHORS:
  *      Vivien Malerba <malerba gnome-db org>
@@ -67,7 +67,7 @@ gda_lockable_class_init (gpointer g_class)
 }
 
 /**
- * gda_lockable_lock
+ * gda_lockable_lock:
  * @lockable: a #GdaLockable object.
  *
  * Locks @lockable. If it is already locked by another thread, the current thread will block until it is unlocked 
@@ -90,7 +90,7 @@ gda_lockable_lock (GdaLockable *lockable)
 }
 
 /**
- * gda_lockable_trylock
+ * gda_lockable_trylock:
  * @lockable: a #GdaLockable object.
  *
  * Tries to lock @lockable. If it is already locked by another thread, then it immediately returns FALSE, otherwise
@@ -117,7 +117,7 @@ gda_lockable_trylock (GdaLockable *lockable)
 }
 
 /**
- * gda_lockable_unlock
+ * gda_lockable_unlock:
  * @lockable: a #GdaLockable object.
  *
  * Unlocks @lockable. This method should not be called if the current does not already holds a lock on @lockable (having
diff --git a/libgda/gda-log.c b/libgda/gda-log.c
index dbc1d22..3dca2de 100644
--- a/libgda/gda-log.c
+++ b/libgda/gda-log.c
@@ -1,5 +1,5 @@
 /* GDA Common Library
- * Copyright (C) 1998-2002 The GNOME Foundation.
+ * Copyright (C) 1998 - 2010 The GNOME Foundation.
  *
  * This Library is free software; you can redistribute it and/or
  * modify it under the terms of the GNU Library General Public License as
@@ -38,7 +38,7 @@ static gboolean log_opened = FALSE;
  */
 
 /**
- * gda_log_enable
+ * gda_log_enable:
  *
  * Enables GDA logs.
  */
@@ -57,7 +57,7 @@ gda_log_enable (void)
 }
 
 /**
- * gda_log_disable
+ * gda_log_disable:
  *
  * Disables GDA logs.
  */
@@ -76,7 +76,7 @@ gda_log_disable (void)
 }
 
 /**
- * gda_log_is_enabled
+ * gda_log_is_enabled:
  *
  * Returns: whether GDA logs are enabled (%TRUE or %FALSE).
  */
@@ -87,7 +87,7 @@ gda_log_is_enabled (void)
 }
 
 /**
- * gda_log_message
+ * gda_log_message:
  * @format: format string (see the printf(3) documentation).
  * @...: arguments to insert in the message.
  *
@@ -122,7 +122,7 @@ gda_log_message (const gchar *format, ...)
 }
 
 /**
- * gda_log_error
+ * gda_log_error:
  * @format: format string (see the printf(3) documentation).
  * @...: arguments to insert in the error.
  *



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