DragonFly On-Line Manual Pages

Search: Section:  

DTDFLATTEN(1)         User Contributed Perl Documentation        DTDFLATTEN(1)


NAME

       dtdflatten - Flatten an SGML/XML DTD.


SYNOPSIS

         dtdflatten [options]


DESCRIPTION

       dtdflatten parses a DTD 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 DTD is
       read from standard input.

       The flatten DTD is printed to standard output unless the "--output"
       option is specified.


OPTIONS

       --catalog <catalog>
           Specify catalog files to parse for resolving external entity
           references.  This option can be specified multiple times.

           NOTE: Currently, only SGML Open Catalog format is supported.  XML
           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 SGML declaration.  The SGML declaration is parsed to
           determine the type of DTD being parsed, XML or SGML.  The key parts
           of the SGML declaration examined are the NAMECASE and CHARSET
           directives to determine the DTD type.

           If no SGML declaration is available, the "--xml",
           "--namecase-general", and "--namecase-entity" 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 "--debug" is specified, then this option is automatically
           enabled.

       --version
           Print version and synopsis.

       --help
           Print synopsis and options available.

       --man
           Print manual page.


SEE ALSO

       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, <ndw@nwalsh.com>.

       Earl Hood <earl@earlhood.com> picked up support and maintenance.


COPYRIGHT AND LICENSE

       See SGML::DTDParse for copyright and license information.

perl v5.20.2                      2005-07-16                     DTDFLATTEN(1)

Search: Section: