2Package Utilities

This module provides definitions to easily create PLaneT packages
along with their documentation (using the automatic scribble parser,
see Scribble Definition Parser).

All the functions of this module are meant to be used
when current-directory is correctly set to the
directory of your package. This is generally true when evaluating
a file of your package in DrScheme.

Creates a environment suitable for calling the functions of this module,
by setting the package-username, major-version, minor-version and
package-name parameters to the given values.
Call this function before any other if you want to change the default values
of the parameters.

Launches the "planet" executable with the "create" option.
The package file is put in the parent directory of the package.
Using the planet executable seems to provide more debug info than
make-planet-archive.

Writes the main ".scrbl" file in the dir directory with a table of contents.
If exists is 'error, write-main-doc only displays
a warning and does not overwrite the file.
If modules have been added to the package since the last
execution of (planet-build),
either the user should delete the main file so that it will be rewritten,
or the user should add the inclusion of the modules himself in the
main file.

Calls write-main-src on main-src, write-main-doc on main-doc,
if they are provided.
Calls write-info if info? is #t, and creates the documentation
directory dir if it does not already exist.

(Re)writes the ".scrbl" file for all other ".ss" or ".scm" file
in the directory (but not in sub-directories), without warning.
An exception list of files that must not be included
in the process can be given through except.