From 13a4e948175fedadbee0138c5a95300562378204 Mon Sep 17 00:00:00 2001
From: John Finlay <finlay@src.gnome.org>
Date: Sun, 29 May 2005 17:12:50 +0000
Subject: correct description of buttons param. (Sridhar Ratna)

	* pygtk-gtkdialog.xml (add_buttons): correct description of buttons
	param. (Sridhar Ratna)
---
 docs/reference/ChangeLog           |  5 +++++
 docs/reference/pygtk-gtkdialog.xml | 18 +++++++++++++-----
 2 files changed, 18 insertions(+), 5 deletions(-)

diff --git a/docs/reference/ChangeLog b/docs/reference/ChangeLog
index bd379277..6ccd7c4c 100644
--- a/docs/reference/ChangeLog
+++ b/docs/reference/ChangeLog
@@ -1,3 +1,8 @@
+2005-05-29  John Finlay  <finlay@moeraki.com>
+
+	* pygtk-gtkdialog.xml (add_buttons): correct description of buttons
+	param. (Sridhar Ratna)
+
 2005-05-26  John Finlay  <finlay@moeraki.com>
 
 	* pygtk-gtkwindow.xml (set_keep_abaove, set_keep_below, move): 
diff --git a/docs/reference/pygtk-gtkdialog.xml b/docs/reference/pygtk-gtkdialog.xml
index 5356473e..355523f9 100644
--- a/docs/reference/pygtk-gtkdialog.xml
+++ b/docs/reference/pygtk-gtkdialog.xml
@@ -476,8 +476,8 @@ you don't need it.</para>
       <variablelist>
 	<varlistentry>
 	  <term><parameter>buttons</parameter>&nbsp;:</term>
-	  <listitem><simpara>a tuple containing 2-tuples each containing
-button text (or stock ID) and a response id</simpara></listitem>
+	  <listitem><simpara>a tuple containing one or more pairs of button
+specifiers: button text (or stock ID) and a response id</simpara></listitem>
 	</varlistentry>
       </variablelist>
 
@@ -486,9 +486,17 @@ buttons to the <link
 linkend="class-gtkdialog"><classname>gtk.Dialog</classname></link> using the
 data specified in <parameter>buttons</parameter>. This method is the same as
 calling the <link
-linkend="method-gtkdialog--add-button"><methodname>gtk.Dialog.add_button</methodname>()</link> 
-repeatedly. buttons is a tuple containing 2-tuples specifying the data for
-one button - button text and a response ID integer.</para>
+linkend="method-gtkdialog--add-button"><methodname>gtk.Dialog.add_button</methodname>()</link>
+repeatedly. <parameter>buttons</parameter> is a tuple containing button data
+pairs - button text (or stock ID) and a response ID integer. For
+example:</para>
+
+      <programlisting>
+  dialog.add_buttons((gtk.STOCK_OPEN, 42, "Close", gtk.RESPONSE_CLOSE))
+</programlisting>
+
+      <para>will add "Open" and "Close" buttons to
+<parameter>dialog</parameter></para>.
 
     </refsect2>
 
-- 
cgit v1.2.1