[libgda] Documentation corrections, incl. Gtk-Doc related

From: Vivien Malerba <vivien src gnome org>
To: commits-list gnome org
Cc:
Subject: [libgda] Documentation corrections, incl. Gtk-Doc related
Date: Sun, 22 Mar 2015 18:13:51 +0000 (UTC)
commit 331cfbe5fea8bd34215ef229d0f330f7ada7abd8
Author: Vivien Malerba <malerba gnome-db org>
Date:   Sun Mar 22 19:01:54 2015 +0100

    Documentation corrections, incl. Gtk-Doc related

 doc/C/Makefile.am                              |    2 +-
 doc/C/installation.xml                         |    2 +-
 doc/C/libgda-6.0-docs.sgml                     |    2 +-
 doc/C/migration4.xml                           |    4 +-
 doc/C/prov-notes.xml                           |    6 ++
 doc/src-files/libgda                           |    1 +
 doc/src-files/libgda-report                    |    1 +
 doc/src-files/libgda-ui                        |    1 +
 doc/src-files/libgda-xslt                      |    1 +
 libgda/gda-data-model-array.c                  |    4 +-
 libgda/gda-data-model.c                        |   85 ++++++------------------
 libgda/gda-data-proxy.c                        |    4 +-
 libgda/gda-meta-store.c                        |   10 +--
 libgda/gda-server-operation.c                  |   14 +---
 libgda/gda-sql-builder.c                       |   10 +--
 libgda/gda-util.c                              |    8 +--
 libgda/gda-value.c                             |    7 +--
 libgda/sqlite/virtual/gda-ldap-connection.c    |   10 ++--
 libgda/sqlite/virtual/gda-virtual-connection.c |    3 +-
 libgda/thread-wrapper/gda-worker.h             |    2 +-
 20 files changed, 62 insertions(+), 115 deletions(-)
---
diff --git a/doc/C/Makefile.am b/doc/C/Makefile.am
index 0fe4503..d5ddf79 100644
--- a/doc/C/Makefile.am
+++ b/doc/C/Makefile.am
@@ -15,7 +15,7 @@ SCAN_OPTIONS=--deprecated-guards="GDA_DISABLE_DEPRECATED"
 SCANGOBJ_OPTIONS=
 
 # The directory containing the source code. Relative to $(srcdir)
-DOC_SOURCE_DIR=../..
+DOC_SOURCE_DIR=../src-files
 
 # Add the builddir to the HTML path so that version.xml is found
 MKHTML_OPTIONS=--path="$(abs_srcdir)"
diff --git a/doc/C/installation.xml b/doc/C/installation.xml
index 95631c2..33cd5ed 100644
--- a/doc/C/installation.xml
+++ b/doc/C/installation.xml
@@ -236,7 +236,7 @@
          named "SalesTest". 
        </para>
       </sect3>
-      <sect3 id="installation-provider-default">
+      <sect3 id="installation-provider-jdbc">
        <title>JDBC based providers</title>
        <para>Refer to the <link linkend="provider_notes_jdbc">JDBC notes</link> section for more information.
        </para>
diff --git a/doc/C/libgda-6.0-docs.sgml b/doc/C/libgda-6.0-docs.sgml
index 5b76670..d843f70 100644
--- a/doc/C/libgda-6.0-docs.sgml
+++ b/doc/C/libgda-6.0-docs.sgml
@@ -100,7 +100,7 @@
     </authorgroup>
     <date>&builddate;</date>
     <copyright>
-      <year>1999 - 2014</year>
+      <year>1999 - 2015</year>
       <holder>&copy;</holder>
     </copyright>
     <abstract>
diff --git a/doc/C/migration4.xml b/doc/C/migration4.xml
index f0a98dc..2357827 100644
--- a/doc/C/migration4.xml
+++ b/doc/C/migration4.xml
@@ -102,9 +102,9 @@
 
   <sect1><title>Multi threading and asynchronicity</title>
   <para>
