NAME

XML::Grove::AsCanonXML - output XML objects in canonical XML

SYNOPSIS

use XML::Grove::AsCanonXML;

$string = $xml_object->as_canon_xml OPTIONS;

$writer = new XML::Grove::AsCanonXML OPTIONS;

# OPTIONS
$writer->comments([$bool]);

$string = $writer->as_canon_xml($xml_object);
$writer->as_canon_xml($xml_object, $file_handle);

DESCRIPTION

XML::Grove::AsCanonXML will return a string or write a stream of canonical XML for an XML object and it's content (if any).

XML::Grove::AsCanonXML objects hold the options used for writing the XML objects. Options can be supplied when the the object is created,

$writer = new XML::Grove::AsCanonXML comments => 1;

or modified at any time before writing an XML object using the methods defined below.

OPTIONS

$writer->comments( [$bool] )

By default comments are not written to the output. Setting comment to TRUE will include comments in the output.

AUTHOR

Ken MacLeod, ken@bitsko.slc.ut.us

SEE ALSO

perl(1), XML::Parser(3), XML::Grove(3).

James Clark's Canonical XML definition <http://www.jclark.com/xml/canonxml.html>