XMLPRETTY(1) User Contributed Perl Documentation XMLPRETTY(1)NAMExmlpretty - XML pretty printer
SYNOPSISxmlpretty [--options] [filename]
DESCRIPTIONxmlpretty is the commandline interface to XML::Handler::YAWriter, act-
ing as a tool to add and remove pretty printing to XML files.
xmlpretty has several methods to add human readablitiy.
If you want to add readablity without adding so-called ignorable white-
space, use it in the following way :
$ xmlpretty--AddHiddenNewline \
--AddHiddenAttrTab \
--CatchEmptyElement \
uglyfile.xml > prettyfile.xml
If you do not want to process the file further, but only want it human
readable, add visible whitespace to the file as follows :
$ xmlpretty--PrettyWhiteNewline \
--PrettyWhiteIndent \
--CatchEmptyElement \
uglyfile.xml > prettyfile.xml
You may use YAWriter to clean whitespace from XML documents. This may
work in 99% of the cases where you want to get rid of ignorable white-
space caused by the various forms of pretty printing.
$ xmlpretty--NoWhiteSpace \
--NoComments \
--AddHiddenNewline \
--AddHiddenAttrTab \
--CatchEmptyElement \
prettyfile.xml > cleanfile.xml
Options
Options are given in a gnu like --option idiom.
AddHiddenNewline boolean
Add hidden newline before ">"
AddHiddenAttrTab boolean
Add hidden tabulation for attributes
CatchEmptyElement boolean
Catch empty Elements, apply "/>" compression
CatchWhiteSpace boolean
Catch whitespace with comments
IsSGML boolean
This option will cause start_document, processing_instruction and
doctype_decl to appear as SGML. The SGML is still well-formed of
course, if your SAX events are well-formed.
NoComments boolean
Supress Comments
NoDTD boolean
Supress DTD
NoPI boolean
Supress Processing Instructions
NoProlog boolean
Supress <?xml ... ?> Prolog
NoWhiteSpace boolean
Supress WhiteSpace to clean documents from prior pretty printing.
PrettyWhiteIndent boolean
Add visible indent before any eventstring
PrettyWhiteNewline boolean
Add visible newlines before any eventstring
SAX1 boolean (not yet implemented)
Output only SAX1 compilant eventstrings
Bugs:
Automatic recoding between 8bit and 16bit does not yet work correctly !
I have Perl-5.6 at home and here I can specify "use utf8;" in the right
places to make recoding work. But I dislike saying "use 5.00555;"
because many systems run 5.00503.
AUTHOR
Michael Koehne, Kraehe@Copyleft.De
Thanks
"Derksen, Eduard (Enno), CSCIO" <enno@att.com> helped me with the
Escape hash and gave quite a lot of usefull comments.
SEE ALSO
perl and XML::Parser::PerlSAX
perl v5.8.8 2000-06-20 XMLPRETTY(1)
