Prerequisites
-------------

Compile and install the papaya package.

Compilation of Plugins
----------------------

Create a symbolic link from the papaya-plugins directory called 'h' to
the papaya/src/h directory.

For example:

  ln -s ../papaya/src/h h

Then run:

./configure --with-interface=gnome --enable-all

If you used the GTK interface in the papaya package, then use:

./configure --with-interface=gtk --enable-all

And for gnome2:

./configure --with-interface=gnome2 --enable-all

Then type 'make' and hope.

The configure script will install the plugins into the same location
as ../h/version.h defines PREFIX to be.

Type 'make install' (probably as root if you install in /usr/local)

When you start Papaya you will be asked if you want to enable each plugin, so
don't worry about compiling them all.

Location of Plugins
-------------------

Plugins can be installed in one of two locations:

  $PREFIX/share/papaya/plugins
  $HOME/.papaya/plugins

If one plugin is in both locations, behaviour may be erratic if both are
enabled.  You can enable/disable them individually by using the
About->Plugins dialog.

Creation of Plugins
-------------------

Anyone with some basic C++ programming knowledge can create a plugin for Papaya.
See the API documentation in doc/PLUGIN and the existing plugins for help.

Plugins can also be created in Python, if the PythonPlugin is compiled and
installed.  See doc/PythonPlugin and the python plugins in contrib/ for help.

Submission of Plugins
---------------------

If you have written a plugin you would like to see included in Papaya's plugin
distribution, email the plugin source to c.allen@lancaster.ac.uk with the
following information:

  o License under which the plugin is released.
  o Any copyright information - eg Copyright (C) 2001 Catherine Allen
  o Accompanying documentation - how to use the plugin.

If you have written a plugin, but don't want it in the main Papaya distribution
and are able to host it on your own webpage, I can create a link to it from
the main Papaya page.
