diff -r 8b87ea768cb8 -r 60053dab7e2a dummy_foundation/lib/XML/DOM/CDATASection.pod --- a/dummy_foundation/lib/XML/DOM/CDATASection.pod Wed Jun 03 18:33:51 2009 +0100 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,31 +0,0 @@ -=head1 NAME - -XML::DOM::CDATASection - Escaping XML text blocks in XML::DOM - -=head1 DESCRIPTION - -XML::DOM::CDATASection extends L which extends -L. - -CDATA sections are used to escape blocks of text containing characters -that would otherwise be regarded as markup. The only delimiter that is -recognized in a CDATA section is the "]]>" string that ends the CDATA -section. CDATA sections can not be nested. The primary purpose is for -including material such as XML fragments, without needing to escape all -the delimiters. - -The DOMString attribute of the Text node holds the text that is -contained by the CDATA section. Note that this may contain characters -that need to be escaped outside of CDATA sections and that, depending -on the character encoding ("charset") chosen for serialization, it may -be impossible to write out some characters as part of a CDATA section. - -The CDATASection interface inherits the CharacterData interface through -the Text interface. Adjacent CDATASections nodes are not merged by use -of the Element.normalize() method. - -B XML::DOM::Parser and XML::DOM::ValParser convert all CDATASections -to regular text by default. -To preserve CDATASections, set the parser option KeepCDATA to 1. - -