			PyGG: PyGTK and Glade
	(C) 2005 Franck Pommereau <pommereau@univ-paris12.fr>

    This library is free software; you can redistribute it and/or
    modify it under the terms of the GNU Lesser General Public License
    as published by the Free Software Foundation; either version 2.1
    of the License, or (at your option) any later version.

    This library is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
    Lesser General Public License for more details.

    You should have received a copy of the GNU Lesser General Public
    License along with this library; if not, write to the Free
    Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
    02110-1301 USA


WHAT IS PyGG?
=============

PyGG is a Python module intended to ease the usage of Glade with
PyGTK. It handles (almost) transparently the loading of Glade files
and the connection of callbacks.


INSTALLATION
============

Unpack the distribution archive, change to the directory PyGG-VERSION
and run one of the following commands:

    # install to default location (usually /usr)
    python setup.py install
    # install to /usr/local
    python setup.py install --prefix=/usr/local
    # get additional help
    python setup.py install --help


USAGE
=====

A PyGG object is a GTK widget together with its callbacks. It is
created from two parts:

 - a GTK widget called MyPygg, which should be defined in a Glade file
   named mypygg.glade, this file may define other widgets

 - a sub-class of one of the PyGG classes (Window, AppWindow, Dialog
   or Widget) named MyPygg and having methods corresponding to the
   callbacks defined in mypygg.glade

Creating an instance of the class MyPygg will load mypygg.glade and
create an attribute MyPygg in the instance, referring to the widget
MyPygg. The other widgets will be available as attributes (the name of
the widget being that of the attribute). The attributes of the widget
MyPygg will be available as attributes of the instances of MyPygg.

A global variable called "sources" in the module pygg allows to
specify where Glade files should be searched for. By calling
pygg.sources.add("location"), you can add a new location which can be
a Glade file, a directory or a ZIP file. In, the two later cases, all
the Glade files found in the location are taken into account.

A companion tool called pygg-stub.py allows to create sample PyGG
classes from Glade files, having all the required callbacks.

See the source code (doc-strings and comments) and the example
(helloworld.glade and helloworld.py) for further details.


CONTRIBUTORS
============

Leandro Lameiro <lameiro@gmail.com>
