NAME

ecd2xml - converts text in ECD format to an XML equivalent

SYNOPSIS

ecd2xml

[OPTION]... [FILE]...

ecd2xml

[OPTION]... < STDIN > STDOUT

DESCRIPTION

ecd2xml is a script that takes ECD data (whether it be in a file or a stream), and turns it into XML. The benefit of this is buzzword compliance and faster parsing. James Clark's expat can parse busybox.xecd 60 times faster than Embedix::ECD's Parse::RecDescent parser can parse busybox.ecd. expat is probably more robust than the parser I made, too.

OPTIONS

-h

--help

This displays the help text.

-s n

-sw n

--shiftwidth n

This sets the number of spaces to indent for each new nesting level in the XML document. The default value is 2.

-i n

--indent n

This sets the number of spaces to indent the whole XML document. The default value is 2.

-a

--autowrite

Instead of printing the XML document to STDOUT, the document will be written to a file of the same name as that being worked on w/ the exception that its extension will be ".xecd" instead of ".ecd".

This option is meaningless when working with an ECD coming in from STDIN.

-k

--keepcomments

This will preserve the comments in the ECD by turning them into XML comments. The downside of this is that although the generated XML will be well-formed, it will not be valid according to the DTD.

DIAGNOSTICS

$line: was expecting $TAGNAME, but found $CRAP instead.

This error occurs whenever an imbalanced tag is found.

$line: $ATTRIBUTE not allowed in $NODE_TYPE

not implemented

REQUIRES

Embedix::ECD

Embedix::ECD::XMLv1

Pod::Usage

Getopt::Long

SEE ALSO

related perl modules

Embedix::ECD(3pm), Embedix::ECD::XMLv1(3pm)

some programs of interest

xmllint(1), checkecd(1)

AUTHOR

John BEPPU <beppu@lineo.com>