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.