pygtk-docs r801 - in trunk/2.0: . tut

[esr svn gnome org]

Author: esr
Date: Tue Oct 21 19:36:38 2008
New Revision: 801
URL: http://svn.gnome.org/viewvc/pygtk-docs?rev=801&view=rev

Log:
Minor improvements, see the Changelog diff.


Added:
   trunk/2.0/README
Modified:
   trunk/2.0/ChangeLog
   trunk/2.0/tut/GettingStarted.xml

Added: trunk/2.0/README
==============================================================================
--- (empty file)
+++ trunk/2.0/README	Tue Oct 21 19:36:38 2008
@@ -0,0 +1,14 @@
+The PyGTK Tutorial is maintained in XML-DocBook.  To build an HTML version, 
+simply do:
+
+    make tut-html
+
+When adding an example, put it in the examples subdirectory.  Be aware
+that a link to it in the generate HTML will 404 until you remake the
+links in pygtktutorial/examples.  The easiest way to forcxe this is to
+do:
+
+   make clean; make tut-html
+
+The numbering on the in-line displays of the examples is done with nl(1),
+no options.

Modified: trunk/2.0/tut/GettingStarted.xml
==============================================================================
--- trunk/2.0/tut/GettingStarted.xml	(original)
+++ trunk/2.0/tut/GettingStarted.xml	Tue Oct 21 19:36:38 2008
@@ -334,16 +334,10 @@
 <programlisting>
   handler_id = object.connect_object(name, func, slot_object)
 </programlisting>
-      <para><methodname>connect_object</methodname>() is the same as
-<methodname>connect</methodname>() except a callback function only uses one
-argument and a callback method, two arguments:</para>
-
-<programlisting>
-  def callback_func(object)
-  def callback_meth(self, object)
-</programlisting>
-
-      <para>where <parameter>object</parameter> is usually a widget.
+      <para><methodname>connect_object</methodname>() is like
+<methodname>connect</methodname>(), except that it invokes
+<parameter>func</parameter> on <parameter>slot_object</parameter>,
+where <parameter>slot_object</parameter> is usually a widget.
 <methodname>connect_object</methodname>() allows the PyGTK widget methods
 that only take a single argument (<parameter>self</parameter>) to be used as
 signal handlers.</para>
@@ -659,6 +653,12 @@
     self.window.show()
 </programlisting>
 
+<para>Widgets also have a <methodname>hide()</methodname> that is the
+opposite of <methodname>show()</methodname>.  It doesn't actually
+destroy the widget, but it removes the widget renderining from your
+display.  This can be reversed with another
+<methodname>show()</methodname> call.</para>
+
       <para>Lines 73-75 define the <methodname>main</methodname>() method
 which calls the <function>gtk.main</function>() function</para>