diff -r 8b87ea768cb8 -r 60053dab7e2a dummy_foundation/lib/XML/DOM/Text.pod --- a/dummy_foundation/lib/XML/DOM/Text.pod Wed Jun 03 18:33:51 2009 +0100 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,60 +0,0 @@ -=head1 NAME - -XML::DOM::Text - A piece of XML text in XML::DOM - -=head1 DESCRIPTION - -XML::DOM::Text extends L, which extends -L. - -The Text interface represents the textual content (termed character -data in XML) of an Element or Attr. If there is no markup inside an -element's content, the text is contained in a single object -implementing the Text interface that is the only child of the element. -If there is markup, it is parsed into a list of elements and Text nodes -that form the list of children of the element. - -When a document is first made available via the DOM, there is only one -Text node for each block of text. Users may create adjacent Text nodes -that represent the contents of a given element without any intervening -markup, but should be aware that there is no way to represent the -separations between these nodes in XML or HTML, so they will not (in -general) persist between DOM editing sessions. The normalize() method -on Element merges any such adjacent Text objects into a single node for -each block of text; this is recommended before employing operations -that depend on a particular document structure, such as navigation with -XPointers. - -=head2 METHODS - -=over 4 - -=item splitText (offset) - -Breaks this Text node into two Text nodes at the specified -offset, keeping both in the tree as siblings. This node then -only contains all the content up to the offset point. And a -new Text node, which is inserted as the next sibling of this -node, contains all the content at and after the offset point. - -Parameters: - I The offset at which to split, starting from 0. - -Return Value: The new Text node. - -DOMExceptions: - -=over 4 - -=item * INDEX_SIZE_ERR - -Raised if the specified offset is negative or greater than the number of -characters in data. - -=item * NO_MODIFICATION_ALLOWED_ERR - -Raised if this node is readonly. - -=back - -=back