html5/html-xhtml-author-guide html-xhtml-authoring-guide.html,1.45,1.46

Update of /sources/public/html5/html-xhtml-author-guide
In directory hutz:/tmp/cvs-serv30358

Modified Files:
	html-xhtml-authoring-guide.html 
Log Message:
Added sentence in Section 4 about about:legacy-compat & XML per bug 11057; Added new section, "Comments in Polyglot Markup" per bug 11260; fixed malformed sample per bug 11516; Fixed attribute value decription per bug 11261;

Index: html-xhtml-authoring-guide.html
===================================================================
RCS file: /sources/public/html5/html-xhtml-author-guide/html-xhtml-authoring-guide.html,v
retrieving revision 1.45
retrieving revision 1.46
diff -u -d -r1.45 -r1.46
--- html-xhtml-authoring-guide.html	6 Dec 2010 20:43:20 -0000	1.45
+++ html-xhtml-authoring-guide.html	9 Dec 2010 19:45:01 -0000	1.46
@@ -1,7 +1,8 @@
 <!DOCTYPE html>
 
 <html dir="ltr" lang="en"><head>
-<title>Polyglot Markup: HTML-Compatible XHTML Documents</title>
+
+	<title>Polyglot Markup: HTML-Compatible XHTML Documents</title>
 
 <meta name="GENERATOR" content="MSHTML 8.00.7600.16588"/>
 <style type="text/css">
@@ -470,19 +471,32 @@
 
 </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"/>
+<link type="text/css" rel="stylesheet" href="html-xhtml-authoring-guide_files/W3C-ED.css"/>
+</head>
 
+<body style="display: inherit;">
 
-</head>
-	<body style="display: inherit;">
-	<div class="head">
+<div class="head">
 	<p>
 		<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-06-december-2010">W3C Editor's Draft 06 December 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/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><a href="http://www.w3.org/TR/2010/WD-html-polyglot-20101019/">http://www.w3.org/TR/2010/WD-html-polyglot-20101019/</a></dd><dt>Editor:</dt><dd><span>Eliot Graff</span>, Microsoft Corporation</dd>
-</dl>
+	<h1 class="title" id="title">Polyglot Markup: HTML-Compatible XHTML Documents</h1>
+	<h2 id="w3c-editor-s-draft-09-december-2010">W3C Editor's Draft 09 December 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/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><a href="http://www.w3.org/TR/2010/WD-html-polyglot-20101019/">http://www.w3.org/TR/2010/WD-html-polyglot-20101019/</a></dd>
+		
+		<dt>Editor:</dt>
+		<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 
@@ -493,8 +507,8 @@
 		<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>
-
 </div>
+
 <hr/>
 
 <div class="introductory section" id="abstract"><h2>Abstract</h2>
@@ -541,21 +555,24 @@
 		<a href="http://lists.w3.org/Archives/Public/public-html/">archives</a>) and arrangements will be made to transpose the comments to the bug database.  
 		All feedback is welcome.</p>
 <!--End of Status of This Document-->
-<p>Publication
- as a Editor's Draft does not 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 W3C Patent Policy</a>.
-	W3C maintains a <a href="http://www.w3.org/2004/01/pp-impl/40318/status" 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 W3C Patent Policy</a>.
-</p>
+	<p>
+		Publication as a Editor's Draft does not 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 W3C Patent Policy</a>. W3C maintains a <a href="http://www.w3.org/2004/01/pp-impl/40318/status" 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 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>
@@ -612,8 +629,9 @@
 				</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="#example-document"><span class="secno">11. </span>Example Document</a></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">
@@ -625,7 +643,6 @@
 </div>
 
 
-
 <div id="introduction" class="section informative">
 <!--OddPage--><h2><span class="secno">1. </span>Introduction</h2><p><em>This section is non-normative.</em></p>
 	<p>
@@ -676,8 +693,7 @@
 	<p></p>
 	<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".
+		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".
 	</p>
 	<p>
 		Note that the <a href="http://www.w3.org/International/questions/qa-html-encoding-declarations">W3C Internationalization (i18n) Group recommends</a>
@@ -708,7 +724,10 @@
 		</li>
 	</ul>
 	<p>
