Bug#688228: python-gi: Add README.Debian explaining how to get information on the python bindings

[Osamu Aoki]

Package: python-gi
Version: 3.2.2-1
Severity: important

Library without availability of the definitive refrence information may become
not as useful as it should be.  If one wish to use this package, there is no
pointer to such information now.

Please consider to add following information to this package as
README.Debian.

=====
PyGObject binding for GTK+3 is provided through this python-gi package.
Programs using this Python binding are started with "from gi.repository
import Gtk".

Tutorial is available as "The Python GTK+ 3 Tutorial" at:
 http://python-gtk-3-tutorial.readthedocs.org/en/latest/

Unfortunately, as of 2012 on Debian wheezy, we can not find good
reference documentations of GTK+3 and its related libraries for Python.

We can create a usable reference documentation of GTK+3 and related
libraries by yourself using the g-ir-doc-tool command from the
gobject-introspection package as explained in GObject Introspection
Doctools. (https://live.gnome.org/GObjectIntrospection/Doctools)

 $ g-ir-doc-tool --language Python -o ./output_dir /usr/share/gir-1.0/Gtk-3.0.gir
 $ yelp ./output_dir/index.page

There are new GTK+3 Python codes using PyGObject such as accerciser,
caribou-preferences, gdebi-gtk, gnome-shell-timer-config, software-center, and
software-properties-gtk providing us with good examples.

=====

I was playing with new GTK+3 programing as shown in
 http://people.debian.org/~osamu/fun2prog.html#_gtk_3

I thought having some pointer should have reduced my learning time :-)

-- System Information:
Debian Release: wheezy/sid
  APT prefers unstable
  APT policy: (500, 'unstable'), (500, 'testing'), (10, 'experimental')
Architecture: amd64 (x86_64)
Foreign Architectures: i386

Kernel: Linux 3.5-trunk-amd64 (SMP w/8 CPU cores)
Locale: LANG=en_US.utf8, LC_CTYPE=en_US.utf8 (charmap=UTF-8)
Shell: /bin/sh linked to /bin/dash

Versions of packages python-gi depends on:
ii  gir1.2-glib-2.0        1.32.1-1
ii  libc6                  2.13-35
ii  libffi5                3.0.10-3
ii  libgirepository-1.0-1  1.32.1-1
ii  libglib2.0-0           2.33.12+really2.32.3-2
ii  python                 2.7.3-2
ii  python2.6              2.6.8-0.2
ii  python2.7              2.7.3-5

python-gi recommends no packages.

Versions of packages python-gi suggests:
ii  python-gi-cairo  3.2.2-1

-- no debconf information