-    Until versions 5.x, multi threading handling, along with the way asynchronous operations were carried was
+    In versions 5.x and before, multi threading handling, along with the way asynchronous operations were 
carried was
     a complicated piece of engineering and had a lot of caveats. Form version 6.x on, each connection (or, if
-    not supported by the database's C API, each provider) is internally used from a specific thread, always 
different
+    not supported by the database's C API, then each provider) is internally used from a specific thread, 
always different
     than from the "user" threads (the threads the user of &LIBGDA; creates). The consequence is that any
     connection can now be used by any thread the user creates.
   </para>
diff --git a/doc/C/prov-notes.xml b/doc/C/prov-notes.xml
index a7cf999..07d8012 100644
--- a/doc/C/prov-notes.xml
+++ b/doc/C/prov-notes.xml
@@ -20,6 +20,9 @@
       The following arguments are used to connect to an Oracle database:
       <table frame="all">
         <tgroup cols="3" colsep="1" rowsep="1" align="justify">
+         <colspec colnum="1" colwidth="1.4*"/>
+         <colspec colnum="2" colwidth="2.8*"/>
+         <colspec colnum="3" colwidth=".4*"/>
           <thead>
            <row>
               <entry>Argument name</entry>
@@ -65,6 +68,9 @@
       The following arguments are used to connect to an SQLite database:
       <table frame="all">
         <tgroup cols="3" colsep="1" rowsep="1" align="justify">
+         <colspec colnum="1" colwidth="1.4*"/>
+         <colspec colnum="2" colwidth="2.8*"/>
+         <colspec colnum="3" colwidth=".4*"/>
           <thead>
            <row>
               <entry>Argument name</entry>
diff --git a/doc/src-files/libgda b/doc/src-files/libgda
new file mode 120000
index 0000000..a2eeddb
--- /dev/null
+++ b/doc/src-files/libgda
@@ -0,0 +1 @@
+../../libgda
\ No newline at end of file
diff --git a/doc/src-files/libgda-report b/doc/src-files/libgda-report
new file mode 120000
index 0000000..7489884
--- /dev/null
+++ b/doc/src-files/libgda-report
@@ -0,0 +1 @@
+../../libgda-report
\ No newline at end of file
diff --git a/doc/src-files/libgda-ui b/doc/src-files/libgda-ui
new file mode 120000
index 0000000..60b371a
--- /dev/null
+++ b/doc/src-files/libgda-ui
@@ -0,0 +1 @@
+../../libgda-ui
\ No newline at end of file
diff --git a/doc/src-files/libgda-xslt b/doc/src-files/libgda-xslt
new file mode 120000
index 0000000..753a5d0
--- /dev/null
+++ b/doc/src-files/libgda-xslt
@@ -0,0 +1 @@
+../../libgda-xslt
\ No newline at end of file
diff --git a/libgda/gda-data-model-array.c b/libgda/gda-data-model-array.c
index 6eeb5eb..34a9ded 100644
--- a/libgda/gda-data-model-array.c
+++ b/libgda/gda-data-model-array.c
@@ -325,7 +325,7 @@ gda_data_model_array_new_with_g_types (gint cols, ...)
 }
 
 /**
- * gda_data_model_array_new_with_g_types_v:
+ * gda_data_model_array_new_with_g_types_v: (rename-to gda_data_model_array_new_with_g_types)
  * @cols: number of columns for rows in this data model.
  * @types: (array): array of types of the columns of the model to create as #GType, as many as indicated by 
@cols
  *
@@ -335,8 +335,6 @@ gda_data_model_array_new_with_g_types (gint cols, ...)
  * Returns: (transfer full): a pointer to the newly created #GdaDataModel.
  *
  * Since: 4.2.6
- *
- * Rename to: gda_data_model_array_new_with_g_types
  */
 GdaDataModel *
 gda_data_model_array_new_with_g_types_v (gint cols, GType *types)
diff --git a/libgda/gda-data-model.c b/libgda/gda-data-model.c
index 5aa5792..93e9ac3 100644
--- a/libgda/gda-data-model.c
+++ b/libgda/gda-data-model.c
@@ -399,15 +399,13 @@ gda_data_model_thaw (GdaDataModel *model)
 }
 
 /**
- * gda_data_model_set_notify:
+ * gda_data_model_set_notify: (virtual i_set_notify)
  * @model: a #GdaDataModel object.
  * @do_notify_changes: Set to TRUE if you require notifications.
  *
  * Enable or disable notifications changes on the given data model.
  * 
  * Deprecated: 5.2: use gda_data_model_freeze() and gda_data_model_thaw() instead
- *
- * Virtual: i_set_notify
  */
 void
 gda_data_model_set_notify (GdaDataModel *model, gboolean do_notify_changes)
@@ -418,12 +416,10 @@ gda_data_model_set_notify (GdaDataModel *model, gboolean do_notify_changes)
 }
 
 /**
- * gda_data_model_get_notify:
+ * gda_data_model_get_notify: (virtual i_get_notify)
  * @model: a #GdaDataModel object.
  *
  * Returns the status of notifications changes on the given data model.
- * 
- * Virtual: i_get_notify
  */
 gboolean
 gda_data_model_get_notify (GdaDataModel *model)
@@ -437,14 +433,12 @@ gda_data_model_get_notify (GdaDataModel *model)
 
 
 /**
- * gda_data_model_get_access_flags:
+ * gda_data_model_get_access_flags: (virtual i_get_access_flags)
  * @model: a #GdaDataModel object.
  *
  * Get the attributes of @model such as how to access the data it contains if it's modifiable, etc.
  *
  * Returns: (transfer none): an ORed value of #GdaDataModelAccessFlags flags
- *
- * Virtual: i_get_access_flags
  */
 GdaDataModelAccessFlags
 gda_data_model_get_access_flags (GdaDataModel *model)
@@ -461,12 +455,10 @@ gda_data_model_get_access_flags (GdaDataModel *model)
 }
 
 /**
- * gda_data_model_get_n_rows:
+ * gda_data_model_get_n_rows: (virtual i_get_n_rows)
  * @model: a #GdaDataModel object.
  *
  * Returns: the number of rows in the given data model, or -1 if the number of rows is not known
- *
- * Virtual: i_get_n_rows
  */
 gint
 gda_data_model_get_n_rows (GdaDataModel *model)
@@ -480,12 +472,10 @@ gda_data_model_get_n_rows (GdaDataModel *model)
 }
 
 /**
- * gda_data_model_get_n_columns:
+ * gda_data_model_get_n_columns: (virtual i_get_n_columns)
  * @model: a #GdaDataModel object.
  *
  * Returns: the number of columns in the given data model, or -1 if unknown.
- *
- * Virtual: i_get_n_columns
  */
 gint
 gda_data_model_get_n_columns (GdaDataModel *model)
