[libgda/LIBGDA_4.2] Doc. improvement, for bug #567891

[Vivien Malerba <vivien src gnome org>]

commit fd9cdf2c819d0e0d905d933a32ad7015f50e8fb0
Author: Vivien Malerba <malerba gnome-db org>
Date:   Sun Oct 30 20:19:28 2011 +0100

    Doc. improvement, for bug #567891

 libgda/gda-data-model.c |    4 +++-
 1 files changed, 3 insertions(+), 1 deletions(-)
---
diff --git a/libgda/gda-data-model.c b/libgda/gda-data-model.c
index 0b00fbe..a9fcbb8 100644
--- a/libgda/gda-data-model.c
+++ b/libgda/gda-data-model.c
@@ -850,7 +850,9 @@ gda_data_model_set_values (GdaDataModel *model, gint row, GList *values, GError
  * the data model from being destroyed).
  *
  * Depending on the data model's implementation, a new #GdaDataModelIter object may be created,
- * or a reference to an already existing #GdaDataModelIter may be returned.
+ * or a reference to an already existing #GdaDataModelIter may be returned. For example if @model only
+ * supports being accessed using a forward moving cursor (say a the result of a SELECT executed by SQLite
+ * with a cursor access mode specified), then this method will always return the same iterator.
  *
  * If a new #GdaDataModelIter is created, then the row it represents is undefined.
  *