[libgda] GIR: Updates for documentation and new QuarkList.protect_values()

[Daniel Espinosa Ortiz <despinosa src gnome org>]

commit bf8118ae17441394d5dfa668fa19a26eefbfb877
Author: Daniel Espinosa <despinosa src gnome org>
Date:   Thu May 3 10:26:46 2012 -0500

    GIR: Updates for documentation and new QuarkList.protect_values()

 libgda/Gda-5.0.gir     |   17 +++++++++++++----
 libgda/libgda-5.0.vapi |    1 +
 2 files changed, 14 insertions(+), 4 deletions(-)
---
diff --git a/libgda/Gda-5.0.gir b/libgda/Gda-5.0.gir
index 5ca8398..312b12d 100644
--- a/libgda/Gda-5.0.gir
+++ b/libgda/Gda-5.0.gir
@@ -12448,11 +12448,11 @@ the new pairs.</doc>
         </return-value>
       </method>
       <method name="find" c:identifier="gda_quark_list_find">
-        <doc xml:whitespace="preserve">Searches for the value identified by @name in the given #GdaQuarkList.
-
-if not found.</doc>
+        <doc xml:whitespace="preserve">Searches for the value identified by @name in the given #GdaQuarkList. For protected values
+(authentification data), don't forget to call gda_quark_list_protect_values() when you
+don't need them anymore (when needed again, they will be unmangled again).</doc>
         <return-value transfer-ownership="none">
-          <doc xml:whitespace="preserve">the value associated with the given key if found, or %NULL</doc>
+          <doc xml:whitespace="preserve">the value associated with the given key if found, or %NULL if not found.</doc>
           <type name="utf8" c:type="gchar*"/>
         </return-value>
         <parameters>
@@ -12488,6 +12488,15 @@ of each pair, and the given user_data parameter. @qlist may not be modified whil
           <type name="none" c:type="void"/>
         </return-value>
       </method>
+      <method name="protect_values"
+              c:identifier="gda_quark_list_protect_values"
+              version="5.2.0">
+        <doc xml:whitespace="preserve">Call this function to get rid of the clear version of the value associated to
+ name </doc>
+        <return-value transfer-ownership="none">
+          <type name="none" c:type="void"/>
+        </return-value>
+      </method>
       <method name="remove" c:identifier="gda_quark_list_remove">
         <doc xml:whitespace="preserve">Removes an entry from the #GdaQuarkList, given its name.</doc>
         <return-value transfer-ownership="none">
diff --git a/libgda/libgda-5.0.vapi b/libgda/libgda-5.0.vapi
index 750dc62..047a93a 100644
--- a/libgda/libgda-5.0.vapi
+++ b/libgda/libgda-5.0.vapi
@@ -705,6 +705,7 @@ namespace Gda {
 		public void free ();
 		[CCode (has_construct_function = false)]
 		public QuarkList.from_string (string string);
+		public void protect_values ();
 		public void remove (string name);
 	}
 	[CCode (cheader_filename = "libgda/libgda.h", type_id = "gda_repetitive_statement_get_type ()")]