@@ -501,7 +491,7 @@ gda_data_model_get_n_columns (GdaDataModel *model)
 }
 
 /**
- * gda_data_model_describe_column:
+ * gda_data_model_describe_column: (virtual i_describe_column)
  * @model: a #GdaDataModel object.
  * @col: column number.
  *
@@ -514,8 +504,6 @@ gda_data_model_get_n_columns (GdaDataModel *model)
  * and should not be destroyed; any modification will affect the whole data model.
  *
  * Returns: (transfer none) (allow-none): the description of the column.
- *
- * Virtual: i_describe_column
  */
 GdaColumn *
 gda_data_model_describe_column (GdaDataModel *model, gint col)
@@ -656,7 +644,7 @@ gda_data_model_set_column_title (GdaDataModel *model, gint col, const gchar *tit
 }
 
 /**
- * gda_data_model_get_value_at:
+ * gda_data_model_get_value_at: (virtual i_get_value_at)
  * @model: a #GdaDataModel object.
  * @col: a valid column number.
  * @row: a valid row number.
@@ -688,9 +676,6 @@ gda_data_model_set_column_title (GdaDataModel *model, gint col, const gchar *tit
  *
  * Returns: (allow-none) (transfer none): a #GValue containing the value stored in the given
  * position, or %NULL on error (out-of-bound position, etc).
- *
- * Virtual: i_get_value_at
- *
  */
 const GValue *
 gda_data_model_get_value_at (GdaDataModel *model, gint col, gint row, GError **error)
@@ -764,7 +749,7 @@ gda_data_model_get_typed_value_at (GdaDataModel *model, gint col, gint row, GTyp
 }
 
 /**
- * gda_data_model_get_attributes_at:
+ * gda_data_model_get_attributes_at: (virtual i_get_attributes_at)
  * @model: a #GdaDataModel object
  * @col: a valid column number
  * @row: a valid row number, or -1
@@ -775,8 +760,6 @@ gda_data_model_get_typed_value_at (GdaDataModel *model, gint col, gint row, GTyp
  * if a row was added to @model.
  *
  * Returns: (transfer none): the attributes as an ORed value of #GdaValueAttribute
- *
- * Virtual: i_get_attributes_at
  */
 GdaValueAttribute
 gda_data_model_get_attributes_at (GdaDataModel *model, gint col, gint row)
@@ -796,7 +779,7 @@ gda_data_model_get_attributes_at (GdaDataModel *model, gint col, gint row)
 }
 
 /**
- * gda_data_model_set_value_at:
+ * gda_data_model_set_value_at: (virtual i_set_value_at)
  * @model: a #GdaDataModel object.
  * @col: column number.
  * @row: row number.
@@ -809,8 +792,6 @@ gda_data_model_get_attributes_at (GdaDataModel *model, gint col, gint row)
  * #GError from the #GDA_DATA_MODEL_ERROR domain.
  *
  * Returns: TRUE if the value in the data model has been updated and no error occurred
- *
- * Virtual: i_set_value_at
  */
 gboolean
 gda_data_model_set_value_at (GdaDataModel *model, gint col, gint row, const GValue *value, GError **error)
@@ -828,7 +809,7 @@ gda_data_model_set_value_at (GdaDataModel *model, gint col, gint row, const GVal
 }
 
 /**
- * gda_data_model_set_values:
+ * gda_data_model_set_values: (virtual i_set_values)
  * @model: a #GdaDataModel object.
  * @row: row number.
  * @values: (element-type GObject.Value) (transfer none) (allow-none): a list of #GValue (or %NULL), one for 
at most the number of columns of @model
@@ -844,8 +825,6 @@ gda_data_model_set_value_at (GdaDataModel *model, gint col, gint row, const GVal
  * #GError from the #GDA_DATA_MODEL_ERROR domain.
  *
  * Returns: %TRUE if the value in the data model has been updated and no error occurred
- *
- * Virtual: i_set_values
  */
 gboolean
 gda_data_model_set_values (GdaDataModel *model, gint row, GList *values, GError **error)
@@ -886,7 +865,7 @@ gda_data_model_set_values (GdaDataModel *model, gint row, GList *values, GError
 }
 
 /**
- * gda_data_model_create_iter:
+ * gda_data_model_create_iter: (virtual i_create_iter)
  * @model: a #GdaDataModel object.
  *
  * Creates a new iterator object #GdaDataModelIter object which can be used to iterate through
@@ -914,8 +893,6 @@ gda_data_model_set_values (GdaDataModel *model, gint row, GList *values, GError
  * <programlisting><![CDATA[iter = g_object_new (GDA_TYPE_DATA_MODEL_ITER, "data-model", proxy, 
NULL);]]></programlisting>
  *
  * Returns: (transfer full): a #GdaDataModelIter object, or %NULL if an error occurred
- *
- * Virtual: i_create_iter
  */
 GdaDataModelIter *
 gda_data_model_create_iter (GdaDataModel *model)
