[Bug 24451] editorial comments on LCWD

https://www.w3.org/Bugs/Public/show_bug.cgi?id=24451

Liam R E Quin <liam@w3.org> changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
             Status|CLOSED                      |REOPENED
         Resolution|FIXED                       |---

--- Comment #17 from Liam R E Quin <liam@w3.org> ---
Sorry to do this to you! but...

"be the only node of the element" isn't actually technically correct - not
being pedantic here, but because the *only* nodes in the picture are DOM nodes
(XML files do not have nodes and feither do HTML files), so you have written,
in effect,
    Even when there is only one DOM node in the constructed tree there may
still be more than one DOM node in the constructed tree.

I don't see how to implement or test for that assertion.

So what you want instead is,
[[
Because an author may need to comment out the CDATA "start tag" and "end tag,"
polyglot markup allows plain text before and after the CDATA section. The
following example generates three DOM nodes: one text node before the CDATA
section, one for the CDATA section, itself, and one after the CDATA section: 

Fig. 5 CDATA section that is commented out, resulting in a total of three DOM
nodes.

Example 12
<script>/*<![CDATA[*/
    foo 
    /*]]>*/</script>

]]

The contradictory "This,..." statement should just be removed:
[[
Thus, a CDATA section may appear at the beginning of its containing element,
span the entire element, be the only node of the element, and yet still
generate more than one DOM node. Polyglot markup therefore permits content that
results in a single DOM node before and/or after the CDATA section.
]]
as it tries to restate something but ends up not quite correct. I don't think
we need to come to agreement on the "Thus" paragraph if we've agreed on the
text before the example (except I added the word DOM in front of node, and
"generate", to try and reduce the confusion).

Thanks.

-- 
You are receiving this mail because:
You are the QA Contact for the bug.

Received on Thursday, 27 March 2014 19:27:09 UTC