GNU-Paperclips the FSF Servlet Engine - README
----------------------------------------------

Like most FSF products Paperclips is designed to be:

o small
o fast
o highly extensible

We're aiming for complete Scheme integration into the webserver. 
We also want you to be able to build highly unusual configurations 
out of Paperclips. To that end the API is designed to be as easy 
to use as possible.


Building and Running
--------------------
Instructions for building Paperclips are in the INSTALL file in this
directory. The file also includes a quick-start guide to get Paperclips 
up and running.


This Directory
--------------
INSTALL     	- how to compile and run Paperclips
README      	- this file
Makefile.in	- the autoconf build script template
configure.in	- the autoconf template
configure	- the autoconf script
doc/AUTHORS	- list of authors of Paperclips
doc/FAQ		- the beginnings of an FAQ on Paperclips
doc/SPEC_TESTS  - a list of tests (as we think of them) that will be usefull
doc/TODO        - a list of the things we need to do before 2.3 release
doc/description - the FSF free software directory entry for Paperclips
lib/		- where jars used by paperclips are stored
mime.types	- mime types registry for Paperclips
servlets/	- is used for storing servlet classes
source/		- the source code
warpath/ 	- some sample webapps are stored here.
www/		- Paperclips website


This README file
----------------
Is a work in progress. If you want to help please let, Nic Ferrier,
know. I can be contacted at: nferrier@tapsellferrier.co.uk


About the javax.servlet classes
-------------------------------
(this note might need to go somewhere else...)

Paperclips includes a free version of Sun's Servlet API from the
GNU-ClasspathX project, you can find the ClasspathX project at:

  http://www.gnu.org/software/classpathx/

Many thanks to Paul Siegmann who started the project to build a free
version of Sun's servlet classes. He did a lot of work and we thank
him. Thanks also to Mark Wielaard who helped Paul.



How you can help
----------------

Documentation: we need the README and the INSTALL file made bullet proof.
We also need help in creating simple documentation for the website.

Coding: there's lots of different things you can do. 

o If you're interested in HTTP you can look at Paperclips 
  HTTP implementation.

o If you're interested in networking you might want to help with the session
  load balancing work.



$Author: nferrier $
$Date: 2002/02/13 01:41:38 $

