- From: Eliot Graff via cvs-syncmail <cvsmail@w3.org>
- Date: Thu, 24 Jun 2010 21:16:22 +0000
- To: public-html-commits@w3.org
Update of /sources/public/html5/html-xhtml-author-guide
In directory hutz:/tmp/cvs-serv29341
Modified Files:
html-xhtml-authoring-guide.html
Log Message:
Fixed validation in "In-line Script and Style"; edited XML declaration as forbidden, per bug 9963;
Index: html-xhtml-authoring-guide.html
===================================================================
RCS file: /sources/public/html5/html-xhtml-author-guide/html-xhtml-authoring-guide.html,v
retrieving revision 1.20
retrieving revision 1.21
diff -u -d -r1.20 -r1.21
--- html-xhtml-authoring-guide.html 23 Jun 2010 17:18:07 -0000 1.20
+++ html-xhtml-authoring-guide.html 24 Jun 2010 21:16:20 -0000 1.21
@@ -20,26 +20,23 @@
src="html-xhtml-authoring-guide_files/w3c_home.png" alt="W3C" width="72"
height="48"></a></p><h1 class="title" id="title">Polyglot Markup:
HTML-Compatible XHTML Documents</h1><h2
-id="w3c-editor-s-draft-21-june-2010"><acronym title="World Wide Web
-Consortium">W3C</acronym> Editor's Draft 21 June 2010</h2><dl><dt>This
-version:</dt><dd><a
+id="w3c-editor-s-draft-24-june-2010">W3C Editor's Draft 24 June 2010</h2><dl><dt>This
+ version:</dt><dd><a
href="http://dev.w3.org/html5/html-xhtml-author-guide/html-xhtml-authoring-guide.html">http://dev.w3.org/html5/html-xhtml-author-guide/html-xhtml-authoring-guide.html</a></dd><dt>Latest
- published version:</dt><dd><a href="http://www.w3.org/TR/xxx-xxx/">http://www.w3.org/TR/xxx-xxx/</a></dd><dt>Latest
+ published version:</dt><dd><a
+href="http://www.w3.org/TR/html-polyglot/">http://www.w3.org/TR/html-polyglot/</a></dd><dt>Latest
editor's draft:</dt><dd><a
href="http://dev.w3.org/html5/html-xhtml-author-guide/html-xhtml-authoring-guide.html">http://dev.w3.org/html5/html-xhtml-author-guide/html-xhtml-authoring-guide.html</a></dd><dt>Previous
version:</dt><dd>none</dd><dt>Editor:</dt><dd>Eliot Graff, Microsoft
Corporation</dd></dl><p class="copyright"><a
href="http://www.w3.org/Consortium/Legal/ipr-notice#Copyright">Copyright</a>
© 2010 <a href="http://www.w3.org/"><acronym title="World Wide Web
-Consortium"><acronym title="World Wide Web Consortium">W3C</acronym></acronym></a><sup>®</sup>
- (<a href="http://www.csail.mit.edu/"><acronym title="Massachusetts
-Institute of Technology"><acronym title="Massachusetts Institute of
-Technology">MIT</acronym></acronym></a>, <a href="http://www.ercim.eu/"><acronym
- title="European Research Consortium for Informatics and Mathematics"><acronym
- title="European Research Consortium for Informatics and Mathematics">ERCIM</acronym></acronym></a>,
- <a href="http://www.keio.ac.jp/">Keio</a>), All Rights Reserved. <acronym
- title="World Wide Web Consortium">W3C</acronym> <a
-href="http://www.w3.org/Consortium/Legal/ipr-notice#Legal_Disclaimer">liability</a>,
+Consortium">W3C</acronym></a><sup>®</sup> (<a
+href="http://www.csail.mit.edu/"><acronym title="Massachusetts Institute
+ of Technology">MIT</acronym></a>, <a href="http://www.ercim.eu/"><acronym
+ title="European Research Consortium for Informatics and Mathematics">ERCIM</acronym></a>,
+ <a href="http://www.keio.ac.jp/">Keio</a>), All Rights Reserved. W3C <a
+ href="http://www.w3.org/Consortium/Legal/ipr-notice#Legal_Disclaimer">liability</a>,
<a href="http://www.w3.org/Consortium/Legal/ipr-notice#W3C_Trademarks">trademark</a>
and <a href="http://www.w3.org/Consortium/Legal/copyright-documents">document
use</a> rules apply.</p><hr></div>
@@ -61,10 +58,9 @@
</div><div id="sotd" class="introductory section"><h2>Status of This
Document</h2><p><em>This section describes the status of this document
at the time of its publication. Other documents may supersede this
-document. A list of current <acronym title="World Wide Web Consortium">W3C</acronym>
- publications and the latest revision of this technical report can be
-found in the <a href="http://www.w3.org/TR/"><acronym title="World Wide
-Web Consortium">W3C</acronym> technical reports index</a> at
+document. A list of current W3C publications and the latest revision of
+this technical report can be found in the <a
+href="http://www.w3.org/TR/">W3C technical reports index</a> at
http://www.w3.org/TR/.</em></p>
<p>This document summarizes design guidelines for authors who wish
their XHTML or HTML documents to validate on either HTML or XML
@@ -80,32 +76,27 @@
href="#bib-RFC2854" rel="biblioentry" class="bibref">RFC2854</a>].
</p>
<p>This document was published by the <a
-href="http://www.w3.org/html/wg/"><acronym title="World Wide Web
-Consortium">W3C</acronym> HTML</a> as an Editor's Draft. If you wish to
-make comments regarding this document, please send them to <a
-href="mailto:public-html@w3.org">public-html@w3.org</a> (<a
+href="http://www.w3.org/html/wg/">W3C HTML</a> as an Editor's Draft. If
+you wish to make comments regarding this document, please send them to <a
+ href="mailto:public-html@w3.org">public-html@w3.org</a> (<a
href="mailto:public-html-request@w3.org?subject=subscribe">subscribe</a>,
<a href="http://lists.w3.org/Archives/Public/public-html/">archives</a>).
All feedback is welcome.</p><p>Publication as a Editor's Draft does not
- imply endorsement by the <acronym title="World Wide Web Consortium">W3C</acronym>
- Membership. This is a draft document and may be updated, replaced or
-obsoleted by other documents at any time. It is inappropriate to cite
-this document as other than work in progress.</p><p>This document was
-produced by a group operating under the <a
+ imply endorsement by the W3C Membership. This is a draft document and
+may be updated, replaced or obsoleted by other documents at any time. It
+ is inappropriate to cite this document as other than work in progress.</p><p>This
+ document was produced by a group operating under the <a
href="http://www.w3.org/Consortium/Patent-Policy-20040205/">5 February
-2004 <acronym title="World Wide Web Consortium">W3C</acronym> Patent
-Policy</a>. <acronym title="World Wide Web Consortium">W3C</acronym>
-maintains a <a href="" rel="disclosure">public list of any patent
-disclosures</a> made in connection with the deliverables of the group;
-that page also includes instructions for disclosing a patent. An
-individual who has actual knowledge of a patent which the individual
-believes contains <a
+2004 W3C Patent Policy</a>. W3C maintains a <a href="" rel="disclosure">public
+ list of any patent disclosures</a> made in connection with the
+deliverables of the group; that page also includes instructions for
+disclosing a patent. An individual who has actual knowledge of a patent
+which the individual believes contains <a
href="http://www.w3.org/Consortium/Patent-Policy-20040205/#def-essential">Essential
Claim(s)</a> must disclose the information in accordance with <a
href="http://www.w3.org/Consortium/Patent-Policy-20040205/#sec-Disclosure">section
- 6 of the <acronym title="World Wide Web Consortium">W3C</acronym>
-Patent Policy</a>.</p></div><div class="section" id="toc"><h2
-class="introductory">Table of Contents</h2><ul class="toc"><li
+ 6 of the W3C Patent Policy</a>.</p></div><div class="section" id="toc"><h2
+ class="introductory">Table of Contents</h2><ul class="toc"><li
class="tocline"><a class="tocxref" href="#introduction"><span
class="secno">1. </span>Introduction</a></li><li class="tocline"><a
class="tocxref" href="#PI-and-xml"><span class="secno">2. </span>Processing
@@ -137,10 +128,15 @@
href="#external-script-and-style"><span class="secno">9.1 </span>External
Script and Style</a></li><li class="tocline"><a class="tocxref"
href="#in-line-script-and-style"><span class="secno">9.2 </span>In-line
-Script and Style</a></li></ul></li><li class="tocline"><a
-class="tocxref" href="#foreign-content"><span class="secno">10. </span>Exceptions
- from the Foreign Content Parsing Rules</a></li><li class="tocline"><a
-class="tocxref" href="#acknowledgements"><span class="secno">A. </span>Acknowledgements</a></li><li
+Script and Style</a><ul class="toc"><li class="tocline"><a
+class="tocxref" href="#safe-content"><span class="secno">9.2.1 </span>Safe
+ Content</a></li><li class="tocline"><a class="tocxref"
+href="#wrapping-in-cdata"><span class="secno">9.2.2 </span>Wrapping a
+Command in a CDATA Section</a></li></ul></li></ul></li><li
+class="tocline"><a class="tocxref" href="#foreign-content"><span
+class="secno">10. </span>Exceptions from the Foreign Content Parsing
+Rules</a></li><li class="tocline"><a class="tocxref"
+href="#acknowledgements"><span class="secno">A. </span>Acknowledgements</a></li><li
class="tocline"><a class="tocxref" href="#references"><span
class="secno">B. </span>References</a><ul class="toc"><li
class="tocline"><a class="tocxref" href="#normative-references"><span
@@ -171,12 +167,9 @@
<!--OddPage--><h2><span class="secno">2. </span>Processing Instructions
and the XML Declaration</h2>
<p>
- Polyglot markup does not use processing instructions.
- Note that the parsing rules for the XML declaration are not
-processing instructions and are defined separately in <a
-href="http://www.w3.org/TR/REC-xml/#NT-XMLDecl">Prolog and Document Type
- Declaration</a>.
- <!-- TODO: Add Normative link once generated -->
+ Processing Instructions and the XML Declaration are both forbidden in
+ polyglot markup.
+
</p>
</div>
<div id="character-encoding" class="section">
@@ -648,15 +641,20 @@
section.
However, polyglot markup does not use a <code>CDATA</code>
section unless it is being used within foreign content.
- </p><ul>
- <li>Safe content is content that does not contain a <code><</code>
+ </p>
+ <div id="safe-content" class="section">
+ <h4><span class="secno">9.2.1 </span>Safe Content</h4>
+ <p>Safe content is content that does not contain a <code><</code>
or <code>&</code> character.
The following example is safe because it does not contain
problematic characters within the <code><script></code> tag.
- <pre class="example"><script>document.body.appendChild(document.createElement("div"));</script></pre>
- </li>
- <li>Wrap in-line script and style commands in a CDATA section</li>
- <p>
+ </p><pre class="example"><script>document.body.appendChild(document.createElement("div"));</script></pre>
+
+ </div>
+ <div class="section" id="wrapping-in-cdata">
+ <h4><span class="secno">9.2.2 </span>Wrapping a Command in a
+CDATA Section</h4>
+ <p>
Note that you cannot achieve same DOM in both XHTML and HTML by
using in-line commands in a CDATA section.
However, this is not usally a problem unless the code has a
@@ -682,9 +680,8 @@
the DOM when using MathML or SVG, because the HTML parser does not
create a CDATA instance in the DOM.
</p>
-
- </ul>
+ </div>
</div>
</div>
@@ -703,8 +700,8 @@
<!--OddPage--><h2><span class="secno">A. </span>Acknowledgements</h2>
<p>
Many thanks to Daniel Glazman, Tony Ross, Sam Ruby, Jonas
-Sicking, Henri Sivonen, and Philip Taylor. Special thanks to the <acronym
- title="World Wide Web Consortium">W3C</acronym> TAG.
+Sicking, Henri Sivonen, and Philip Taylor. Special thanks to the W3C
+TAG.
</p>
</div>
<div class="appendix section" id="references"><!--OddPage--><h2><span
Received on Thursday, 24 June 2010 21:16:24 UTC