dtdto - Convert an XML DTD to a variety of XML representations.
dtdto [ --help ] [ --debug level ] [ --valid | --dtd | [ ( --html | ( --docbook [ --top-element element-name ] [ --top-id id-string ] ) ) [ --title title-string ] [ --anchor-prefix prefix-string ] ] ] [ input-file [ output-file ] ]
dtdto constructs an XML representation of an XML DTD if one of the --valid, --dtd, --html, or --docbook arguments is not specified. If the --html or --docbook argument is specified, this intermediate XML representation is converted into documentation in HTML or Docbook format respectively. Within the DTD, any comment directly followed by a line break and an element declaration is considered to be applicable to that element, and will be included as such in the documentation. A similar convention is applied for entity declarations, except that a comment directly following an entity declaration, with no separating line break, is also considered to be applicable to that entity. If the --valid argument is specified, dtdto constructs an XSLT stylesheet for validating an XML document with respect to the DTD.
Display usage information.
Set debugging level. Default value is 0, with larger integers signifying more detailed debugging information.
Generate an XSLT stylesheet for validating an XML document with respect to the DTD.
Convert the intermediate XML representation back to a DTD. Mainly useful for debugging.
Convert the intermediate XML representation to DTD documentation in HTML format.
Convert the intermediate XML representation to DTD documentation in Docbook format. Note that this output is intended for inclusion within a Docbook document, and is not itself a valid Docbook document.
Set the Docbook top level element.
Set the id attribute of the Docbook top level element.
Set the output document title.
Define a prefix for internal link anchors.
The XML::DTD library has not yet been rigorously tested, and may fail to correctly parse some DTDs. External entities are not yet resolved, so DTDs consisting of multiple included sections will not be properly handled.
The XSLT validation (generated when the --valid argument is specified) is currently only partial: child elements are confirmed to conform to the content model of their parent, but there is no checking for spurious text nodes in a non-mixed content model, and attributes are not checked at all.
This software is made available under the terms of the GNU General Public License (version 2 or later).
This utility is part of the XML::DTD Perl module, available from http://search.cpan.org/~wohl/XML-DTD/.
Brendt Wohlberg <wohl@cpan.org>
To install XML::DTD, copy and paste the appropriate command in to your terminal.
cpanm
cpanm XML::DTD
CPAN shell
perl -MCPAN -e shell install XML::DTD
For more information on module installation, please visit the detailed CPAN module installation guide.