reference: pygtk-gtkbutton.xml: mark deprecated methods and signals

1 files changed, 48 insertions, 0 deletions

diff --git a/docs/reference/pygtk-gtkbutton.xml b/docs/reference/pygtk-gtkbutton.xml
index 59e28787..0117fb37 100644
--- a/docs/reference/pygtk-gtkbutton.xml
+++ b/docs/reference/pygtk-gtkbutton.xml
@@ -558,6 +558,12 @@ with the <keycap>Alt</keycap> key. In PyGTK 2.4 and above the
 	  <methodname>pressed</methodname>
 	  <methodparam></methodparam>  </methodsynopsis></programlisting>
 
+      <warning>
+        <para>This method is deprecated since PyGTK 2.22 and should not be used in newly-written code.
+        Use the "<link linkend="signal-gtkwidget--button-press-event">button-press-event</link>"
+        signal.</para>
+      </warning>
+
       <para>The <methodname>pressed</methodname>() method emits the
 "pressed" signal to the button.</para>
 
@@ -570,6 +576,12 @@ with the <keycap>Alt</keycap> key. In PyGTK 2.4 and above the
 	  <methodname>released</methodname>
 	  <methodparam></methodparam>  </methodsynopsis></programlisting>
 
+      <warning>
+        <para>This method is deprecated since PyGTK 2.22 and should not be used in newly-written code.
+        Use the "<link linkend="signal-gtkwidget--button-release-event">button-release-event</link>"
+        signal.</para>
+      </warning>
+
       <para>The <methodname>released</methodname>() method emits the
 "released" signal to the button.</para>
 
@@ -594,6 +606,12 @@ with the <keycap>Alt</keycap> key. In PyGTK 2.4 and above the
 	  <methodname>enter</methodname>
 	  <methodparam></methodparam>  </methodsynopsis></programlisting>
 
+      <warning>
+        <para>This method is deprecated since PyGTK 2.22 and should not be used in newly-written code.
+        Use the "<link linkend="signal-gtkwidget--enter-notify-event">enter-notify-event</link>"
+        signal.</para>
+      </warning>
+
       <para>The <methodname>enter</methodname>() method emits the "enter"
 signal to the button.</para>
 
@@ -606,6 +624,12 @@ signal to the button.</para>
 	  <methodname>leave</methodname>
 	  <methodparam></methodparam>  </methodsynopsis></programlisting>
 
+      <warning>
+        <para>This method is deprecated since PyGTK 2.22 and should not be used in newly-written code.
+        Use the "<link linkend="signal-gtkwidget--leave-notify-event">leave-notify-event</link>"
+        signal.</para>
+      </warning>
+
       <para>The <methodname>leave</methodname>() method emits the "leave"
 signal to the button.</para>
 
@@ -1173,6 +1197,12 @@ any)</simpara></listitem>
 	</varlistentry>
       </variablelist>
 
+      <warning>
+        <para>This signal is deprecated since GTK+ 2.8 and should not be used in newly-written code.
+        Use the "<link linkend="signal-gtkwidget--enter-notify-event">enter-notify-event</link>"
+        signal.</para>
+      </warning>
+
       <para>The "enter" signal is emitted when the pointer enters the
 button.</para>
 
@@ -1208,6 +1238,12 @@ any)</simpara></listitem>
 	</varlistentry>
       </variablelist>
 
+      <warning>
+        <para>This signal is deprecated since GTK+ 2.8 and should not be used in newly-written code.
+        Use the "<link linkend="signal-gtkwidget--leave-notify-event">leave-notify-event</link>"
+        signal.</para>
+      </warning>
+
       <para>The "leave" signal is emitted when the pointer leaves the
 button.</para>
 
@@ -1243,6 +1279,12 @@ any)</simpara></listitem>
 	</varlistentry>
       </variablelist>
 
+      <warning>
+        <para>This signal is deprecated since GTK+ 2.8 and should not be used in newly-written code.
+        Use the "<link linkend="signal-gtkwidget--button-press-event">button-press-event</link>"
+        signal.</para>
+      </warning>
+
       <para>The "pressed" signal is emitted when the mouse button is pressed
 while the pointer is over the button.</para>
 
@@ -1278,6 +1320,12 @@ any)</simpara></listitem>
 	</varlistentry>
       </variablelist>
 
+      <warning>
+        <para>This signal is deprecated since GTK+ 2.8 and should not be used in newly-written code.
+        Use the "<link linkend="signal-gtkwidget--button-release-event">button-release-event</link>"
+        signal.</para>
+      </warning>
+
       <para>The "released" signal is emitted when the button is released no
 matter where the pointer is.</para>