- From: Eliot Graff via cvs-syncmail <cvsmail@w3.org>
- Date: Thu, 13 Jan 2011 22:19:58 +0000
- To: public-html-commits@w3.org
Update of /sources/public/html5/html-xhtml-author-guide
In directory hutz:/tmp/cvs-serv26325
Modified Files:
html-xhtml-authoring-guide.html
Log Message:
Added statement that polyglot markup does not use <meta content=”text/html; charset”>; changed "Empty Elements" to "Void Elements."
Index: html-xhtml-authoring-guide.html
===================================================================
RCS file: /sources/public/html5/html-xhtml-author-guide/html-xhtml-authoring-guide.html,v
retrieving revision 1.52
retrieving revision 1.53
diff -u -d -r1.52 -r1.53
--- html-xhtml-authoring-guide.html 5 Jan 2011 21:48:07 -0000 1.52
+++ html-xhtml-authoring-guide.html 13 Jan 2011 22:19:55 -0000 1.53
@@ -462,7 +462,6 @@
pre.sh_sourceCode .sh_paren { color: red; }
pre.sh_sourceCode .sh_attribute { color: #006400; }
</style>
- <link type="text/css" rel="stylesheet" href="html-xhtml-authoring-guide_files/W3C-ED.css"/>
<link rel="stylesheet" type="text/css" href="http://www.w3.org/StyleSheets/TR/W3C-ED"/>
</head>
@@ -472,7 +471,7 @@
<a href="http://www.w3.org/"><img height="48" width="72" alt="W3C" src="http://www.w3.org/Icons/w3c_home"/></a>
</p>
<h1 class="title" id="title">Polyglot Markup: HTML-Compatible XHTML Documents</h1>
- <h2 id="w3c-editor-s-draft-05-january-2011">W3C Editor's Draft 05 January 2011</h2>
+ <h2 id="w3c-editor-s-draft-05-january-2011">W3C Editor's Draft 13 January 2011</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>
@@ -490,7 +489,7 @@
<dd><span>Eliot Graff</span>, 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/Consortium/Legal/ipr-notice#Copyright">Copyright</a> © 2011
<a href="http://www.w3.org/"><abbr title="World Wide Web Consortium">W3C</abbr></a><sup>®</sup>
(<a href="http://www.csail.mit.edu/"><abbr title="Massachusetts Institute of Technology">MIT</abbr></a>,
<a href="http://www.ercim.eu/"><abbr title="European Research Consortium for Informatics and Mathematics">ERCIM</abbr></a>,
@@ -555,72 +554,74 @@
</div>
<div>
- <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 Instructions and the XML Declaration</a></li>
- <li class="tocline"><a class="tocxref" href="#character-encoding"><span class="secno">3. </span>Specifying a Document's Character Encoding</a></li>
- <li class="tocline"><a class="tocxref" href="#doctype"><span class="secno">4. </span>The DOCTYPE</a></li>
- <li class="tocline"><a class="tocxref" href="#namespaces"><span class="secno">5. </span>Namespaces</a>
- <ul class="toc">
- <li class="tocline"><a class="tocxref" href="#element-level-namespaces"><span class="secno">5.1 </span>Element-Level Namespaces</a></li>
- <li class="tocline"><a class="tocxref" href="#attribute-level-namespaces"><span class="secno">5.2 </span>Attribute-Level Namespaces</a></li>
- </ul>
- </li>
- <li class="tocline"><a class="tocxref" href="#elements"><span class="secno">6. </span>Elements</a>
- <ul class="toc">
- <li class="tocline"><a class="tocxref" href="#required-elements"><span class="secno">6.1 </span>Required Elements</a></li>
- <li class="tocline"><a class="tocxref" href="#elements-that-cannot-be-used"><span class="secno">6.2 </span>Elements that Cannot Be Used in Polyglot Markup</a></li>
- <li class="tocline"><a class="tocxref" href="#case-sensitivity"><span class="secno">6.3 </span>Case-Sensitivity</a>
- <ul class="toc">
- <li class="tocline"><a class="tocxref" href="#element-names"><span class="secno">6.3.1 </span>Element Names</a></li>
- <li class="tocline"><a class="tocxref" href="#attribute-names"><span class="secno">6.3.2 </span>Attribute Names</a></li>
- <li class="tocline"><a class="tocxref" href="#attribute-values"><span class="secno">6.3.3 </span>Attribute Values</a></li>
- </ul>
- </li>
- <li class="tocline"><a class="tocxref" href="#empty-elements"><span class="secno">6.4 </span>Empty Elements</a></li>
- <li class="tocline"><a class="tocxref" href="#elements-with-soecial-considerations"><span class="secno">6.5 </span>
- Elements with Special Considerations</a>
- <ul class="toc">
- <li class="tocline"><a class="tocxref" href="#newlines-in-textarea-and-pre"><span class="secno">6.5.1 </span>
- Newlines in <code><textarea></code> and <code><pre></code> Elements</a></li>
- <li class="tocline"><a class="tocxref" href="#elements-that-cannot-contain-special-characters"><span class="secno">6.5.2 </span>
- Elements that Cannot Contain Special Characters</a></li>
- </ul>
- </li>
- </ul>
- </li>
- <li class="tocline"><a class="tocxref" href="#attributes"><span class="secno">7. </span>Attributes</a>
- <ul class="toc">
- <li class="tocline"><a class="tocxref" href="#disallowed-attributes"><span class="secno">7.1 </span>Disallowed Attributes</a></li>
- <li class="tocline"><a class="tocxref" href="#language-attributes"><span class="secno">7.2 </span>Language Attributes</a></li>
- </ul>
- </li>
- <li class="tocline"><a class="tocxref" href="#named-entity-references"><span class="secno">8. </span>Named Entity References</a></li>
- <li class="tocline"><a class="tocxref" href="#script-and-style"><span class="secno">9. </span>Script and Style</a>
- <ul class="toc">
- <li class="tocline"><a class="tocxref" 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>
- <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="#comments"><span class="secno">10. </span>Comments in Polyglot Markup</a></li>
- <li class="tocline"><a class="tocxref" href="#foreign-content"><span class="secno">11. </span>Exceptions from the Foreign Content Parsing Rules</a></li>
- <li class="tocline"><a class="tocxref" href="#example-document"><span class="secno">12. </span>Example Document</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 class="secno">B.1 </span>Normative references</a></li>
- <li class="tocline"><a class="tocxref" href="#informative-references"><span class="secno">B.2 </span>Informative references</a></li>
- </ul>
- </li>
- </ul>
-<!-- End of Table of Contents -->
- </div>
+<h2 class="introductory" id="toc">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 Instructions and the XML Declaration</a></li>
+ <li class="tocline"><a class="tocxref" href="#character-encoding"><span class="secno">3. </span>Specifying a Document's Character Encoding</a></li>
+ <li class="tocline"><a class="tocxref" href="#doctype"><span class="secno">4. </span>The DOCTYPE</a></li>
+ <li class="tocline"><a class="tocxref" href="#namespaces"><span class="secno">5. </span>Namespaces</a>
+ <ul class="toc">
+ <li class="tocline"><a class="tocxref" href="#element-level-namespaces"><span class="secno">5.1 </span>Element-Level Namespaces</a></li>
+ <li class="tocline"><a class="tocxref" href="#attribute-level-namespaces"><span class="secno">5.2 </span>Attribute-Level Namespaces</a></li>
+ </ul>
+ </li>
+ <li class="tocline"><a class="tocxref" href="#elements"><span class="secno">6. </span>Elements</a>
+ <ul class="toc">
+ <li class="tocline"><a class="tocxref" href="#required-elements"><span class="secno">6.1 </span>Required Elements</a></li>
+ <li class="tocline"><a class="tocxref" href="#elements-that-cannot-be-used"><span class="secno">6.2 </span>
+ Elements that Cannot Be Used in Polyglot Markup</a></li>
+ <li class="tocline"><a class="tocxref" href="#case-sensitivity"><span class="secno">6.3 </span>Case-Sensitivity</a>
+ <ul class="toc">
+ <li class="tocline"><a class="tocxref" href="#element-names"><span class="secno">6.3.1 </span>Element Names</a></li>
+ <li class="tocline"><a class="tocxref" href="#attribute-names"><span class="secno">6.3.2 </span>Attribute Names</a></li>
+ <li class="tocline"><a class="tocxref" href="#attribute-values"><span class="secno">6.3.3 </span>Attribute Values</a></li>
+ </ul>
+ </li>
+ <li class="tocline"><a class="tocxref" href="#empty-elements"><span class="secno">6.4 </span>Void Elements</a></li>
+ <li class="tocline"><a class="tocxref" href="#elements-with-soecial-considerations"><span class="secno">6.5 </span>
+ Elements with Special Considerations</a>
+ <ul class="toc">
+ <li class="tocline"><a class="tocxref" href="#newlines-in-textarea-and-pre"><span class="secno">6.5.1 </span>
+ Newlines in <code><textarea></code> and <code><pre></code> Elements</a></li>
+ <li class="tocline"><a class="tocxref" href="#elements-that-cannot-contain-special-characters"><span class="secno">6.5.2 </span>
+ Elements that Cannot Contain Special Characters</a></li>
+
+ </ul>
+ </li>
+ </ul>
+ </li>
+ <li class="tocline"><a class="tocxref" href="#attributes"><span class="secno">7. </span>Attributes</a>
+ <ul class="toc">
+ <li class="tocline"><a class="tocxref" href="#disallowed-attributes"><span class="secno">7.1 </span>Disallowed Attributes</a></li>
+ <li class="tocline"><a class="tocxref" href="#language-attributes"><span class="secno">7.2 </span>Language Attributes</a></li>
+ </ul>
+ </li>
+ <li class="tocline"><a class="tocxref" href="#named-entity-references"><span class="secno">8. </span>Named Entity References</a></li>
+ <li class="tocline"><a class="tocxref" href="#script-and-style"><span class="secno">9. </span>Script and Style</a>
+ <ul class="toc">
+ <li class="tocline"><a class="tocxref" 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>
+ <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="#comments"><span class="secno">10. </span>Comments in Polyglot Markup</a></li>
+ <li class="tocline"><a class="tocxref" href="#foreign-content"><span class="secno">11. </span>Exceptions from the Foreign Content Parsing Rules</a></li>
+ <li class="tocline"><a class="tocxref" href="#example-document"><span class="secno">12. </span>Example Document</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 class="secno">B.1 </span>Normative references</a></li>
+ <li class="tocline"><a class="tocxref" href="#informative-references"><span class="secno">B.2 </span>Informative references</a></li>
+ </ul>
+ </li>
+ </ul>
+</div>
@@ -675,6 +676,7 @@
<p>
Using <code><meta charset="*"/></code> has no effect in XML.
Therefore, <a class="internalDFN" href="#dfn-polyglot-markup">polyglot markup</a> may use <code><meta charset="*"/></code> provided the document is encoded as UTF-8 and the value of charset is a case-insensitive match for the string "utf-8".
+ However, because the mime-type is not necessarily <code>text/html</code>, polyglot markup does not use <code><meta content=”text/html; charset”></code>.
</p>
<p>
Note that the <a href="http://www.w3.org/International/questions/qa-html-encoding-declarations">W3C Internationalization (i18n) Group recommends</a>
@@ -1046,8 +1048,8 @@
</div>
<div id="empty-elements" class="section">
- <h3><span class="secno">6.4 </span>Empty Elements</h3>
- <p><a class="internalDFN" href="#dfn-polyglot-markup" title="polyglot markup">Polyglot markup</a> uses only the elements in the following list as empty elements.</p>
+ <h3><span class="secno">6.4 </span>Void Elements</h3>
+ <p><a class="internalDFN" href="#dfn-polyglot-markup" title="polyglot markup">Polyglot markup</a> uses only the elements in the following list as void elements.</p>
<ul>
<li><code>area</code></li>
<li><code>base</code></li>
@@ -1064,15 +1066,15 @@
<li><code>param</code></li>
<li><code>source</code></li>
</ul>
- <p><a class="internalDFN" href="#dfn-polyglot-markup" title="polyglot markup">Polyglot markup</a> uses the minimized tag syntax for empty elements, e.g. <code><br/></code>.
- The alternative syntax <code><br></br></code> allowed by XML gives uncertain results in many existing user agents.
+ <p><a class="internalDFN" href="#dfn-polyglot-markup" title="polyglot markup">Polyglot markup</a> uses the minimized tag syntax for void elements, e.g. <code><br/></code>,
+ rather than the alternative syntax <code><br></br></code>.
</p>
<p>
Given an empty instance of an element whose content model is not EMPTY (for example, an empty title or paragraph)
<a class="internalDFN" href="#dfn-polyglot-markup">polyglot markup</a> does not use the minimized form (e.g. the document uses <code><p></p></code> and not <code><p /></code>).
</p>
<p>Note that MathML and SVG elements may be either self-closing or contain content.</p>
-<!--End section: Empty Elements-->
+<!--End section: void Elements-->
</div>
<div id="elements-with-special-considerations" class="section">
@@ -1285,7 +1287,7 @@
<head>
<title>A Sample Page Using Polglot Markup</title>
- <!-- The link element is self-closing as described in <a href="#empty-elements">Section 6.4 Empty Elements</a> -->
+ <!-- The link element is self-closing as described in <a href="#empty-elements">Section 6.4 Void Elements</a> -->
<!-- Style commands are included by linking to an external file rather than including them in-line,
as described in <a href="#script-and-style">Section 9. Script and Style</a> -->
<link type="text/css" rel="stylesheet" href="Sample.css"/>
@@ -1347,9 +1349,9 @@
</a>
</g>
</svg>
- <h2>Empty Elements</h2>
+ <h2>Void Elements</h2>
<!-- Given an empty instance of an element whose content model is not EMPTY (in this case, an empty paragraph)
- <a class="internalDFN" href="#dfn-polyglot-markup">polyglot markup</a> does not use the minimized form, as described in <a href="#empty-elements">Section 6.4 Empty Elements</a> -->
+ <a class="internalDFN" href="#dfn-polyglot-markup">polyglot markup</a> does not use the minimized form, as described in <a href="#empty-elements">Section 6.4 Void Elements</a> -->
<p></p>
<p>
There is an empty <p> element before this paragraph.
@@ -1357,11 +1359,11 @@
</p>
<p>
<a class="internalDFN" href="#dfn-polyglot-markup" title="polyglot markup">Polyglot markup</a> treats certain elements as self-closing,
- empty elements, such as the following <img> element.
+ void elements, such as the following <img> element.
</p>
<img height="48" width="72" alt="W3C" src="http://www.w3.org/Icons/w3c_home"/>
<p>
- For more information, see <a href="#empty-elements">Section 6.4 Empty Elements</a>.
+ For more information, see <a href="#empty-elements">Section 6.4 Void Elements</a>.
</p>
@@ -1432,6 +1434,7 @@
<!--End section: Example Document-->
</div>
+
<div id="acknowledgements" class="appendix section">
<!--OddPage--><h2><span class="secno">A. </span>Acknowledgements</h2>
<p>
Received on Thursday, 13 January 2011 22:20:00 UTC