W3C home > Mailing lists > Public > public-html-commits@w3.org > January 2011

html5/html-xhtml-author-guide html-xhtml-authoring-guide.html,1.52,1.53

From: Eliot Graff via cvs-syncmail <cvsmail@w3.org>
Date: Thu, 13 Jan 2011 22:19:58 +0000
To: public-html-commits@w3.org
Message-Id: <E1PdVWQ-0006qt-17@lionel-hutz.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> &#xA9; 2010 
+			<a href="http://www.w3.org/Consortium/Legal/ipr-notice#Copyright">Copyright</a> &#xA9; 2011 
 			<a href="http://www.w3.org/"><abbr title="World Wide Web Consortium">W3C</abbr></a><sup>&#xAE;</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>&lt;textarea&gt;</code> and <code>&lt;pre&gt;</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>&lt;textarea&gt;</code> and <code>&lt;pre&gt;</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>&lt;meta charset="*"/&gt;</code>  has no effect in XML. 
 		Therefore, <a class="internalDFN" href="#dfn-polyglot-markup">polyglot markup</a> may use <code>&lt;meta charset="*"/&gt;</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>&lt;meta content=”text/html; charset”&gt;</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>&lt;br/&gt;</code>. 
-	  	The alternative syntax <code>&lt;br&gt;&lt;/br&gt;</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>&lt;br/&gt;</code>, 
+	  	rather than the alternative syntax <code>&lt;br&gt;&lt;/br&gt;</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>&lt;p&gt;&lt;/p&gt;</code> and not <code>&lt;p /&gt;</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 @@
 
   &lt;head&gt;
     &lt;title&gt;A Sample Page Using Polglot Markup&lt;/title&gt;
-	&lt;!-- The link element is self-closing as described in <a href="#empty-elements">Section 6.4 Empty Elements</a> --&gt;
+	&lt;!-- The link element is self-closing as described in <a href="#empty-elements">Section 6.4 Void Elements</a> --&gt;
 	&lt;!-- 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> --&gt;
 	&lt;link type="text/css" rel="stylesheet" href="Sample.css"/&gt;
@@ -1347,9 +1349,9 @@
         &lt;/a&gt;
       &lt;/g&gt;
     &lt;/svg&gt; 		
-    &lt;h2&gt;Empty Elements&lt;/h2&gt;
+    &lt;h2&gt;Void Elements&lt;/h2&gt;
     &lt;!-- 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> --&gt;
+    <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> --&gt;
     &lt;p&gt;&lt;/p&gt;
     &lt;p&gt;
       There is an empty &lt;p&gt; element before this paragraph. 
@@ -1357,11 +1359,11 @@
     &lt;/p&gt;
     &lt;p&gt;
       <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 &lt;img&gt; element.
+      void elements, such as the following &lt;img&gt; element.
     &lt;/p&gt;
     &lt;img height="48" width="72" alt="W3C" src="http://www.w3.org/Icons/w3c_home"/&gt;
     &lt;p&gt;
-      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>.
     &lt;/p&gt;
 
 
@@ -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 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Thursday, 13 January 2011 22:20:05 GMT