[libgda/LIBGDA_4.0] Documentation corrections, fixed bug #597390

[Vivien Malerba <vivien src gnome org>]

commit d9a4afa8a2b1b2ea189c296f7ccf1ad033f83a8d
Author: Vivien Malerba <malerba gnome-db org>
Date:   Wed Oct 7 18:25:35 2009 +0200

    Documentation corrections, fixed bug #597390

 libgda/gda-value.c |    7 +++++++
 1 files changed, 7 insertions(+), 0 deletions(-)
---
diff --git a/libgda/gda-value.c b/libgda/gda-value.c
index fa7721b..a52c839 100644
--- a/libgda/gda-value.c
+++ b/libgda/gda-value.c
@@ -2490,6 +2490,13 @@ gda_ushort_get_type (void) {
  * where "xyz" is the octal representation of the byte, and the '\' (backslash) character
  * is converted to "\\".
  *
+ * Note that the backslash and newline characters are considered as printable characters and
+ * will not be represented by the "\xyz" representation.
+ *
+ * Use this function to get a representation as much readable by humans as possible of a binary
+ * chunk. Note that this function is internally called when transforming a binary value to
+ * a string for example when using g_value_transform() or gda_value_stringify().
+ *
  * Returns: a new string from @bin
  */
 gchar *