@@ -930,7 +907,7 @@ gda_data_model_create_iter (GdaDataModel *model)
 }
 
 /**
- * gda_data_model_iter_at_row:
+ * gda_data_model_iter_at_row: (virtual i_iter_at_row)
  * @model: a #GdaDataModel object.
  * @iter: a #GdaDataModelIter object.
  * @row: a row to point to with @iter
@@ -938,8 +915,6 @@ gda_data_model_create_iter (GdaDataModel *model)
  * Moves @iter to the row number given by @row.
  * 
  * Deprecated: 5.2: use gda_data_model_iter_move_to_row() instead
- *
- * Virtual: i_iter_at_row
  */
 gboolean
 gda_data_model_iter_at_row (GdaDataModel *model, GdaDataModelIter *iter, gint row)
@@ -951,15 +926,13 @@ gda_data_model_iter_at_row (GdaDataModel *model, GdaDataModelIter *iter, gint ro
 }
 
 /**
- * gda_data_model_iter_next:
+ * gda_data_model_iter_next: (virtual i_iter_next)
  * @model: a #GdaDataModel object.
  * @iter: a #GdaDataModelIter object.
  *
  * Moves @iter to the next row in @model.
  * 
  * Deprecated: 5.2: use gda_data_model_iter_move_next() instead
- *
- * Virtual: i_iter_next
  */
 gboolean
 gda_data_model_iter_next (GdaDataModel *model, GdaDataModelIter *iter)
@@ -971,15 +944,13 @@ gda_data_model_iter_next (GdaDataModel *model, GdaDataModelIter *iter)
 }
 
 /**
- * gda_data_model_iter_prev:
+ * gda_data_model_iter_prev: (virtual i_iter_prev)
  * @model: a #GdaDataModel object.
  * @iter: a #GdaDataModelIter object.
  *
  * Moves @iter to the next row in @model.
  *
  * Deprecated: 5.2: use gda_data_model_iter_move_prev() instead
- * 
- * Virtual: i_iter_prev
  */
 gboolean 
 gda_data_model_iter_prev (GdaDataModel *model, GdaDataModelIter *iter)
