#
# Copyright (c) Xerox Corporation 1997, 1998. All rights reserved.
#
# License is granted to copy, to use, and to make and to use derivative
# works, provided that Xerox is acknowledged in all documentation
# pertaining to any such copy or derivative work. Xerox grants no other
# licenses expressed or implied. The Xerox trade name should not be used
# in any advertising without its written permission.
#
# XEROX CORPORATION MAKES NO REPRESENTATIONS CONCERNING EITHER THE
# MERCHANTABILITY OF THIS SOFTWARE OR THE SUITABILITY OF THIS SOFTWARE
# FOR ANY PARTICULAR PURPOSE.  The software is provided "as is" without
# express or implied warranty of any kind.
#
# These notices must be retained in any copies of any part of this software.
#


If you do not plan to make changes to htmlmaker:

 IGNORE THIS DIRECTORY.
THIS DIRECTORY IS ONLY FOR THE BENEFIT OF THOSE WHO WANT TO MODIFY
THE HTMLMAKER PROGRAM.

If you want to understand how htmlmaker works or want to change some
features of htmlmaker, this directory may be helpful to you.

This directory contains the source for htmlmaker, broken up into
small, modular pieces.  The build_htmlmaker script will paste all the pieces
together and strip out comments to produce a single htmlmaker file.

This is not the best way to develop software...  basically it is the idea
of Perl modules applied in a confused manner.   The thinking (or lack of
it) is as follows:

the htmlmaker should be one, self contained file.  this makes it easy to
 move htmlmaker around, eliminates problems of finding modules/libraries,
 and generally makes for a nicer package for people to install and use.

the htmlmaker code would be more understandable if it came is small modules
 instead of one large, self contained file.  rather than digging through 
 hundreds of lines of code, one could just look at the relevant module.
 the module would be small enough to be easily understood and thus easily 
 modified.

so the result is what you see here...  this directory contains the small
pieces that make up htmlmaker.  the build_htmlmaker script pastes all
the pieces together into one big file.  looking at htmlmaker as these
small pieces may make it easier to change htmlmaker.
 


