File	Date	Author	Commit
HTMLObject	2001-10-06	pcxuser	[2a6a47] Added a \n before the </body> tag so that we ha...
examples	2001-10-06	pcxuser	[8495c5] This is a copy of debug.cgi but it tests HTMLOb...
Changes	2001-10-06	pcxuser	[78fa5a] Added info about the debug capabilities just ad...
LICENSE	2001-08-15	pcxuser	[0d2ab2] Initial revision
MANIFEST	2001-10-06	pcxuser	[c9e9af] Added debug2.cgi to the distro.
Makefile.PL	2001-10-06	pcxuser	[5b0d09] Updated version being built.
README	2001-10-06	pcxuser	[5062da] Added note about debug2.cgi.
TODO	2001-08-15	pcxuser	[0d2ab2] Initial revision
documentation.html	2001-08-15	pcxuser	[0d2ab2] Initial revision
htmlobject.spec	2001-10-06	pcxuser	[62fc17] Updated to v 2.11.
test.pl	2001-08-15	pcxuser	[0d2ab2] Initial revision

Read Me

HTMLObject README
Created by James A. Pattie
PC & Web Xperience, Inc.
http://www.pcxperience.com/

Installation:
tar xvzf html_object-VERSION.tar.gz
perl Makefile.PL
make
make test
su (if not root)
make install

Internationalization support is now being implemented.  The lang and charset
values are being set now and default to lang=en, charset=iso-8859-1.  The
JavaScript Error Handler is currently the only part of the module that it is
possible to internationalize.  If anyone is interested in making different
language versions of the default error handling code, please contact me and I'll
be happy to work out how it needs to be done, etc.

In the examples directory, the lang.cgi script allows you to test the 
Internationalization support that is being implemented in the HTMLObject module.
Copy lang.cgi, en_lang.pm, and eu_lang.pm to a directory that allows
you to run cgi scripts.  This is usually /home/httpd/cgi-bin in a RedHat 6.x
install or /var/www/cgi-bin in RedHat 7.x.  The Basque language is only being
used as a test case where the strings are still english but have been pre-pended
with *** to allow me to test whether or not the code is working.  This is just
an example of how you could use the HTMLObject to implement multiple languages
support.  If anyone can think of a better implementation, please let me know.

The sessions.cgi script demos using Apache::Session for storing session info.
A database (sessions) needs to be created with the sessions table.  If using
postgresql (which is what the demo uses), su to postgres, then create the 
database via:
	createdb sessions

And then create the necessary table via:
	psql sessions < sessions.pgsql

The sessions.pgsql file is in the examples directory.
To run this sample program you need Apache::Session version 1.53 or greater 
installed.

The non-buffered.cgi script tests the Base.pm Modules non-Buffering support.
The non-buffered2.cgi script tests the Normal.pm Modules non-Buffering support.

The debug.cgi script tests the Base.pm Modules debug error handling code.
The debug2.cgi script tests the Normal.pm Modules debug error handling code.

The HTMLObject::WAP module will generate HDML 3 or WML 1.1 documents for use
in a WAP environment.  WMLScript 1.1 will be added in the future.

See Changes file for latest changes to the HTMLObject's.

NOTE: As of 2.06 Steven Brenner's cgi-lib.pl script is now available as
HTMLObject::CGILib.  It still functions exactly the same way and the same
modifications I previously made to make it mod_perl safe are still there.
The modified version I created is still available in the examples directory but
all sample programs have been modified to use the HTMLObject::CGILib version.

The file upload capability of the CGILib module only works from 2.10 onward!