README for bonobo-python.

bonobo-python
-------------
Bonobo-python is python bindings for bonobo, oaf and nautilus.
For an introduction to bonobo read Miguel's excellent document
at http://www.ximian.com/tech/bonobo.php3.

Installation
------------

If you unfamiliar with the build process and usage of configure 
please read INSTALL before continue.

Requirements:

Package         Version                 Where?
=============================================================================
python          1.5.2, 2.0, 2.1         http://www.python.org
orbit-python    0.3.0                   http://orbit-python.sault.org
gnome-python    1.4.0                   ftp.gnome.org
ORBit           0.5.7                   ftp.gnome.org
oaf             0.6.4                   ftp.gnome.org
bonobo          1.0.0                   ftp.gnome.org

And if you wish to install nautilus support you'll need
nautilus 1.0.0 or higher. On debian libnautilus and libnautilus-dev is
sufficied.

If you install bonobo-python (and orbit-python) in a non standard prefix
(eg, not /usr or /usr/local) you must set the following environment 
variables in .bashrc (or .cshrc etc):

export PYTHONPATH=$PYTHONPATH:$PREFIX/lib/python1.5/site-packages
export IDLPATH=$IDLPATH:$PREFIX/share/idl

And please change version number if you don't use python 1.5.

If you wish to see debug messages when you run the small testprograms, kill
OAFD and:
export OAF_DEBUG_OUTPUT=1

You can find a few samples in the samples directory.

Problems
--------
Q: I get this error when i'm trying to run a bonobo-python script:
   "ImportError: No module named bonobo"
A: You forgot to set your PYTHONPATH to point to the correct dir.
   use find to find bonobo.py and set PYTHONPATH accordingly.

Q: I'm trying to load a dynamic idl file and get this error
   "ImportError: No module named Bonobo"
A: You forgot to set your IDLPATH to point to the correct dir.
   Under some circumstances you'll need to restart oafd to make
   the changed take effect.

Q: How can i quit my bonobo-python program? Sometimes it stops and
   Ctrl-C won't work
A: Try Ctrl-4 or Ctrl-\. Unfortunately this creates a core.

Author
------
Johan Dahlin <zilch.am@home.se>
