Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
XMLPRETTY(1)	      User Contributed Perl Documentation	  XMLPRETTY(1)

NAME
       xmlpretty - XML pretty printer

SYNOPSIS
	 xmlpretty [--options] [filename]

DESCRIPTION
       xmlpretty is the	commandline interface to XML::Handler::YAWriter,
       acting 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
       whitespace, 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
       whitespace 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.24.1			  2000-06-20			  XMLPRETTY(1)

NAME | SYNOPSIS | DESCRIPTION | AUTHOR | Thanks | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=xmlpretty&sektion=1&manpath=FreeBSD+12.1-RELEASE+and+Ports>

home | help