[libgda/LIBGDA_4.2] Doc. improvements

[Vivien Malerba <vivien src gnome org>]

commit c64a2afba901401f807d093a32118e350676d05e
Author: Vivien Malerba <malerba gnome-db org>
Date:   Sun Jul 24 13:06:05 2011 +0200

    Doc. improvements

 libgda/gda-meta-struct.c |    2 +-
 libgda/gda-util.c        |   15 +++++++--------
 2 files changed, 8 insertions(+), 9 deletions(-)
---
diff --git a/libgda/gda-meta-struct.c b/libgda/gda-meta-struct.c
index d74c526..e4a10e5 100644
--- a/libgda/gda-meta-struct.c
+++ b/libgda/gda-meta-struct.c
@@ -2588,7 +2588,7 @@ gda_meta_struct_add_db_object (GdaMetaStruct *mstruct, GdaMetaDbObject *dbo, GEr
  *
  * Get the value associated to a named attribute.
  *
- * Attributes can have any name, but Libgda proposes some default names, see <link linkend="libgda-40-Attributes-manager.synopsis">this section</link>.
+ * Attributes can have any name, but Libgda proposes some default names, see <link linkend="libgda-5.0-Attributes-manager.synopsis">this section</link>.
  *
  * Returns: (transfer none): a read-only #GValue, or %NULL if not attribute named @attribute has been set for @column
  */
diff --git a/libgda/gda-util.c b/libgda/gda-util.c
index 6003a6b..e756888 100644
--- a/libgda/gda-util.c
+++ b/libgda/gda-util.c
@@ -1026,15 +1026,14 @@ gda_compute_unique_table_row_condition (GdaSqlStatementSelect *stsel, GdaMetaTab
  * @cnc: a #GdaConnection
  * @select_stmt: a SELECT #GdaStatement (compound statements not handled)
  * @require_pk: TRUE if the created statement have to use a primary key
- * @insert_stmt: a place to store the created INSERT statement, or %NULL
- * @update_stmt: a place to store the created UPDATE statement, or %NULL
- * @delete_stmt: a place to store the created DELETE statement, or %NULL
- * @error: a place to store errors, or %NULL
+ * @insert_stmt: (allow-none) (transfer full): a place to store the created INSERT statement, or %NULL
+ * @update_stmt: (allow-none) (transfer full): a place to store the created UPDATE statement, or %NULL
+ * @delete_stmt: (allow-none) (transfer full): a place to store the created DELETE statement, or %NULL
+ * @error: (allow-none): a place to store errors, or %NULL
  *
  * Creates an INSERT, an UPDATE and a DELETE statement from a SELECT statement
- * using the database metadata available in @cnc's meta store.
- *
- * %FALSE will be returned if any of the statement cannot be built.
+ * using the database metadata available in @cnc's meta store. Each statements are computed only if
+ * the corresponding place to store the created statement is not %NULL.
  * 
  * returns: %TRUE if no error occurred
  */
@@ -1240,7 +1239,7 @@ gda_compute_dml_statements (GdaConnection *cnc, GdaStatement *select_stmt, gbool
  * @error: a place to store errors, or %NULL
  *
  * Computes a SELECT statement which selects all the rows the @update_stmt would update. Beware
- * however that this GdaSqlStatement does not select anything (ie it would be rendered as "SELECT FROM ... WHERE ...")
+ * however that this #GdaSqlStatement does not select anything (ie it would be rendered as "SELECT FROM ... WHERE ...")
  * and before being usable, one needs to add some fields to actually select.
  *
  * Returns: a new #GdaStatement if no error occurred, or %NULL otherwise