@@ -992,7 +963,7 @@ gda_data_model_iter_prev (GdaDataModel *model, GdaDataModelIter *iter)
 
 
 /**
- * gda_data_model_iter_set_value:
+ * gda_data_model_iter_set_value: (virtual i_iter_set_value)
  * @model: a #GdaDataModel object.
  * @iter: a #GdaDataModelIter object.
  * @col: the number of column to set value to
@@ -1002,8 +973,6 @@ gda_data_model_iter_prev (GdaDataModel *model, GdaDataModelIter *iter)
  * Set @value to the given @column and row pointed by @iter in the given @model.
  * 
  * Deprecated: 5.2: use gda_data_model_iter_set_value_at() instead
- *
- * Virtual: i_iter_set_value
  */
 gboolean 
 gda_data_model_iter_set_value (GdaDataModel *model, GdaDataModelIter *iter, gint col,
@@ -1017,7 +986,7 @@ gda_data_model_iter_set_value (GdaDataModel *model, GdaDataModelIter *iter, gint
 
 
 /**
- * gda_data_model_append_values:
+ * gda_data_model_append_values: (virtual i_append_values)
  * @model: a #GdaDataModel object.
  * @values: (element-type GObject.Value) (allow-none): #GList of #GValue* representing the row to add.  The
  *          length must match model's column count.  These #GValue
@@ -1031,8 +1000,6 @@ gda_data_model_iter_set_value (GdaDataModel *model, GdaDataModelIter *iter, gint
  * #GError from the #GDA_DATA_MODEL_ERROR domain.
  *
  * Returns: the number of the added row, or -1 if an error occurred
- *
- * Virtual: i_append_values
  */
 gint
 gda_data_model_append_values (GdaDataModel *model, const GList *values, GError **error)
@@ -1050,7 +1017,7 @@ gda_data_model_append_values (GdaDataModel *model, const GList *values, GError *
 }
 
 /**
- * gda_data_model_append_row:
+ * gda_data_model_append_row: (virtual i_append_row)
  * @model: a #GdaDataModel object.
  * @error: a place to store errors, or %NULL
  * 
@@ -1061,8 +1028,6 @@ gda_data_model_append_values (GdaDataModel *model, const GList *values, GError *
  * #GError from the #GDA_DATA_MODEL_ERROR domain.
  *
  * Returns: the number of the added row, or -1 if an error occurred
- *
- * Virtual: i_append_row
  */
 gint
 gda_data_model_append_row (GdaDataModel *model, GError **error)
@@ -1087,7 +1052,7 @@ gda_data_model_append_row (GdaDataModel *model, GError **error)
 
 
 /**
- * gda_data_model_remove_row:
+ * gda_data_model_remove_row: (virtual i_remove_row)
  * @model: a #GdaDataModel object.
  * @row: the row number to be removed.
  * @error: a place to store errors, or %NULL
@@ -1098,8 +1063,6 @@ gda_data_model_append_row (GdaDataModel *model, GError **error)
  * #GError from the #GDA_DATA_MODEL_ERROR domain.
  *
  * Returns: %TRUE if successful, %FALSE otherwise.
- *
- * Virtual: i_remove_row
  */
 gboolean
 gda_data_model_remove_row (GdaDataModel *model, gint row, GError **error)
@@ -1123,7 +1086,7 @@ gda_data_model_remove_row (GdaDataModel *model, gint row, GError **error)
 }
 
 /**
- * gda_data_model_get_row_from_values:
+ * gda_data_model_get_row_from_values: (virtual i_find_row)
  * @model: a #GdaDataModel object.
  * @values: (element-type GObject.Value): a list of #GValue values (no %NULL is allowed)
  * @cols_index: (array): an array of #gint containing the column number to match each value of @values
@@ -1134,8 +1097,6 @@ gda_data_model_remove_row (GdaDataModel *model, gint row, GError **error)
  * NOTE: the @cols_index array MUST contain a column index for each value in @values
  *
  * Returns: the requested row number, of -1 if not found
- *
- * Virtual: i_find_row
  */
 gint
 gda_data_model_get_row_from_values (GdaDataModel *model, GSList *values, gint *cols_index)
@@ -1197,15 +1158,13 @@ gda_data_model_get_row_from_values (GdaDataModel *model, GSList *values, gint *c
 }
 
 /**
- * gda_data_model_send_hint:
+ * gda_data_model_send_hint: (virtual i_send_hint)
  * @model: a #GdaDataModel
  * @hint: (transfer none): a hint to send to the model
  * @hint_value: (allow-none): an optional value to specify the hint, or %NULL
  *
  * Sends a hint to the data model. The hint may or may not be handled by the data
  * model, depending on its implementation
- *
- * Virtual: i_send_hint
  */
 void
 gda_data_model_send_hint (GdaDataModel *model, GdaDataModelHint hint, const GValue *hint_value)
@@ -1217,7 +1176,7 @@ gda_data_model_send_hint (GdaDataModel *model, GdaDataModelHint hint, const GVal
 }
 
 /**
- * gda_data_model_get_exceptions:
+ * gda_data_model_get_exceptions: (virtual i_get_exceptions)
  * @model: a #GdaDataModel
  *
  * Get the global data model exception(s) that occurred when using @model.
@@ -1228,8 +1187,6 @@ gda_data_model_send_hint (GdaDataModel *model, GdaDataModelHint hint, const GVal
  * Returns: (transfer none) (element-type GLib.Error) (array zero-terminated=1): a pointer to a %NULL 
terminated array of #GError, or %NULL.
  *
  * Since: 4.2.6
- *
- * Virtual: i_get_exceptions
  */
 GError **
 gda_data_model_get_exceptions (GdaDataModel *model)
diff --git a/libgda/gda-data-proxy.c b/libgda/gda-data-proxy.c
index 6caf027..2b8fcac 100644
--- a/libgda/gda-data-proxy.c
+++ b/libgda/gda-data-proxy.c
@@ -1,6 +1,6 @@
 /*
  * Copyright (C) 2006 - 2011 Murray Cumming <murrayc murrayc com>
- * Copyright (C) 2006 - 2014 Vivien Malerba <malerba gnome-db org>
+ * Copyright (C) 2006 - 2015 Vivien Malerba <malerba gnome-db org>
  * Copyright (C) 2007 Armin Burgmeier <arminb src gnome org>
  * Copyright (C) 2007 Leonardo Boshell <lb kmc com co>
  * Copyright (C) 2009 Bas Driessen <bas driessen xobas com>
@@ -1443,7 +1443,7 @@ find_or_create_row_modif (GdaDataProxy *proxy, gint proxy_row, gint col, RowValu
  * gda_data_proxy_get_values:
  * @proxy: a #GdaDataProxy object
  * @proxy_row: a proxy row
- * @cols_index: (array) (array length=n_cols): array containing the columns for which the values are 
requested
+ * @cols_index: (array length=n_cols): array containing the columns for which the values are requested
  * @n_cols: size of @cols_index
  *
  * Retrieve a whole list of values from the @proxy data model. This function
diff --git a/libgda/gda-meta-store.c b/libgda/gda-meta-store.c
index f85c346..27a3979 100644
--- a/libgda/gda-meta-store.c
+++ b/libgda/gda-meta-store.c
@@ -1,7 +1,7 @@
 /*
  * Copyright (C) 2008 - 2009 Bas Driessen <bas driessen xobas com>
  * Copyright (C) 2008 - 2011 Murray Cumming <murrayc murrayc com>
- * Copyright (C) 2008 - 2014 Vivien Malerba <malerba gnome-db org>
+ * Copyright (C) 2008 - 2015 Vivien Malerba <malerba gnome-db org>
  * Copyright (C) 2010 David King <davidk openismus com>
  * Copyright (C) 2010 Jonh Wendell <jwendell gnome org>
  * Copyright (C) 2011 - 2012 Daniel Espinosa <despinosa src gnome org>
@@ -2838,7 +2838,7 @@ gda_meta_store_extract (GdaMetaStore *store, const gchar *select_sql, GError **e
 }
 
 /**
- * gda_meta_store_extract_v:
+ * gda_meta_store_extract_v: (rename-to gda_meta_store_extract)
  * @store: a #GdaMetaStore object
  * @select_sql: a SELECT statement
  * @vars: (element-type utf8 GObject.Value) (allow-none): a hash table with all variables names as keys and 
GValue* as
@@ -2857,8 +2857,6 @@ gda_meta_store_extract (GdaMetaStore *store, const gchar *select_sql, GError **e
  * Returns: (transfer full): a new #GdaDataModel, or %NULL if an error occurred
  *
  * Since: 4.2.6
- *
- * Rename to: gda_meta_store_extract
  */
 GdaDataModel *
 gda_meta_store_extract_v (GdaMetaStore *store, const gchar *select_sql, GHashTable *vars, GError **error)
@@ -3079,7 +3077,7 @@ gda_meta_store_modify_with_context (GdaMetaStore *store, GdaMetaContext *context
 
 /*#define DEBUG_STORE_MODIFY*/
 /**
- * gda_meta_store_modify_v:
+ * gda_meta_store_modify_v: (rename-to gda_meta_store_modify)
  * @store: a #GdaMetaStore object
  * @table_name: the name of the table to modify within @store
  * @new_data: (allow-none): a #GdaDataModel containing the new data to set in @table_name, or %NULL (treated 
as a data model
@@ -3096,8 +3094,6 @@ gda_meta_store_modify_with_context (GdaMetaStore *store, GdaMetaContext *context
  * Returns: %TRUE if no error occurred
  *
  * Since: 4.2.6
- *
- * Rename to: gda_meta_store_modify
  */
 gboolean
 gda_meta_store_modify_v (GdaMetaStore *store, const gchar *table_name,
diff --git a/libgda/gda-server-operation.c b/libgda/gda-server-operation.c
index 3977491..39cc1ad 100644
--- a/libgda/gda-server-operation.c
+++ b/libgda/gda-server-operation.c
@@ -1,6 +1,6 @@
 /*
  * Copyright (C) 2006 - 2008 Murray Cumming <murrayc murrayc com>
- * Copyright (C) 2006 - 2014 Vivien Malerba <malerba gnome-db org>
+ * Copyright (C) 2006 - 2015 Vivien Malerba <malerba gnome-db org>
  * Copyright (C) 2007 Leonardo Boshell <lb kmc com co>
  * Copyright (C) 2008 Armin Burgmeier <armin openismus com>
  * Copyright (C) 2008 Phil Longstaff <plongstaff rogers com>
@@ -2043,7 +2043,7 @@ gda_server_operation_del_item_from_sequence (GdaServerOperation *op, const gchar
 }
 
 /**
- * gda_server_operation_get_value_at_path:
+ * gda_server_operation_get_value_at_path: (rename-to gda_server_operation_get_value_at)
  * @op: a #GdaServerOperation object
  * @path: a complete path to a node (starting with "/")
  *
@@ -2052,8 +2052,6 @@ gda_server_operation_del_item_from_sequence (GdaServerOperation *op, const gchar
  * Returns: (transfer none) (allow-none): a constant #GValue if a value has been defined, or %NULL if the 
value is undefined or if the @path is not defined or @path does not hold any value.
  *
  * Since: 4.2.6
- *
- * Rename to: gda_server_operation_get_value_at
  */
 const GValue *
 gda_server_operation_get_value_at_path (GdaServerOperation *op, const gchar *path)
@@ -2183,7 +2181,7 @@ gda_server_operation_get_sql_identifier_at (GdaServerOperation *op, GdaConnectio
 }
 
 /**
- * gda_server_operation_get_sql_identifier_at_path:
+ * gda_server_operation_get_sql_identifier_at_path: (rename-to gda_server_operation_get_sql_identifier_at)
  * @op: a #GdaServerOperation object
  * @cnc: (allow-none): a #GdaConnection, or %NULL
  * @prov: (allow-none): a #GdaServerProvider, or %NULL
@@ -2200,8 +2198,6 @@ gda_server_operation_get_sql_identifier_at (GdaServerOperation *op, GdaConnectio
  * a valid SQL identifier.
  *
  * Since: 4.2.6
- *
- * Rename to: gda_server_operation_get_sql_identifier_at
  */
 gchar *
 gda_server_operation_get_sql_identifier_at_path (GdaServerOperation *op, GdaConnection *cnc, 
GdaServerProvider *prov,
@@ -2237,7 +2233,7 @@ gda_server_operation_get_sql_identifier_at_path (GdaServerOperation *op, GdaConn
 }
 
 /**
- * gda_server_operation_set_value_at_path:
+ * gda_server_operation_set_value_at_path: (rename-to gda_server_operation_set_value_at)
  * @op: a #GdaServerOperation object
  * @value: (allow-none): a string
  * @path: a complete path to a node (starting with "/")
@@ -2276,8 +2272,6 @@ gda_server_operation_get_sql_identifier_at_path (GdaServerOperation *op, GdaConn
  * Returns: %TRUE if no error occurred
  *
  * Since: 4.2.6
- *
- * Rename to: gda_server_operation_set_value_at
  */
 gboolean
 gda_server_operation_set_value_at_path (GdaServerOperation *op, const gchar *value, 
diff --git a/libgda/gda-sql-builder.c b/libgda/gda-sql-builder.c
index 5eda90f..5bcf06e 100644
--- a/libgda/gda-sql-builder.c
+++ b/libgda/gda-sql-builder.c
@@ -2,7 +2,7 @@
  * Copyright (C) 2009 Bas Driessen <bas driessen xobas com>
  * Copyright (C) 2009 Johannes Schmid <jhs gnome org>
  * Copyright (C) 2009 - 2011 Murray Cumming <murrayc murrayc com>
- * Copyright (C) 2009 - 2013 Vivien Malerba <malerba gnome-db org>
+ * Copyright (C) 2009 - 2015 Vivien Malerba <malerba gnome-db org>
  * Copyright (C) 2010 David King <davidk openismus com>
  * Copyright (C) 2010 Jonh Wendell <jwendell gnome org>
  * Copyright (C) 2011 Daniel Espinosa <despinosa src gnome org>
@@ -1671,7 +1671,7 @@ gda_sql_builder_add_function (GdaSqlBuilder *builder, const gchar *func_name, ..
 }
 
 /**
- * gda_sql_builder_add_function_v:
+ * gda_sql_builder_add_function_v: (rename-to gda_sql_builder_add_function)
  * @builder: a #GdaSqlBuilder object
  * @func_name: the functions's name
  * @args: (array length=args_size): an array of IDs representing the function's arguments
@@ -1681,8 +1681,6 @@ gda_sql_builder_add_function (GdaSqlBuilder *builder, const gchar *func_name, ..
  *
  * Returns: the ID of the new expression, or %0 if there was an error
  *
- * Rename to: gda_sql_builder_add_function
- *
  * Since: 4.2
  */
 GdaSqlBuilderId
@@ -1911,7 +1909,7 @@ gda_sql_builder_add_case (GdaSqlBuilder *builder,
 }
 
 /**
- * gda_sql_builder_add_case_v:
+ * gda_sql_builder_add_case_v: (rename-to gda_sql_builder_add_case)
  * @builder: a #GdaSqlBuilder object
  * @test_expr: the expression ID representing the test of the CASE, or %0
  * @else_expr: the expression ID representing the ELSE expression, or %0
@@ -1926,8 +1924,6 @@ gda_sql_builder_add_case (GdaSqlBuilder *builder,
  * Returns: the ID of the new expression, or %0 if there was an error
  *
  * Since: 4.2
- *
- * Rename to: gda_sql_builder_add_case
  */
 GdaSqlBuilderId
 gda_sql_builder_add_case_v (GdaSqlBuilder *builder,
diff --git a/libgda/gda-util.c b/libgda/gda-util.c
index 9859d43..1fc26b6 100644
--- a/libgda/gda-util.c
+++ b/libgda/gda-util.c
@@ -6,7 +6,7 @@
  * Copyright (C) 2004 Caolan McNamara <caolanm redhat com>
  * Copyright (C) 2004 J�rg Billeter <j bitron ch>
  * Copyright (C) 2004 - 2011 Murray Cumming <murrayc murrayc com>
- * Copyright (C) 2005 - 2013 Vivien Malerba <malerba gnome-db org>
+ * Copyright (C) 2005 - 2015 Vivien Malerba <malerba gnome-db org>
  * Copyright (C) 2007 - 2009 Armin Burgmeier <armin openismus com>
  * Copyright (C) 2008 - 2009 Bas Driessen <bas driessen xobas com>
  * Copyright (C) 2008 Phil Longstaff <plongstaff rogers com>
@@ -299,7 +299,7 @@ gda_default_unescape_string (const gchar *string)
 }
 
 /**
- * gda_utility_check_data_model_v:
+ * gda_utility_check_data_model_v: (rename-to gda_utility_check_data_model)
  * @model: a #GdaDataModel object
  * @nbcols: the minimum requested number of columns
  * @types: (array length=nbcols): array with @nbcols length of type GType or null (if any data type is 
accepted)
@@ -309,8 +309,6 @@ gda_default_unescape_string (const gchar *string)
  * Returns: %TRUE if the data model's columns match the provided data types and number
  *
  * Since: 4.2.6
- *
- * Rename to: gda_utility_check_data_model
  */
 gboolean
 gda_utility_check_data_model_v (GdaDataModel *model, gint nbcols, GType* types)
@@ -353,7 +351,7 @@ gda_utility_check_data_model_v (GdaDataModel *model, gint nbcols, GType* types)
  * gda_utility_check_data_model: (skip)
  * @model: a #GdaDataModel object
  * @nbcols: the minimum requested number of columns
- * @Varargs: @nbcols arguments of type GType or -1 (if any data type is accepted)
+ * @...: @nbcols arguments of type GType or -1 (if any data type is accepted)
  *
  * Check the column types of a GdaDataModel.
  *
diff --git a/libgda/gda-value.c b/libgda/gda-value.c
index cc69aa6..7824b94 100644
--- a/libgda/gda-value.c
+++ b/libgda/gda-value.c
@@ -2,7 +2,7 @@
  * Copyright (C) 2001 - 2003 Rodrigo Moya <rodrigo gnome-db org>
  * Copyright (C) 2002 - 2003 Gonzalo Paniagua Javier <gonzalo gnome-db org>
  * Copyright (C) 2002 Holger Thon <holger thon gnome-db org>
- * Copyright (C) 2002 - 2013 Vivien Malerba <malerba gnome-db org>
+ * Copyright (C) 2002 - 2015 Vivien Malerba <malerba gnome-db org>
  * Copyright (C) 2002 Zbigniew Chyla <cyba gnome pl>
  * Copyright (C) 2003 Akira TAGOH <tagoh gnome-db org>
  * Copyright (C) 2003 Danilo Schoeneberg <dschoene src gnome org>
@@ -56,7 +56,7 @@
 
 #  ifdef GSEAL_ENABLE
 /**
- * GdaNumeric:
+ * GdaNumeric: (set-value-func gda_value_set_numeric) (get-value-func gda_value_get_numeric)
  * @number: a string representing a number
  * @precision: precision to use when @number is converted (not implemented jet)
  * @width: not implemented jet
@@ -65,9 +65,6 @@
  *
  * This struct must be considered as opaque. Any access to its members must use its
  * accessors added since version 5.0.2.
- *
- * Set value func: gda_value_set_numeric()
- * Get value func: gda_value_get_numeric()
  */
 struct _GdaNumeric {
        gchar*   number; /* stored in the "C" locale, never NULL */
diff --git a/libgda/sqlite/virtual/gda-ldap-connection.c b/libgda/sqlite/virtual/gda-ldap-connection.c
index b759ac9..60b98f7 100644
--- a/libgda/sqlite/virtual/gda-ldap-connection.c
+++ b/libgda/sqlite/virtual/gda-ldap-connection.c
@@ -1,5 +1,5 @@
 /*
- * Copyright (C) 2011 - 2012 Vivien Malerba <malerba gnome-db org>
+ * Copyright (C) 2011 - 2015 Vivien Malerba <malerba gnome-db org>
  *
  * This library is free software; you can redistribute it and/or
  * modify it under the terms of the GNU Lesser General Public
@@ -997,7 +997,7 @@ GdaLdapEntry **_gda_ldap_get_entry_children (GdaLdapConnection *cnc, const gchar
  * Describes the LDAP entry which DN is @dn. If @dn is %NULL, then the top entry (as specified when 
  * the LDAP connection was opened) is described.
  *
- * Returns: (transfer full) (Free-function: gda_ldap_entry_free): a new #GdaLdapEntry, or %NULL if an error 
occurred or if the @dn entry does not exist
+ * Returns: (transfer full): a new #GdaLdapEntry, or %NULL if an error occurred or if the @dn entry does not 
exist
  *
  * Since: 4.2.8
  */
@@ -1021,7 +1021,7 @@ gda_ldap_describe_entry (GdaLdapConnection *cnc, const gchar *dn, GError **error
  *
  * If @dn is %NULL, then the top entry (as specified when the LDAP connection was opened) is used.
  *
- * Returns: (transfer full) (element_type GdaLdapEntry) (array zero-terminated=1): a %NULL terminated array 
of #GdaLdapEntry for each child entry, or %NULL if an error occurred or if the @dn entry does not exist
+ * Returns: (transfer full) (array zero-terminated=1): a %NULL terminated array of #GdaLdapEntry for each 
child entry, or %NULL if an error occurred or if the @dn entry does not exist
  *
  * Since: 4.2.8
  */
@@ -1042,7 +1042,7 @@ gchar **_gda_ldap_dn_split (const gchar *dn, gboolean all);
  *
  * Splits @dn into its components.
  *
- * Returns: (transfer full) (Free-function: g_strfreev): a %NULL terminated array containing the DN parts 
(free using g_strfreev()), or %NULL if an error occurred because @dn is not a valid DN expression
+ * Returns: (transfer full): a %NULL terminated array containing the DN parts (free using g_strfreev()), or 
%NULL if an error occurred because @dn is not a valid DN expression
  *
  * Since: 4.2.8
  */
@@ -1206,7 +1206,7 @@ gda_ldap_add_entry (GdaLdapConnection *cnc, GdaLdapEntry *entry, GError **error)
 /**
  * gda_ldap_remove_entry:
  * @cnc: a #GdaLdapConnection
- * @entry: a #GdaLDapEntry describing the LDAP entry to remove
+ * @dn: the DN of the LDAP entry to remove
  * @error: (allow-none): a place to store an error, or %NULL
  *
  * Delete an LDAP entry.
diff --git a/libgda/sqlite/virtual/gda-virtual-connection.c b/libgda/sqlite/virtual/gda-virtual-connection.c
index d6f57b8..e1c4ea2 100644
--- a/libgda/sqlite/virtual/gda-virtual-connection.c
+++ b/libgda/sqlite/virtual/gda-virtual-connection.c
@@ -1,5 +1,5 @@
 /*
- * Copyright (C) 2007 - 2011 Vivien Malerba <malerba gnome-db org>
+ * Copyright (C) 2007 - 2015 Vivien Malerba <malerba gnome-db org>
  * Copyright (C) 2008 Murray Cumming <murrayc murrayc com>
  * Copyright (C) 2010 David King <davidk openismus com>
  *
@@ -123,6 +123,7 @@ gda_virtual_connection_get_type (void)
 /**
  * gda_virtual_connection_open
  * @virtual_provider: a #GdaVirtualProvider object
+ * @options: some options
  * @error: a place to store errors, or %NULL
  *
  * Creates and opens a new virtual connection using the @virtual_provider provider. The returned value
diff --git a/libgda/thread-wrapper/gda-worker.h b/libgda/thread-wrapper/gda-worker.h
index 86084eb..ecbdc5d 100644
--- a/libgda/thread-wrapper/gda-worker.h
+++ b/libgda/thread-wrapper/gda-worker.h
@@ -70,7 +70,7 @@ typedef enum {
 } GdaWorkerError;
 
 GdaWorker *gda_worker_new (void);
-GdaWorker *gda_worker_new_unique (GdaWorker **location, gboolean allow_renew);
+GdaWorker *gda_worker_new_unique (GdaWorker **location, gboolean allow_destroy);
 GdaWorker *gda_worker_ref (GdaWorker *worker);
 void       gda_worker_unref (GdaWorker *worker);
[Date Prev][Date Next] [Thread Prev][Thread Next] [Thread Index] [Date Index] [Author Index]