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

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

From: Eliot Graff via cvs-syncmail <cvsmail@w3.org>
Date: Fri, 08 Oct 2010 19:27:37 +0000
To: public-html-commits@w3.org
Message-Id: <E1P4IbR-0006y1-1o@lionel-hutz.w3.org>
Update of /sources/public/html5/html-xhtml-author-guide
In directory hutz:/tmp/cvs-serv26767

Modified Files:
	html-xhtml-authoring-guide.html 
Log Message:
Updated wording in Language Attributes per recommendations in bug 10152

Index: html-xhtml-authoring-guide.html
===================================================================
RCS file: /sources/public/html5/html-xhtml-author-guide/html-xhtml-authoring-guide.html,v
retrieving revision 1.38
retrieving revision 1.39
diff -u -d -r1.38 -r1.39
--- html-xhtml-authoring-guide.html	8 Oct 2010 18:48:05 -0000	1.38
+++ html-xhtml-authoring-guide.html	8 Oct 2010 19:27:34 -0000	1.39
@@ -482,37 +482,35 @@
 </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 
-document that uses polyglot markup is document that is a stream of bytes
- that parses into identical document trees (with the exception of the 
-xmlns attribute on the root element) when processed as HTML and when 
-processed as XML.
-Polyglot markup that meets a well defined set of constraints is 
-interpreted as compatible, regardless of whether they are processed as 
-HTML or as XHTML, per the HTML5 specification. 
-Polyglot markup uses a specific DOCTYPE, namespace declarations, and a 
-specific case—normally lower case but occasionally camel case—for 
-element and attribute names. 
-Polyglot markup uses lower case for certain attribute values. 
-Further constraints include those on empty elements, named entity 
-references, and the use of scripts and style. 
+<div class="introductory section" id="abstract">
+<h2>Abstract</h2>
+	A document that uses polyglot markup is document that is a stream of bytes that parses into identical document trees (with the exception of the 
+	xmlns attribute on the root element) when processed as HTML and when processed as XML.
+	Polyglot markup that meets a well defined set of constraints is interpreted as compatible, regardless of whether they are processed as 
+	HTML or as XHTML, per the HTML5 specification. 
+	Polyglot markup uses a specific DOCTYPE, namespace declarations, and a specific case—normally lower case but occasionally camel case—for 
+	element and attribute names. 
+	Polyglot markup uses lower case for certain attribute values. 
+	Further constraints include those on empty elements, named entity references, and the use of scripts and style. 
+</div>
 
-</div><div id="sotd" class="introductory section"><h2>Status of This Document</h2><p><em>This
- section describes the status of this document at the time of its 
-publication. Other documents may supersede this document. A list of 
-current W3C publications and the latest revision of this technical 
-report can be found in the <a href="http://www.w3.org/TR/">W3C technical reports index</a> at http://www.w3.org/TR/.</em></p>
+<div id="sotd" class="introductory section">
+<h2>Status of This Document</h2>
+	<p><em>
+		This section describes the status of this document at the time of its publication. 
+		Other documents may supersede this document. 
+		A list of current W3C publications and the latest revision of this technical report can be found in the 
+		<a href="http://www.w3.org/TR/">W3C technical reports index</a> at http://www.w3.org/TR/.
+	</em></p>
 	<p>
-		This document summarizes design guidelines for authors who wish their 
-XHTML or HTML documents to validate on either HTML or XML parsers, 
-assuming the parsers to be HTML5-compliant. 
+		This document summarizes design guidelines for authors who wish their XHTML or HTML documents to validate on either HTML or XML parsers, 
+		assuming the parsers to be HTML5-compliant. 
 		This specification is intended to be used by web authors. 
-		It is not a specification for user agents and creates no obligations 
-on user agents. 
-		Note that this recommendation does not define how HTML5-conforming 
-user agents should process HTML documents. 
+		It is not a specification for user agents and creates no obligations on user agents. 
+		Note that this recommendation does not define how HTML5-conforming user agents should process HTML documents. 
 		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>]. 
+		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 working group</a> as an Editor's Draft. 
@@ -521,13 +519,83 @@
 		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.
+		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>
+	<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>
 
 
 
@@ -988,14 +1056,9 @@
 	
 	<div id="language-attributes" class="section">
 	<h3><span class="secno">7.2 </span>Language Attributes</h3>
-		<p>Polyglot markup <em title="should" class="rfc2119">should</em> use the language attributes in the <code>html</code> element to set the default language for the document.</p>
 		<p>When using language attributes, polyglot markup <em title="must" class="rfc2119">must</em> use both the <code>lang</code> and <code>xml:lang</code> attributes. 
-			Neither attribute is to be used without the other.</p>
-		<!-- TODO Need to verify that XML ignores this
-
-		<p>Note that polyglot markup does not use the meta <code>Content-Language</code> element, as this element has no effect in XML for setting the language of content.</p>
-
-		-->
+			Neither attribute is to be used without the other, and the values for both <code>lang</code> and <code>xml:lang</code> <em title="must" class="rfc2119">must</em> be the same.</p>
+		<p>Polyglot markup <em title="should" class="rfc2119">should</em> use the language attributes in the <code>html</code> element to set the default language for the document.</p>
 	</div>
 
 </div>
Received on Friday, 8 October 2010 19:27:39 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Friday, 8 October 2010 19:27:40 GMT