SYNOPSIS

  dtdflatten [options]

DESCRIPTION

dtdflatten parses a \s-1DTD\s0 and prints out a flatten/expanded version of it with all parameter entities expanded.

The first non-option-related argument provided on the command-line specifies the file to parse. If no filename is given, then the \s-1DTD\s0 is read from standard input.

The flatten \s-1DTD\s0 is printed to standard output unless the \*(C`--output\*(C' option is specified.

OPTIONS

--catalog <catalog>

Specify catalog files to parse for resolving external entity references. This option can be specified multiple times. \s-1NOTE:\s0 Currently, only \s-1SGML\s0 Open Catalog format is supported. \s-1XML\s0 Catalog support is not implemented (yet).

--debug

Extra debugging output. This option can be specified multiple times to increase the amount of output. Debugging output is sent to standard error.

--declaration <file>

Specify the \s-1SGML\s0 declaration. The \s-1SGML\s0 declaration is parsed to determine the type of \s-1DTD\s0 being parsed, \s-1XML\s0 or \s-1SGML\s0. The key parts of the \s-1SGML\s0 declaration examined are the \s-1NAMECASE\s0 and \s-1CHARSET\s0 directives to determine the \s-1DTD\s0 type. If no \s-1SGML\s0 declaration is available, the \*(C`--xml\*(C', \*(C`--namecase-general\*(C', and \*(C`--namecase-entity\*(C' options can be used.

--output <file>

Output file. If not specified, standard output is used.

--preserve <entity-name>

Preserve parameter entity declaration denoted by <entity-name>. This option can be specified multiple times. Note, if <entity-name> matches any portion of a parameter entity, the parameter entity declaration will be preserved.

--verbose
--noverbose

Print parsing progress. By default, this option is enabled. Verbose output is sent to standard error. If \*(C`--debug\*(C' is specified, then this option is automatically enabled.

--version

Print version and synopsis.

--help

Print synopsis and options available.

--man

Print manual page.

RELATED TO dtdflatten…

dtdparse

See SGML::DTDParse for an overview of the DTDParse package.

PREREQUISITES

Getopt::Long, Text::DelimMatch, XML::Parser

AVAILABILITY

<http://dtdparse.sourceforge.net/>

AUTHORS

Originally developed by Norman Walsh, <[email protected]>.

Earl Hood <[email protected]> picked up support and maintenance.

COPYRIGHT AND LICENSE

See SGML::DTDParse for copyright and license information.