-		Note that <a class="internalDFN" href="#dfn-polyglot-markup">polyglot markup</a> does not use document type declarations for HTML4, HTML3, or HTML2, regardless of whether they contain a URI or not and 
+		Note that using <code>about:legacy-compat</code> in XML may yield unpredictable parsing results, depending on the XML processing pipeline. 
+	</p>
+	<p>
+		<a class="internalDFN" href="#dfn-polyglot-markup" title="polyglot markup">Polyglot markup</a> does not use document type declarations for HTML4, HTML3, or HTML2, regardless of whether they contain a URI or not and 
 		regardless of their effect in HTML5 parsers, as these document type declarations are not compatible with XHTML.
 	</p>
 <!--End section: The DOCTYPE-->
@@ -1085,11 +1104,20 @@
 
 <div id="attributes" class="section">
 <!--OddPage--><h2><span class="secno">7. </span>Attributes</h2>
-<p>Because of attribute-value normalization in XML [<cite><a href="#bib-XML10" rel="biblioentry" class="bibref">XML10</a></cite>], <a class="internalDFN" href="#dfn-polyglot-markup">polyglot markup</a> does not contain tabs, line feeds, or carriage returns within CDATA attributes.
+<p>
+	Within an attribute's value, <a class="internalDFN" href="#dfn-polyglot-markup">polyglot markup</a> represents tabs, line feeds, and carriage returns 
+	as numeric character references rather than by using literal characters. 
+	For example, within an attribute's value, <a class="internalDFN" href="#dfn-polyglot-markup">polyglot markup</a> uses <code>&amp;#x9;</code> for a tab 
+	rather than the literal character <code>'\t'</code>.
+	This is because of attribute-value normalization in XML [<cite><a href="#bib-XML10" rel="biblioentry" class="bibref">XML10</a></cite>]. 
+</p>
+<p>
+	<a class="internalDFN" href="#dfn-polyglot-markup" title="polyglot markup">Polyglot markup</a> surrounds all attribute values with quotation marks. 
+	<a class="internalDFN" href="#dfn-polyglot-markup" title="polyglot markup">Polyglot markup</a> surrounds attribute values by either single quotation marks or by double quotation marks.
+</p>
+<p>
+	See also <a href="#attribute-values">Attribute Values</a>.
 </p>
-<p><a class="internalDFN" href="#dfn-polyglot-markup" title="polyglot markup">Polyglot markup</a> surrounds all attribute values with quotation marks. 
-	<a class="internalDFN" href="#dfn-polyglot-markup" title="polyglot markup">Polyglot markup</a> surrounds attribute values by either single quotation marks or by double quotation marks.</p>
-<p>See also <a href="#attribute-values">Attribute Values</a>.</p>
 
 	<div id="disallowed-attributes" class="section">
 	<h3><span class="secno">7.1 </span>Disallowed Attributes</h3>
@@ -1120,7 +1148,8 @@
 
 <div id="named-entity-references" class="section">
 <!--OddPage--><h2><span class="secno">8. </span>Named Entity References</h2>
-	<p><a class="internalDFN" href="#dfn-polyglot-markup" title="polyglot markup">Polyglot markup</a> uses only the following named entity references:</p>
+	<p>
+		<a class="internalDFN" href="#dfn-polyglot-markup" title="polyglot markup">Polyglot markup</a> uses only the following named entity references:</p>
       	<ul>
       		<li><code>amp</code></li>
       		<li><code>lt</code></li>
@@ -1222,8 +1251,18 @@
 <!--End section: Script and Style-->
 </div>
 
+<div id="comments" class="section">
+	<!--OddPage--><h2><span class="secno">10. </span>Comments in Polyglot Markup</h2>
+	<p>
+		<a class="internalDFN" href="#dfn-polyglot-markup" title="polyglot markup">Polyglot markup</a> does not begin a comment with either "<code>&gt;</code>" or "<code>-&gt;</code>". 
+	</p>
+
+<!--End section: Comments-->
+</div>
+
+
 <div id="foreign-content" class="section">
