README file for html, a library that handles several CGI chores
Created by Douglas M. Auclair, dauclair@hotmail.com
Copyright (c) 2000, Douglas M. Auclair under the LGPL
(www.fsf.org/copyleft/lesser.html)
DESCRIPTION
===========
This library handles serveral file-parsing, string manipulation, and
http output that I find myself repeating for CGI executables I create.
Therefore, I've gathered these function into one library for general use.
SGML documentation may be forthcoming, but, fortunately as the sources are
small (God, I love functional languages), you may browse the sources in
lieu of that documentation.
In brief:
The file-parser module parses small files and assigns global variables
their values. A user may add their own files to parse by overriding
read-custom-metadata and by using the macro parse-string to create
small parser functions.
The strings module provides some helper functions for strings. Prominantly,
the function with takes a file name and scans the file, inserting the one
pertinant line into a function for handling.
The html module creates a standard top and bottom of an html file and allows
the user to fill in the middle sections with the generic function called middle.
INSTALLATION
============
* html is library only, other programs use it; it does not run by itself.
* unpack the tar file, and then
$ cd html
$ make
* Currently, other programs that use it expect it at the same directory
level. You may change this assumption by modify makefiles.