[libgda] Doc improvements

[Vivien Malerba <vivien src gnome org>]

commit c6e3955af4253365db25aa8af3ceba81b9c99a1e
Author: Vivien Malerba <malerba gnome-db org>
Date:   Thu Apr 10 20:51:56 2014 +0200

    Doc improvements

 libgda/gda-connection.c |    4 ++++
 1 files changed, 4 insertions(+), 0 deletions(-)
---
diff --git a/libgda/gda-connection.c b/libgda/gda-connection.c
index ba2e8ab..9a7fa59 100644
--- a/libgda/gda-connection.c
+++ b/libgda/gda-connection.c
@@ -1610,6 +1610,8 @@ _gda_connection_set_status (GdaConnection *cnc, GdaConnectionStatus status)
  * status.
  *
  * To cancel the effect, use _gda_connection_status_stop_batch().
+ *
+ * WARNING: @cnc _MUST_ be locked before this function is called
  */
 void
 _gda_connection_status_start_batch (GdaConnection *cnc, GdaConnectionStatus status)
@@ -1628,6 +1630,8 @@ _gda_connection_status_start_batch (GdaConnection *cnc, GdaConnectionStatus stat
  * See _gda_connection_status_start_batch().
  *
  * This functions ensures that the connections's status is IDLE.
+ *
+ * WARNING: @cnc _MUST_ be locked before this function is called
  */
 void
 _gda_connection_status_stop_batch (GdaConnection *cnc)