Package Name:   CGIFramework
Package Owner:  Dick Lam (rblam@watson.ibm.com)

Revision Level: 1.0

Summary:
        This is a set of cross-platform C++ classes for writing CGI programs.
        This collection of classes is unique because it is a FRAMEWORK rather
        than a library, and it is written with the Standard Template Library
        for portability.


Full Description:
        The CGIFramework provides a set of C++ classes that handle input,
        parsing, and output to enable the easy generation of Common Gateway
        Interface scripts for web servers.  You can easily write a CGI program
        by deriving one class from an abstract class that the framework
        provides. You then define a single method in your new class, and the
        framework does the rest of the work. Here is the complete main program
        for a CGI application using CGIFramework with your class, named
        myProc:

           // main.C
           #include <cgi/tappl.h>
           #include "myproc.h"
           int main()
           {
              cgiTApplication<myProc> app;
              app.run();
              return 0;
           }


        An HTML helper class is also provided. This class defines many
        iostream manipulators to make the generation of dynamic HTML pages
        easy within your derived classes.


Issues:
        The framework classes were written using ObjectSpace's STL<Toolkit>,
        but should work with other STL libraries as well.


Files:  The zip file should be unpacked with the -d option to restore the
        following directory structure:

                /include                Include files
                   /cgi
                /src                    Source code modules
                /test                   Test programs
                   /env
                   /noparse
                   /parse
                /lib                    Windows 95 library file
                /doc                    Documentation
