README for Cocoa Implementation of PPlot
-----------------------------------------
Author:        Drew McCormack
Created:       8th November, 2002
Last Modified: 4th October, 2003

The Cocoa implementation of PPlot has been created for Mac OS X 10.2. It is built 
using Project Builder.

A PPlot framework project has been created. The PPlot framework is designed to be 
embedded in an application's "Frameworks" directory. Before you can create an 
application based on PPlot, you need to build the PPlot framework using Project
Builder. You then add a copy phase to your application target which copies the
PPlot framework into your application bundle when the application is built. 

Two different targets are supplied in the PPlot framework project: one includes 
python wrapping, and the other doesn't. If you want to use python wrapping, 
you need to install 'swig'. You can use fink to do this 
(http://fink.sourceforge.net/). The project assumes that
swig is installed in '/sw/bin/swig', where fink installs it; if you have 
installed in a different directory, you will need to modify the shell script
build phase which runs swig to use the correct path.

The "Example" directory contains a sample project for an application. This can be
used to see how to setup the Copy Phase in your own application project. You can
see PPlot at work by building the Example project, but only if you have built
the PPlot framework first.

The "PPlotX" directory is a sample project using python wrapping. You need to
have built the PPlotPython framework before you can build this project. It
shows how you can embed python scripts in your cocoa apps, to control pplot
views.

