[libgda: 1/2] GdaBatch-Doc: Improving documentation



commit 7ec163245e68b81a4f9984922042ee890011e35c
Author: Pavlo Solntsev <p sun fun gmail com>
Date:   Fri Mar 20 14:50:28 2020 -0500

    GdaBatch-Doc: Improving documentation

 libgda/gda-batch.c | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)
---
diff --git a/libgda/gda-batch.c b/libgda/gda-batch.c
index 0701a7941..7bbf4497d 100644
--- a/libgda/gda-batch.c
+++ b/libgda/gda-batch.c
@@ -231,10 +231,11 @@ stmt_reset_cb (GdaStatement *stmt, GdaBatch *batch)
 /**
  * gda_batch_add_statement:
  * @batch: a #GdaBatch object
- * @stmt: a statement to add to @batch's statements list
+ * @stmt: (transfer full): a statement to add to @batch's statements list
  *
  * Add @stmt to the list of statements managed by @batch. A #GdaStatement object can be
- * added multiple times to a #GdaBatch object.
+ * added multiple times to a #GdaBatch object. The @batch increases reference count for @stmt and
+ * the @stmt instance can be freed using g_object_unref().
  */
 void
 gda_batch_add_statement (GdaBatch *batch, GdaStatement *stmt)
@@ -285,7 +286,7 @@ gda_batch_remove_statement (GdaBatch *batch, GdaStatement *stmt)
  *
  * Creates a string representing the contents of @batch.
  *
- * Returns: a string containing the serialized version of @batch
+ * Returns: (transfer full): a string containing the serialized version of @batch
  */
 gchar *
 gda_batch_serialize (GdaBatch *batch)


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