W3C home > Mailing lists > Public > public-html-commits@w3.org > October 2010

html5/html-xhtml-author-guide html-xhtml-authoring-guide.html,1.42,1.43

From: Eliot Graff via cvs-syncmail <cvsmail@w3.org>
Date: Fri, 29 Oct 2010 20:34:46 +0000
To: public-html-commits@w3.org
Message-Id: <E1PBvew-0000RN-EX@lionel-hutz.w3.org>
Update of /sources/public/html5/html-xhtml-author-guide
In directory hutz:/tmp/cvs-serv1677

Modified Files:
	html-xhtml-authoring-guide.html 
Log Message:
Edited 6.3.3 per bug 10167; changed paragraph in section 3, per bug 11055; fixed typo per bug 11058; added guidance about <plaintext> and <xmp> in new section 6.5.2;

Index: html-xhtml-authoring-guide.html
===================================================================
RCS file: /sources/public/html5/html-xhtml-author-guide/html-xhtml-authoring-guide.html,v
retrieving revision 1.42
retrieving revision 1.43
diff -u -d -r1.42 -r1.43
--- html-xhtml-authoring-guide.html	25 Oct 2010 20:55:16 -0000	1.42
+++ html-xhtml-authoring-guide.html	29 Oct 2010 20:34:44 -0000	1.43
@@ -485,17 +485,20 @@
 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>
 
 <body style="display: inherit;">
-<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-25-october-2010">W3C Editor's Draft 25 October 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-20100624/">http://www.w3.org/TR/2010/WD-html-polyglot-20100624/</a></dd><dt>Editor:</dt><dd><span>Eliot Graff</span>, Microsoft Corporation</dd>
+<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-30-october-2010">W3C Editor's Draft 30 October 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-20100624/">http://www.w3.org/TR/2010/WD-html-polyglot-20100624/</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 
 		<a href="http://www.w3.org/"><abbr title="World Wide Web Consortium">W3C</abbr></a><sup>&#xAE;</sup> 
@@ -505,7 +508,7 @@
 		<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/>
+	<hr/>
 </div>
 
 <div class="introductory section" id="abstract"><h2>Abstract</h2>
@@ -552,17 +555,17 @@
 		<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. 
+<p>Publication as an 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>
+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>
-<h2 class="introductory">Table of Contents</h2>
+<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 Instructions and the XML Declaration</a></li>
@@ -592,6 +595,9 @@
 					<ul class="toc">
 						<li class="tocline"><a class="tocxref" href="#white-space-in-textarea-and-pre"><span class="secno">6.5.1 </span>
 							White Space 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>
@@ -628,7 +634,6 @@
 
 
 
-
 <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>
@@ -679,8 +684,9 @@
 	<p></p>
 	<p>
 		Using <code>&lt;meta charset="*"/&gt;</code>  has no effect in XML. 
-		Therefore, polyglot markup <em title="may" class="rfc2119">may</em> use <code>&lt;meta charset="*"/&gt;</code> in combination with BOM, as long the meta element specifies the same character encoding as the BOM.
-		In addition, the meta tag <em title="may" class="rfc2119">may</em> be used in the absence of a BOM as long as it matches the already specified encoding.
+		Therefore, polyglot markup <em title="may" class="rfc2119">may</em> 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>
  to always include a visible encoding declaration in a document, because
  it helps developers, testers, or translation production managers to 
@@ -747,7 +753,7 @@
 			[<cite><a href="#bib-HTML5" rel="biblioentry" class="bibref">HTML5</a></cite>] introduces undeclared (native) support for attributes in the XLink namespace and with the prefix <code>xlink:</code>. 
 			Polyglot markup <em title="must" class="rfc2119">must</em> declare the XLink namespace on the HTML root element (<code>&lt;html&gt;</code>) or once on the foreign element where is used (<code>&lt;svg&gt;</code> or <code>&lt;mathml&gt;</code>), to maintain XML-compatibility [<cite><a href="#bib-XML10" rel="biblioentry" class="bibref">XML10</a></cite>].
 		</p>
