[pygtk] reference: pygtk-gtkdialog.xml: mark deprecated property and methods

[Dieter Verfaillie <dieterv src gnome org>]

commit 263fe7ee199e5504101b549d5dcc8017a9b6bded
Author: Dieter Verfaillie <dieterv optionexplicit be>
Date:   Tue Feb 22 17:09:31 2011 +0100

    reference: pygtk-gtkdialog.xml: mark deprecated property and methods

 docs/reference/pygtk-gtkdialog.xml |   19 +++++++++++++++++--
 1 files changed, 17 insertions(+), 2 deletions(-)
---
diff --git a/docs/reference/pygtk-gtkdialog.xml b/docs/reference/pygtk-gtkdialog.xml
index cc55202..c5c1cbe 100644
--- a/docs/reference/pygtk-gtkdialog.xml
+++ b/docs/reference/pygtk-gtkdialog.xml
@@ -135,8 +135,9 @@
             <row valign="top">
               <entry>"has-separator"</entry>
               <entry>Read/Write</entry>
-        <entry>If <literal>True</literal>, the dialog has a separator bar
-above its buttons</entry>
+              <entry>If <literal>True</literal>, the dialog has a separator bar above its
+              buttons. This property has been deprecated since GTK+ 2.22 and should not
+              be used in newly-written code.</entry>
           </row>
 
         </tbody>
@@ -581,6 +582,13 @@ dialog.destroy()
         </varlistentry>
       </variablelist>
 
+      <warning>
+        <para>
+          This method is deprecated in PyGTK 2.22 and above and should not be
+          used in newly-written code.
+        </para>
+      </warning>
+
       <para>The <methodname>set_has_separator</methodname>() method sets the
       "has-separator" property to the value of <parameter>setting</parameter>. If
       <parameter>setting</parameter> is <literal>True</literal> (the default
@@ -603,6 +611,13 @@ dialog.destroy()
         </varlistentry>
       </variablelist>
 
+      <warning>
+        <para>
+          This method is deprecated in PyGTK 2.22 and above and should not be
+          used in newly-written code.
+        </para>
+      </warning>
+
       <para>The <methodname>get_has_separator</methodname>() method returns
       the value of the "has-separator" property.</para>