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

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

From: Eliot Graff via cvs-syncmail <cvsmail@w3.org>
Date: Fri, 08 Oct 2010 20:30:19 +0000
To: public-html-commits@w3.org
Message-Id: <E1P4Ja7-0000Mj-3q@lionel-hutz.w3.org>
Update of /sources/public/html5/html-xhtml-author-guide
In directory hutz:/tmp/cvs-serv1391

Modified Files:
	html-xhtml-authoring-guide.html 
Log Message:
Added sentence prohibiting BOM for UTF-8 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.39
retrieving revision 1.40
diff -u -d -r1.39 -r1.40
--- html-xhtml-authoring-guide.html	8 Oct 2010 19:27:34 -0000	1.39
+++ html-xhtml-authoring-guide.html	8 Oct 2010 20:30:17 -0000	1.40
@@ -482,57 +482,52 @@
 </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>
+<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 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><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. 
 		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> 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">
+<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>
+
 <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>
@@ -598,7 +593,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>
@@ -625,6 +619,7 @@
 <!--OddPage--><h2><span class="secno">3. </span>Specifying a Document's Character Encoding</h2>
 	<p>
 		Polyglot markup uses either UTF-8 or UTF-16. UTF-8 is preferred.
+		When polyglot markup uses UTF-16, it <em title="must not" class="rfc2119">must not</em> include a BOM.
 		When polyglot markup uses UTF-16, it <em title="must" class="rfc2119">must</em> include the BOM indicating 
 		little-endian UTF-16 or big-endian UTF-16. 
 	</p>
Received on Friday, 8 October 2010 20:30:21 GMT

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