- From: Eliot Graff via cvs-syncmail <cvsmail@w3.org>
- Date: Tue, 04 May 2010 21:05:52 +0000
- To: public-html-commits@w3.org
Update of /sources/public/html5/html-xhtml-author-guide
In directory hutz:/tmp/cvs-serv18640
Modified Files:
html-xhtml-authoring-guide.html
Log Message:
Removed requirement to include a space before the trailing / and > of empty elements; replaced attribute "values" with either "letters" or "characters" as appropriate; In section 4, changed "guidelines" to "rules";
Index: html-xhtml-authoring-guide.html
===================================================================
RCS file: /sources/public/html5/html-xhtml-author-guide/html-xhtml-authoring-guide.html,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -d -r1.4 -r1.5
--- html-xhtml-authoring-guide.html 22 Apr 2010 14:07:12 -0000 1.4
+++ html-xhtml-authoring-guide.html 4 May 2010 21:05:50 -0000 1.5
@@ -1,18 +1,13 @@
<!DOCTYPE HTML>
<html dir="ltr" lang="en"><head>
-
<title>HTML/XHTML Compatibility Authoring Guidelines</title>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<!--
-
=== NOTA BENE ===
-
For the three scripts below, if your spec resides on dev.w3 you can check them
-
out in the same tree and use relative links so that they'll work offline,
-
-->
@@ -20,8 +15,7 @@
href="html-xhtml-authoring-guide_files/respec.css"><link charset="utf-8"
type="text/css" rel="stylesheet"
href="html-xhtml-authoring-guide_files/W3C-ED.css"></head><body
-style="display: inherit;"><div firebugversion="1.5.3" style="display:
-none;" id="_firebugConsole"></div><div class="head"><p><a
+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">HTML/XHTML
@@ -30,12 +24,9 @@
Consortium">W3C</acronym> Editor's Draft 21 April 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/xxx-xxx/">http://www.w3.org/TR/xxx-xxx/</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>none</dd><dt>Editor:</dt><dd>Eliot Graff, Microsoft
Corporation</dd></dl><p class="copyright"><a
href="http://www.w3.org/Consortium/Legal/ipr-notice#Copyright">Copyright</a>
@@ -51,7 +42,6 @@
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>
<p>This document summarizes design guidelines for authors who wish
@@ -64,6 +54,11 @@
rel="biblioentry" class="bibref">HTML5</a>] and [<a href="#bib-RFC2854"
rel="biblioentry" class="bibref">RFC2854</a>] respectively.
</p>
+ <p><strong>Note:</strong> If your browser does not render the
+fully-formatted version of this document with images and color fonts,
+please see <a
+href="http://dev.w3.org/html5/html-xhtml-author-guide/html-xhtml-authoring-guide-rendered.html">the
+ version without scripts</a>.</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
@@ -78,7 +73,6 @@
href="mailto:public-html@w3.org">public-html@w3.org</a> (<a
href="mailto:public-html-request@w3.org?subject=subscribe">subscribe</a>,
<a href="http://lists.w3.org/Archives/Public/public-html/">archives</a>).
-
All feedback is welcome.</p><p>Publication as a Editor's Draft does not
imply endorsement by the <acronym title="World Wide Web Consortium">W3C</acronym>
Membership. This is a draft document and may be updated, replaced or
@@ -94,10 +88,8 @@
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 <acronym title="World Wide Web Consortium">W3C</acronym>
Patent Policy</a>.</p></div><div class="section" id="toc"><h2
class="introductory">Table of Contents</h2><ul class="toc"><li
@@ -109,10 +101,8 @@
class="secno">3. </span>The DOCTYPE</a></li><li class="tocline"><a
class="tocxref" href="#namespaces"><span class="secno">4. </span>Namespaces</a></li><li
class="tocline"><a class="tocxref" href="#elements"><span class="secno">5.
-
</span>Elements</a><ul class="toc"><li class="tocline"><a
class="tocxref" href="#required-elements"><span class="secno">5.1 </span>Required
-
Elements</a><ul class="toc"><li class="tocline"><a class="tocxref"
href="#tables"><span class="secno">5.1.1 </span>Tables</a></li></ul></li><li
class="tocline"><a class="tocxref" href="#case-sensitivity"><span
@@ -120,20 +110,17 @@
class="tocline"><a class="tocxref" href="#element-names"><span
class="secno">5.2.1 </span>Element Names</a></li><li class="tocline"><a
class="tocxref" href="#attribute-names"><span class="secno">5.2.2 </span>Attribute
-
Names</a></li><li class="tocline"><a class="tocxref"
-href="#attribute-values"><span class="secno">5.2.3 </span>Attribute
-Values</a></li></ul></li><li class="tocline"><a class="tocxref"
+href="#attribute-characters"><span class="secno">5.2.3 </span>Attribute
+Characters</a></li></ul></li><li class="tocline"><a class="tocxref"
href="#empty-elements"><span class="secno">5.3 </span>Empty Elements</a></li></ul></li><li
class="tocline"><a class="tocxref" href="#attributes"><span
class="secno">6. </span>Attributes</a></li><li class="tocline"><a
class="tocxref" href="#named-entity-references"><span class="secno">7. </span>Named
-
Entity References</a></li><li class="tocline"><a class="tocxref"
href="#script-and-style"><span class="secno">8. </span>Script and Style</a><ul
class="toc"><li class="tocline"><a class="tocxref"
href="#external-script-and-style"><span class="secno">8.1 </span>External
-
Script and Style</a></li><li class="tocline"><a class="tocxref"
href="#in-line-script-and-style"><span class="secno">8.2 </span>In-line
Script and Style</a></li></ul></li><li class="tocline"><a
@@ -163,13 +150,9 @@
documents and XML documents.
<!-- <ul>
-
TODO: in this section:
-
<li>Offer "top-tier" summary of general guidelines to conform to polyglot language.</li>
-
<li>Link to more detailed analysis below.</li>
-
</ul> -->
</p>
@@ -200,7 +183,6 @@
<p>
For a polyglot document, you <em title="must" class="rfc2119">must</em>
use the <a href="http://dev.w3.org/html5/spec/syntax.html#the-doctype">HTML
-
DOCTYPE</a>.
</p>
</div>
@@ -208,7 +190,7 @@
<div class="section" id="namespaces">
<!--OddPage--><h2><span class="secno">4. </span>Namespaces</h2>
<p>
- The following guidelines apply to namespaces used in polyglot
+ The following rules apply to namespaces used in polyglot
documents.
</p>
<ul>
@@ -433,11 +415,11 @@
</ul>
</div>
- <div class="section" id="attribute-values">
- <h4><span class="secno">5.2.3 </span>Attribute Values</h4>
+ <div class="section" id="attribute-characters">
+ <h4><span class="secno">5.2.3 </span>Attribute Characters</h4>
<p>
You <em title="must" class="rfc2119">must</em> specify attribute
-values as lowercase.
+letters as lowercase.
</p>
</div>
</div>
@@ -466,14 +448,8 @@
<li><code>source</code></li>
</ul>
<p>
- You <em title="should" class="rfc2119">should</em> include a
-space before the trailing <code>/</code> and <code>></code> of empty
-elements, e.g. <code><br /></code>, <code><hr /></code> and <code><img
-
- src="karen.jpg" alt="Karen" /></code>.
- Also, you <em title="should" class="rfc2119">should</em> use the
- minimized tag syntax for empty elements, e.g. <code><br /></code>.
-
+ You <em title="should" class="rfc2119">should</em> use the
+minimized tag syntax for empty elements, e.g. <code><br/></code>.
The alternative syntax <code><br></br></code>
allowed by XML gives uncertain results in many existing user agents.
</p>
@@ -481,7 +457,6 @@
Given an empty instance of an element whose content model is not
EMPTY (for example, an empty title or paragraph) do not use the
minimized form (e.g. use <code><p> </p></code> and not <code><p
-
/></code>).
</p>
<p>
@@ -494,8 +469,8 @@
<div class="section" id="attributes">
<!--OddPage--><h2><span class="secno">6. </span>Attributes</h2>
<p>Avoid line breaks and multiple white space characters within
-attribute values. These are handled inconsistently by user agents.</p>
- <p>See also <a href="#attribute-values">Attribute Values</a>.</p>
+attribute characters. These are handled inconsistently by user agents.</p>
+ <p>See also <a href="#attribute-values">Attribute Characters</a>.</p>
</div>
@@ -633,7 +608,6 @@
class="secno">B. </span>References</h2><div class="section"
id="normative-references"><h3><span class="secno">B.1 </span>Normative
references</h3><dl class="bibliography"><dt id="bib-HTML5">[HTML5]</dt><dd>Ian
-
Hickson; David Hyatt. <a
href="http://www.w3.org/TR/2010/WD-html5-20100304/"><cite>HTML 5.</cite></a>
4 March 2010. W3C Working Draft. (Work in progress.) URL: <a
Received on Tuesday, 4 May 2010 21:05:54 UTC