-	<!--OddPage--><h2><span class="secno">10. </span>Exceptions from the Foreign Content Parsing Rules</h2>
+	<!--OddPage--><h2><span class="secno">11. </span>Exceptions from the Foreign Content Parsing Rules</h2>
 	<p>
 	        <!-- TODO: Need to call out exceptions from the foreign content parsing rules (e.g. <foreignContent> -->
 	</p>
@@ -1232,7 +1271,7 @@
 </div>
 
 <div id="example-document" class="section">
-	<!--OddPage--><h2><span class="secno">11. </span>Example Document</h2>
+	<!--OddPage--><h2><span class="secno">12. </span>Example Document</h2>
 	<p>
 		The following example code acts as <a class="internalDFN" href="#dfn-polyglot-markup">polyglot markup</a> and validates as either XHTML or as HTML. You can view the page live 
 		at <a href="http://dev.w3.org/html5/html-xhtml-author-guide/SamplePage.html">http://dev.w3.org/html5/html-xhtml-author-guide/SamplePage.html</a>.
@@ -1306,83 +1345,82 @@
         &lt;/a&gt;
       &lt;/g&gt;
     &lt;/svg&gt; 		
-  &lt;h2&gt;Empty 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;
-  &lt;p&gt;&lt;/p&gt;
-  &lt;p&gt;
-    There is an empty &lt;p&gt; element before this paragraph. 
-    <a class="internalDFN" href="#dfn-polyglot-markup" title="polyglot markup">Polyglot markup</a> uses &lt;p&gt;&lt;/p&gt; and not &lt;p /&gt;.  
-  &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.
-  &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>.
-  &lt;/p&gt;
+    &lt;h2&gt;Empty 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;
+    &lt;p&gt;&lt;/p&gt;
+    &lt;p&gt;
+      There is an empty &lt;p&gt; element before this paragraph. 
+      <a class="internalDFN" href="#dfn-polyglot-markup" title="polyglot markup">Polyglot markup</a> uses &lt;p&gt;&lt;/p&gt; and not &lt;p /&gt;.  
+    &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.
+    &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>.
+    &lt;/p&gt;
 
 
-  &lt;h2&gt;Required Elements&lt;/h2&gt;
-  &lt;p&gt;
-    The following table uses the required &lt;tbody&gt; element, as described in 
-    <a href="#required-elements">Section 6.1 Required Elements</a>.
-  &lt;/p&gt;
-  &lt;table&gt;
-    &lt;tbody&gt;
-      &lt;tr&gt;
-        &lt;th&gt;Column One&lt;/th&gt;
-        &lt;th&gt;Column Two&lt;/th&gt;
-      &lt;/tr&gt;
+    &lt;h2&gt;Required Elements&lt;/h2&gt;
+    &lt;p&gt;
+      The following table uses the required &lt;tbody&gt; element, as described in 
+      <a href="#required-elements">Section 6.1 Required Elements</a>.
+    &lt;/p&gt;
+    &lt;table&gt;
+      &lt;tbody&gt;
+        &lt;tr&gt;
+          &lt;th&gt;Column One&lt;/th&gt;
+          &lt;th&gt;Column Two&lt;/th&gt;
+        &lt;/tr&gt;
+        &lt;tr&gt;
+          &lt;td&gt;Row 1, Column 1&lt;/td&gt;
+          &lt;td&gt;Row 1, Column 2&lt;/td&gt;
+        &lt;/tr&gt;
+        &lt;tr&gt;
+          &lt;td&gt;Row 2, Column 1&lt;/td&gt;
+          &lt;td&gt;Row 2, Column 2&lt;/td&gt;
+        &lt;/tr&gt;
+        &lt;tr&gt;
+          &lt;td&gt;Row 3, Column 1&lt;/td&gt;
+          &lt;td&gt;Row 3, Column 2&lt;/td&gt;
+        &lt;/tr&gt;
+      &lt;/tbody&gt;
+    &lt;/table&gt;
+
+    &lt;p&gt;
+      The following table uses the required &lt;colgroup&gt; element, as described in 
+      <a href="#required-elements">Section 6.1 Required Elements</a>.  
+    &lt;/p&gt;
+    &lt;table&gt;
+      &lt;colgroup&gt;
+        &lt;col style="background-color:silver"/&gt;
+        &lt;col style="background-color:gray"/&gt;
+        &lt;col style="background-color:yellow"/&gt;
+      &lt;/colgroup&gt;
       &lt;tr&gt;
-        &lt;td&gt;Row 1, Column 1&lt;/td&gt;
-        &lt;td&gt;Row 1, Column 2&lt;/td&gt;
+        &lt;th&gt;ISBN&lt;/th&gt;
+        &lt;th&gt;Title&lt;/th&gt;
+        &lt;th&gt;Price&lt;/th&gt;
       &lt;/tr&gt;
       &lt;tr&gt;
-        &lt;td&gt;Row 2, Column 1&lt;/td&gt;
-        &lt;td&gt;Row 2, Column 2&lt;/td&gt;
+        &lt;td&gt;3476896&lt;/td&gt;
+        &lt;td&gt;My first HTML&lt;/td&gt;
+        &lt;td&gt;$53&lt;/td&gt;
       &lt;/tr&gt;
       &lt;tr&gt;
-        &lt;td&gt;Row 3, Column 1&lt;/td&gt;
-        &lt;td&gt;Row 3, Column 2&lt;/td&gt;
+        &lt;td&gt;1234567&lt;/td&gt;
+        &lt;td&gt;Intermediate Polyglot&lt;/td&gt;
+        &lt;td&gt;$49&lt;/td&gt;
       &lt;/tr&gt;
-    &lt;/tbody&gt;
-  &lt;/table&gt;
-
-  &lt;p&gt;
-    The following table uses the required &lt;colgroup&gt; element, as described in 
-    <a href="#required-elements">Section 6.1 Required Elements</a>.  
-  &lt;/p&gt;
-  &lt;table&gt;
-    &lt;colgroup&gt;
-      &lt;col style="background-color:silver"/&gt;
-      &lt;col style="background-color:gray"/&gt;
-      &lt;col style="background-color:yellow"/&gt;
-    &lt;/colgroup&gt;
-    &lt;tr&gt;
-      &lt;th&gt;ISBN&lt;/th&gt;
-      &lt;th&gt;Title&lt;/th&gt;
-      &lt;th&gt;Price&lt;/th&gt;
-    &lt;/tr&gt;
-    &lt;tr&gt;
-      &lt;td&gt;3476896&lt;/td&gt;
-      &lt;td&gt;My first HTML&lt;/td&gt;
-      &lt;td&gt;$53&lt;/td&gt;
-    &lt;/tr&gt;
-    &lt;tr&gt;
-      &lt;td&gt;1234567&lt;/td&gt;
-      &lt;td&gt;Intermediate Polyglot&lt;/td&gt;
-      &lt;td&gt;$49&lt;/td&gt;
-    &lt;/tr&gt;
-  &lt;/table&gt;
-
+    &lt;/table&gt;
 
-  &lt;h2&gt;Named Entity References&lt;/h2&gt;
-  &lt;p&gt;
-    This paragraph uses the string "&amp;amp;" for ampersands ("&amp;") and uses the string "&amp;#xA0;" 
-    for a nonbreaking space between the words "polyglot&nbsp;markup," as described in 
-    <a href="#named-entity-references">Section 8. Named Entity References</a>.
+    &lt;h2&gt;Named Entity References&lt;/h2&gt;
+    &lt;p&gt;
+      This paragraph uses the string "&amp;amp;" for ampersands ("&amp;") and uses the string "&amp;#xA0;" 
+      for a nonbreaking space between the words "polyglot&nbsp;markup," as described in 
+      <a href="#named-entity-references">Section 8. Named Entity References</a>.
     &lt;/p&gt;
   &lt;/body&gt;
 &lt;/html&gt; </pre>
@@ -1392,18 +1430,16 @@
 
 
 <div id="acknowledgements" class="appendix section">
-<!--OddPage--><h2><span class="secno">A. </span>Acknowledgements</h2>
-<p>
-	Many thanks to Daniel Glazman, Richard Ishida, Tony Ross, Sam Ruby, 
-Jonas Sicking, Leif Halvard Silli, Henri Sivonen, Manu Sporny, and 
-Philip Taylor. 
-	Special thanks to the W3C TAG and the W3C Internationalization (i18n) 
-Core Working Group.
-</p>
+	<h2><span class="secno">A. </span>Acknowledgements</h2>
+	<p>
+		Many thanks to Robin Berjon, Daniel Glazman, Richard Ishida, Tony Ross, Sam Ruby, Jonas Sicking, Leif Halvard Silli, 
+		Henri Sivonen, Manu Sporny, and Philip Taylor. 
+		Special thanks to the W3C TAG and the W3C Internationalization (i18n) Core Working Group.
+	</p>
 </div>
 
 <div class="appendix section" id="references">
-<h2><span class="secno">B. </span>References</h2>
+	<h2><span class="secno">B. </span>References</h2>
 
 	<div class="section" id="normative-references">
 	<h3><span class="secno">B.1 </span>Normative references</h3>
@@ -1440,5 +1476,5 @@
 	</div>
 </div>
 
-
-</body></html>
\ No newline at end of file
+</body>
+</html>
\ No newline at end of file

Received on Thursday, 9 December 2010 19:45:05 UTC