dtd2html - generate HTML files to support hypertext navi- gation of an SGML DTD

dtd2html [options] file ...

dtd2html builds a group of linked HTML documents which contain all of the entities and elements in the Document Type Definition (DTD) whose filename is given as an argument. In particular, for each element, including the top-most element in the DTD, dtd2html generates an HTML document containing:

•

a Content list for element, i.e., a list of all the elements that can be included within element. Each item in this list is hyperlinked to another HTML document describing it.

•

an Exclusion list for element, i.e., a list of all the elements that are disallowed within element.

•

a link to a document listing the Attributes of element.

•

a link to a document giving the Content declaration of element. This is not just another listing of the Content elements, but a prescription for the frequency with which the allowed Content elements can and/or must be included.

•

a list of the allowable tag minimizations for element, i.e., whether a start tag is required or is optional, and whether an end tag is required, optional, or disallowed for element.

dtd2html is one of a suite of tools available in the perlSGML package, which together help one inspect, study, and edit if necessary, an SGML Document Type Definitions (DTD). The package was written by Earl Hood (ehood@medusa.acs.uci.edu).

This manual page was written for the Debian GNU/Linux distribution because the original program does not have a manual page. Instead, it has documentation in the HTML format; see below.

A partial summary of options is included below. For a complete description, see the HTML files.

-help

Show summary of options.

-verbose

Print status messages to STDERR on what dtd2html is doing. This option generates much output, and is used mainly for debugging purposes.

-outdir dirname

Write the (many!) files to dirname rather than the current directory.

dtddiff (1), dtdtree (1), dtdview (1), and stripsgml (1). These commands, as well as perlSGML's library of Perl modules for parsing of the SGML DTD's are documented fully by The perlSGML Manual (link to URL http://www.oac.uci.edu/indiv/ehood/perlSGML/doc/html/perlSGML.html) .

This manual page was written by Susan G. Kleinmann sgk@debian.org for the Debian GNU/Linux system (but may be used by others).

Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.1 or any later version published by the Free Software Foundation; with no Invariant Sections, no Front-Cover Texts and no Back-Cover Texts. A copy of the license can be found under /usr/share/common-licenses/FDL.