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

html5/html-xhtml-author-guide html-xhtml-authoring-guide.html,1.37,1.38

From: Eliot Graff via cvs-syncmail <cvsmail@w3.org>
Date: Fri, 08 Oct 2010 18:48:07 +0000
To: public-html-commits@w3.org
Message-Id: <E1P4HzD-0005S6-Lq@lionel-hutz.w3.org>
Update of /sources/public/html5/html-xhtml-author-guide
In directory hutz:/tmp/cvs-serv20929

Modified Files:
	html-xhtml-authoring-guide.html 
Log Message:
Updated language around non-ASCII characters in Case Sensitivity and Attribute Values, per bug 10153; added link to  i18n group recommendation for character encoding;

Index: html-xhtml-authoring-guide.html
===================================================================
RCS file: /sources/public/html5/html-xhtml-author-guide/html-xhtml-authoring-guide.html,v
retrieving revision 1.37
retrieving revision 1.38
diff -u -d -r1.37 -r1.38
--- html-xhtml-authoring-guide.html	7 Oct 2010 18:44:46 -0000	1.37
+++ html-xhtml-authoring-guide.html	8 Oct 2010 18:48:05 -0000	1.38
@@ -479,7 +479,7 @@
 pre.sh_sourceCode .sh_paren { color: red; }
 pre.sh_sourceCode .sh_attribute { color: #006400; }
 
-</style><link charset="utf-8" type="text/css" rel="stylesheet" href="html-xhtml-authoring-guide_files/W3C-ED.css"></head><body style="display: inherit;"><div class="head"><p><a href="http://www.w3.org/"><img 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-07-october-2010">W3C Editor's Draft 07 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>
+</style><link charset="utf-8" type="text/css" rel="stylesheet" href="html-xhtml-authoring-guide_files/W3C-ED.css"></head><body style="display: inherit;"><div class="head"><p><a href="http://www.w3.org/"><img 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-08-october-2010">W3C Editor's Draft 08 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> © 2010 <a href="http://www.w3.org/"><acronym title="World Wide Web 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>
 
 <div class="introductory section" id="abstract"><h2>Abstract</h2>A 
@@ -514,14 +514,17 @@
 		Nor does it define the meaning of the Internet Media Type text/html. 
 For user agent guidance and for these definitions, see [<cite><a href="#bib-HTML5" rel="biblioentry" class="bibref">HTML5</a></cite>] and [<cite><a href="#bib-RFC2854" rel="biblioentry" class="bibref">RFC2854</a></cite>]. 
 	</p>
-	<p>This document was published by the <a href="http://www.w3.org/html/wg/">HTML</a> as an Editor's Draft. Please submit comments regarding this document by using the W3C's public bug database (<a href="http://www.w3.org/Bugs/Public/">http://www.w3.org/Bugs/Public/</a>) with the product set to <kbd>HTML WG</kbd> and the component set to <kbd>HTML/XHTML Compatibility Authoring Guide (ed: Eliot Graff)</kbd>.
+	<p>
+		This document was published by the <a href="http://www.w3.org/html/wg/">HTML working group</a> as an Editor's Draft. 
+		Please submit comments regarding this document by using the W3C's public bug database (<a href="http://www.w3.org/Bugs/Public/">http://www.w3.org/Bugs/Public/</a>) with the product set to <kbd>HTML WG</kbd> and the component set to <kbd>HTML/XHTML Compatibility Authoring Guide (ed: Eliot Graff)</kbd>.
 		If you cannot access the bug database, submit comments to <a href="mailto:public-html@w3.org@w3.org">public-html@w3.org@w3.org</a> (<a href="mailto:public-html@w3.org-request@w3.org?subject=subscribe">subscribe</a>, <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>
-<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="" rel="disclosure">public list of any patent disclosures</a>
+	<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="" 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><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="#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></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="#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 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>
@@ -576,14 +579,11 @@
 	<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.
-		Note that the W3C Internationalization (i18n) Group recommends to 
-always include a visible encoding declaration in a document, because it 
-helps developers, testers, or translation production managers to check 
-the encoding of a document visually.
-		<!-- TODO: need citation for i18n recommendation -->
+		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.
+		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 
+check the encoding of a document visually.
 	</p>
 </div>
 
@@ -713,9 +713,9 @@
 		<p>
 			The following guidelines apply to any usage of element names, 
 attribute names, or attribute values in markup, script, or CSS.
-			When required, polyglot markup uses lower case letters for all ASCII 
-letters; however, case requirements do not apply to non-ASCII letters 
-such as Greek, Cyrillic, or non-ASCII Latin letters.
+			Polyglot markup uses lower case letters for all ASCII letters. For 
+non-ASCII letters—such as Greek, Cyrillic, or non-ASCII Latin 
+letters—polyglot markup respects case sensitivity as it is called for.
 		</p>
 		
 		
@@ -846,25 +846,28 @@
 
 		<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.
+		<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, case requirements do not apply to non-ASCII letters such as 
-Greek, Cyrillic, or non-ASCII Latin letters.
+ 
+			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>	
+		<p>
 			Because XML is case sensitive, polyglot markup also requires case to 
 be consistent for values between markup, DOM APIs, and CSS. 
 			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. 
+			attributes not in this list and attributes on non-HTML elements may 
+have values made of mixed case letters. 
 			Note that other specifications, such as RDFa, may place additional 
-restrictions on the allowed values of certain attributes.
+restrictions on the allowed values of certain attributes. 
 		</p>
 			<ul>
 				<li><code>accept</code></li>
@@ -1100,9 +1103,12 @@
 
 <div id="acknowledgements" class="appendix section">
 <!--OddPage--><h2><span class="secno">A. </span>Acknowledgements</h2>
-<p>Many thanks to Daniel Glazman, Tony Ross, Sam Ruby, Jonas Sicking, 
-Leif Halvard Silli, Henri Sivonen, and Philip Taylor. Special thanks to 
-the W3C TAG.
+<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>
 </div>
 
Received on Friday, 8 October 2010 18:48:09 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Friday, 8 October 2010 18:48:11 GMT