Hello and welcome to your friendly site generation script
for your favorite Microsoft OLE 2 Compound Document format
port to pure Java: Apache Jakarta POI...oh my.  

You site generation and copy script will give you love and 
affection, not to mention happy lovely regenerated upon 
demand editions of the POI website copied to the destination
of your choice...but only if you give it a little attention 
up front.

To configure the happy site regeneration script, place it in
a subdirectory all its own.  It's friendly and kind and loving
but it needs its own personal space if you get my drift.  Having
too many other files (which it likes just fine) all near it
makes it wheezy.  Okay it will probably work fine but it's just
its personal preference.  The happy site regenration script 
needs to run under as a user (if kicked off via cron) that has
full rwx permissions to that directory.

The happy site regeneration script has a "partner" that its very
close to.  It won't be happy unless its living in the same 
subdirectory as it.  Its called sitescript.config (where the main
script is called sitescript.sh).  

You'll need to provide a little personal information up front by
editing sitescript.config (they have an open relationship) and 
setting things like your CVSROOT, id on the destination server and
some paths.  Make sure all of these exist and have the proper 
permission settings before proceeding.

You'll also need to make sure the ssh runs in a non-interactive
mode (the script feels above ssh and prefers to just bark orders
at ssh without answering stupid questions like "whats your password?".

What does this do?

The script gets the latest and greatest edition of jakarta-poi module
from the specified cvs root, goes into the created directory, executes
the clean docs and site targets, tar.bz2's it up, scp's it over and 
then untars it into the place you set it to.  You tell it via the 
config all the user info, the destination on the server for the 
archive and the destination for the unzipped site.

Thats about all.
