split-cdata-sections false

In the normalizeDocument() method of the Document interface in the
latest DOM core draft, we have the following text:

"split-cdata-sections"

    true
        [required] (default)
    Split CDATA sections containing the CDATA section termination marker
']]>'. When a CDATA section is split a warning is issued.false
        [required]
    Signal an error if a CDATASection contains an unrepresentable
character.


Clarity is needed about when the indicate warnings and error are
signalled. In particular, is this when normalizeDocument() is invoked?
when the document is serialized? some other time?

It's also not clear if such an error is somehow fatal. Such a node could
still be serialized by splitting the CDATA section when written into an
XML file or stream, even if it's not split in the document itself. 

-- 
+-----------------------+------------------------+-------------------+
| Elliotte Rusty Harold | elharo@metalab.unc.edu | Writer/Programmer |
+-----------------------+------------------------+-------------------+ 
|               Java I/O (O'Reilly & Associates, 1999)               |
|            http://www.ibiblio.org/javafaq/books/javaio/            |
|   http://www.amazon.com/exec/obidos/ISBN=1565924851/cafeaulaitA/   |
+----------------------------------+---------------------------------+
|  Read Cafe au Lait for Java News:  http://www.cafeaulait.org/      | 
|  Read Cafe con Leche for XML News: http://www.ibiblio.org/xml/     |
+----------------------------------+---------------------------------+

Received on Sunday, 20 January 2002 14:25:09 UTC