reference: pygtk-gtkcombobox.xml: mark deprecated methods and functions

1 files changed, 41 insertions, 5 deletions

diff --git a/docs/reference/pygtk-gtkcombobox.xml b/docs/reference/pygtk-gtkcombobox.xml
index b9f4d721..e7a5987a 100644
--- a/docs/reference/pygtk-gtkcombobox.xml
+++ b/docs/reference/pygtk-gtkcombobox.xml
@@ -995,9 +995,15 @@ associated with the combo box.</para>
       </variablelist>
 
       <note>
-	<para>This method is available in PyGTK 2.4 and above.</para>
+        <para>This method is available in PyGTK 2.4 and above.</para>
       </note>
 
+      <warning>
+        <para>This method is deprecated since PyGTK 2.24 and should not be used in newly-written code.
+        Use <link linkend="class-gtkcomboboxtext"><classname>gtk.ComboBoxText</classname></link>
+        instead.</para>
+      </warning>
+
       <para>The <methodname>append_text</methodname>() method appends the
 string specified by <parameter>text</parameter> to the list of strings
 stored in the combo box <link
@@ -1031,9 +1037,15 @@ function.</para>
       </variablelist>
 
       <note>
-	<para>This method is available in PyGTK 2.4 and above.</para>
+        <para>This method is available in PyGTK 2.4 and above.</para>
       </note>
 
+      <warning>
+        <para>This method is deprecated since PyGTK 2.24 and should not be used in newly-written code.
+        Use <link linkend="class-gtkcomboboxtext"><classname>gtk.ComboBoxText</classname></link>
+        instead.</para>
+      </warning>
+
       <para>The <methodname>insert_text</methodname>() method inserts the
 string specified by <parameter>text</parameter> in the combo box <link
 linkend="class-gtkliststore"><classname>gtk.ListStore</classname></link> at
@@ -1059,9 +1071,15 @@ function.</para>
       </variablelist>
 
       <note>
-	<para>This method is available in PyGTK 2.4 and above.</para>
+        <para>This method is available in PyGTK 2.4 and above.</para>
       </note>
 
+      <warning>
+        <para>This method is deprecated since PyGTK 2.24 and should not be used in newly-written code.
+        Use <link linkend="class-gtkcomboboxtext"><classname>gtk.ComboBoxText</classname></link>
+        instead.</para>
+      </warning>
+
       <para>The <methodname>prepend_text</methodname>() method prepends the
 string specified by <parameter>text</parameter> to the list of strings
 stored in the <link
@@ -1088,9 +1106,15 @@ function.</para>
       </variablelist>
 
       <note>
-	<para>This method is available in PyGTK 2.4 and above.</para>
+        <para>This method is available in PyGTK 2.4 and above.</para>
       </note>
 
+      <warning>
+        <para>This method is deprecated since PyGTK 2.24 and should not be used in newly-written code.
+        Use <link linkend="class-gtkcomboboxtext"><classname>gtk.ComboBoxText</classname></link>
+        instead.</para>
+      </warning>
+
       <para>The <methodname>remove_text</methodname>() method removes the
 string at the index specified by <parameter>position</parameter> in the
 associated <link
@@ -1117,9 +1141,15 @@ function.</para>
       </variablelist>
 
       <note>
-	<para>This method is available in PyGTK 2.6 and above.</para>
+        <para>This method is available in PyGTK 2.6 and above.</para>
       </note>
 
+      <warning>
+        <para>This method is deprecated since PyGTK 2.24 and should not be used in newly-written code.
+        Use <link linkend="class-gtkcomboboxtext"><classname>gtk.ComboBoxText</classname></link>
+        instead.</para>
+      </warning>
+
       <para>The <methodname>get_active_text</methodname>() method returns
 the currently active string or <literal>None</literal> if no entry is
 selected. Note that you can only use this function with combo boxes
@@ -1451,6 +1481,12 @@ box grabs focus when clicked with the mouse.</para>
 	<para>This function is available in PyGTK 2.4 and above.</para>
       </note>
 
+      <warning>
+        <para>This function is deprecated since PyGTK 2.24 and should not be used in newly-written code.
+        Use <link linkend="class-gtkcomboboxtext"><classname>gtk.ComboBoxText</classname></link>
+        instead.</para>
+      </warning>
+
       <para>The <function>gtk.combo_box_new_text</function>() function is a
 convenience function that constructs a new text combo box, which is a <link
 linkend="class-gtkcombobox"><classname>gtk.ComboBox</classname></link> just