The Easibox File Format
=======================

By Philip Hunt, last altered 17-Oct-2001.

Easibox files understand these directives:


*** boxFormats = ['tar.gz']

Which box formats to use

*** archiveDestination = "~/box/"

what directory to put the result in 

*** keepDirectories = 1

Archiving produces a list of directories containing a copy of the data
to be archhived and duplicating the data structure. If this flag is set, 
don't delete them after producing the box files.

*** packageName

String variable containing package name, e.g. "leafwa"

*** packageVer

String variable containing package version, e.g. "0.6.1"

*** userName

The user name that the easibox process is running as. Taken from
the environment variable USER

*** include("src/*.h")

Include a file or list of files

*** exclude("MY_NOTES")

Exclude a file or list of files

*** prerun("make clean")

Run before archiving

*** postrun("echo DONE IT")

Run after archiving

*** getBoxFilenames()

Returns a list of the full pathnames of all the box files that Easibox
will produce during this invocation. This might be used, for example,
to copy the archive files into a directory, as here:

# write archive files to a directory:
for box in getBoxFilenames():
   postrun("cp %s ~philh/proj/www_ca/oss/stes/" % box)

