From 7462e87134bbe4a477e1c01701e431da80680fa7 Mon Sep 17 00:00:00 2001
From: Antoine Pitrou <solipsis@pitrou.net>
Date: Sat, 3 Dec 2011 20:59:24 +0100
Subject: [PATCH] Mention the new GTK+ 3 bindings.

---
 Doc/faq/gui.rst          |  8 ++++++--
 Doc/library/othergui.rst | 16 +++++++++++-----
 2 files changed, 17 insertions(+), 7 deletions(-)

diff --git a/Doc/faq/gui.rst b/Doc/faq/gui.rst
index e502ef81e85..f697cd3c512 100644
--- a/Doc/faq/gui.rst
+++ b/Doc/faq/gui.rst
@@ -68,8 +68,12 @@ are available from `Nokia <http://qt.nokia.com/>`_.
 Gtk+
 ----
 
-PyGtk bindings for the `Gtk+ toolkit <http://www.gtk.org>`_ have been
-implemented by James Henstridge; see <http://www.pygtk.org>.
+The `GObject introspection bindings <https://live.gnome.org/PyGObject>`_
+for Python allow you to write GTK+ 3 applications.  There is also a
+`Python GTK+ 3 Tutorial <http://python-gtk-3-tutorial.readthedocs.org/en/latest/>`_.
+
+The older PyGtk bindings for the `Gtk+ 2 toolkit <http://www.gtk.org>`_ have
+been implemented by James Henstridge; see <http://www.pygtk.org>.
 
 FLTK
 ----
diff --git a/Doc/library/othergui.rst b/Doc/library/othergui.rst
index 1f4aed73d13..5e3535887a6 100644
--- a/Doc/library/othergui.rst
+++ b/Doc/library/othergui.rst
@@ -34,11 +34,17 @@ also available for Python:
 
 .. seealso::
 
-   `PyGTK <http://www.pygtk.org/>`_
-      is a set of bindings for the `GTK <http://www.gtk.org/>`_ widget set. It
-      provides an object oriented interface that is slightly higher level than
-      the C one. It comes with many more widgets than Tkinter provides, and has
-      good Python-specific reference documentation. There are also bindings to
+   `PyGObject <https://live.gnome.org/PyGObject>`_
+      provides introspection bindings for C libraries using
+      `GObject <http://developer.gnome.org/gobject/stable/>`_.  One of
+      these libraries is the `GTK+ 3 <http://www.gtk.org/>`_ widget set.
+      GTK+ comes with many more widgets than Tkinter provides.  An online
+      `Python GTK+ 3 Tutorial <http://python-gtk-3-tutorial.readthedocs.org/en/latest/>`_
+      is available.
+
+      `PyGTK <http://www.pygtk.org/>`_ provides bindings for an older version
+      of the library, GTK+ 2.  It provides an object oriented interface that
+      is slightly higher level than the C one.  There are also bindings to
       `GNOME <http://www.gnome.org>`_.  One well known PyGTK application is
       `PythonCAD <http://www.pythoncad.org/>`_. An online `tutorial
       <http://www.pygtk.org/pygtk2tutorial/index.html>`_ is available.