sourCEntral - mobile manpages

pdf

DTD2HTML

NAME

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

SYNOPSIS

dtd2html [options] file ...

DESCRIPTION

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 AT medusa DOT acs DOT uci DOT 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.

OPTIONS

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.

SEE ALSO

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)
.

AUTHOR

This manual page was written by Susan G. Kleinmann sgk AT debian DOT 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.

pdf