System requirements
-------------------

	phpannodex has been tested specifically for the following versions
	of PHP and Apache, but should work with any PHP 5 and Apache 2. This
	installation, relying as it does on make, is tailored for *nix systems.

	* PHP 5.0.5
	* Apache 2.0.55
	* libannodex


What does it do?
----------------

phpannodex is an extension for PHP that provides object oriented PHP wrappings
for libannodex, a C library for manipulating Annodex media. For more details
about the annodex format, see http://www.annodex.net/

phpannodex consists of two main parts. The phpannodex core is a set of C 
functions that wrap around the libannodex functions and make them visible to
PHP. The phpannodex classes are PHP5 classes that provide an object oriented
API for dealing with the phpannodex core.


Building and installing
----------------------
	* cd to the "src" directory.
	* "phpize"
	* "./configure"
	* "make"/"make install"
	* restart Apache
	
	This will install the phpannodex extension core.

	* Copy the "phpannodex" directory into php's include 
	  path. This will usually be "/usr/local/lib/php" on *nix systems. Note
	  that if you are building phpannodex from a subversion checkout there
	  will be a bunch of svn files in the "phpannodex" directory that you
	  should ensure you do not copy across.

	This will make the phpannodex classes visible to all your php 
	applications, including the phpannodex-cgi.  


Known problems
--------------

PHP seems to have trouble finding the phpannodex core functions when PHP was
installed using apt-get. There may be some issue with where PHP is looking for
extensions. When PHP is built from source this does not seem to happen.