-		<p>In polyglot markup, the xlink prefix uses the namespace declaration <code>xmlns:xlink="http://www.w3.org/1999/xlink"</code>  before using the xlink prefix for the following elements:
+		<p>In polyglot markup, the xlink prefix uses the namespace declaration <code>xmlns:xlink="http://www.w3.org/1999/xlink"</code>  before using the xlink prefix for the following attributes:
 			</p><ul>
 				<li><code>xlink:actuate</code></li>
 				<li><code>xlink:arcrole</code></li>
@@ -956,25 +962,18 @@
 		<div id="attribute-values" class="section">
 		<h4><span class="secno">6.3.3 </span>Attribute Values</h4>
 		<p>
-			Polyglot markup uses lowercase letters for the values of the 
-attributes in the following list when they exist on HTML elements. 
-			More specifically, where required, polyglot markup <em title="must" class="rfc2119">must</em>
- use lower case letters for all ASCII letters in these attribute values;
- 
-			however, polyglot markup respects case sensitivity for non-ASCII 
-letters such as Greek, Cyrillic, or non-ASCII Latin letters. 
-			For attribute values on HTML elements other than those in the 
-following list, polyglot markup <em title="may" class="rfc2119">may</em> use mixed case letters. 
-		</p>
-		<p>
-			Because XML is case sensitive, polyglot markup also requires case to 
-be consistent for values between markup, DOM APIs, and CSS. 
+			Polyglot markup requires the case used for characters in the values 
+of the following attributes to be consistent between markup, DOM APIs, 
+and CSS 
+			when these attributes are used on HTML elements. 
+			This is because XML is case sensitive, but the values of these 
+attributes are treated as case insensitive in HTML when matched via CSS 
+selectors 
+			(See <a href="http://dev.w3.org/html5/spec/links.html#selectors">4.14.1 Case-sensitivity</a>, in the HTML5 specification). [<cite><a href="#bib-HTML5" rel="biblioentry" class="bibref">HTML5</a></cite>]
+  
 			In addition, polyglot markup respects the case sensitivity of all 
-other attribute values. 
-			Although polyglot markup must always have lowercase values of the 
-attributes in the following list when they exist on HTML elements, 
-			attributes not in this list and attributes on non-HTML elements may 
-have values made of mixed case letters. 
+other attribute values and for non-ASCII characters in the values of the
+ attributes listed. 
 			Note that other specifications, such as RDFa, may place additional 
 restrictions on the allowed values of certain attributes. 
 		</p>
@@ -1070,6 +1069,20 @@
 		Within polyglot markup, the text within either a <code>&lt;textarea&gt;</code> or <code>&lt;pre&gt;</code> element <em title="must not" class="rfc2119">must not</em> begin with white space.
 <!--End section: White Space in textarea and pre Elements-->	
 		</div>
+		
+		<div id="elements-that-cannot-contain-special-characters" class="section">
+		<h4><span class="secno">6.5.2 </span>Elements that Cannot Contain Special Characters</h4>
+		<p>
+			Due to the conflict between parsing rules between HTML and XML, 
+polyglot markup uses the following elements only if they do not contain 
+angled brackets ("&lt;" or "&gt;") or ampersands ("&amp;").
+		</p>
+			<ul>
+				<li><code>plaintext</code></li>
+				<li><code>xmp</code></li>
+			</ul>
+<!--End Section: Elements that Cannot Contain Special Characters-->		
+		</div>
 
 <!--End section: Elements with Special Considerations-->	
 	</div>
@@ -1275,4 +1288,5 @@
 </div>
 
 </body>
+
 </html>
\ No newline at end of file
Received on Friday, 29 October 2010 20:34:48 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Friday, 29 October 2010 20:34:52 GMT