README for htmlpp

htmlpp is a simple HTML pretty printer, based on "nsgmls" and SGMLS.pm.  The
code is pretty alpha, but gives attractive results for most HTML docs.
Note however that nested tables are not rendered very prettily, and other
deeply-nested structures may render badly as well.

Since htmlpp gets its input from nsgmls, invalid documents should not be
expected to work.  However, a side effect of this approach is that
minor errors and inconsistencies are actually fixed:  attributes are
always quoted, characters like < and > and & are converted into the
appropriate SGML entities in attribute values and in document text,
and end tags are inserted automatically.


PREREQUISITES:

	First you must install James Clark's SP package, available at
	<http://www.jclark.com/sp/> to get the parser nsgmls.

	Next you need David Megginson's SGMLS.pm package, available
	from the nearest CPAN archive.

	Finally, you need the Text::Format Perl package, available from
	CPAN.

INSTALLATION:

	tar xvzf htmlpp-0.1.tar.gz
	cd htmlpp-0.1
	./configure && make install

USE:

	htmlpp is pretty simple to use.  It accepts input on stdin, or
	from the file specified as a command-line argument.  The
	prettified output is directed to stdout.

CONTACT:

	Send any patches, bugs, complaints, free beer, etc to me.
	Len Budney <lbudney@pobox.com>

