NAME

dtd2html - Generate a HTML documentation from a DTD

SYNOPSYS

dtd2html [-b | -f] [-C | -M] [-Z] [-o filename] [-t title] xml_file

OPTIONS

-b

Enable the book mode generation.

-C

Suppress all comments.

-f

Enable the frame mode generation.

-M

Suppress multi comments, preserve the last.

-o

Specify the HTML filename to create.

-t

Specify the title of the resulting HTML file.

-Z

Delete zombi element (without parent).

DESCRIPTION

dtd2html is a front-end for XML::Handler::Dtd2Html and its subclasses. It uses them to generate HTML documentation from DTD source.

Because it uses XML::Parser and an external DTD is not a valid XML document, the input source must be an XML document with an internal DTD or an XML document that refers to an external DTD.

The goal of this tool is to increase the level of documentation in DTD and to supply a more readable format for DTD.

It is a tool for DTD users, not for writer.

All comments before a declaration are captured.

All entity references inside attribute values are expanded.

This tool needs XML::Parser::PerlSAX (libxml-perl) and XML::Parser modules.

XML::Parser::PerlSAX v0.07 needs to be patched (PerlSAX.patch).

BUGS & PROBLEMS

XML names are case sensitive, when the file system isn't, there are trouble and confusion in book mode (an example is HTML entities on Windows).

SEE ALSO

PerlSAX.pod(3), XML::Handler::Dtd2Html

Extensible Markup Language (XML) <http://www.w3c.org/TR/REC-xml>

AUTHOR

Francois PERRAD, francois.perrad@gadz.org

COPYRIGHT

This program is distributed under the Artistic License.