- From: Michael Smith via cvs-syncmail <cvsmail@w3.org>
- Date: Sun, 08 Aug 2010 09:49:22 +0000
- To: public-html-commits@w3.org
Update of /sources/public/html5/markup/src
In directory hutz:/tmp/cvs-serv30660/src
Modified Files:
datatypes.html documents.html header.src.html intro-scope.html
references.html syntax.html
Log Message:
further knob-turning of index and references sections
Index: documents.html
===================================================================
RCS file: /sources/public/html5/markup/src/documents.html,v
retrieving revision 1.12
retrieving revision 1.13
diff -u -d -r1.12 -r1.13
--- documents.html 4 Aug 2010 12:59:18 -0000 1.12
+++ documents.html 8 Aug 2010 09:49:20 -0000 1.13
@@ -47,10 +47,11 @@
<dfn id="xml-syntax"
title="xml-syntax"
>XML syntax</dfn>
- is defined by rules in the XML specification
+ is defined by rules in the
<a href="#refsXML">[XML]</a>
- and in the Namespaces in XML 1.0 specification
- <a href="#refsXMLNS">[XMLNS]</a>;
+ specification and in the
+ <a href="#refsNamespacesInXML">[Namespaces In XML]</a>
+ specification;
any syntax-level requirements for
<a href="#syntax-document-xml">documents in the XML syntax</a>
described in this reference are intended to be the same as
@@ -126,9 +127,9 @@
<a href="#must-requirement">must</a>
be a
<dfn id="namespace-well-formed-xml-document">namespace-well-formed</dfn>
- XML document, as defined in the Namespaces in XML 1.0 specification
- <a href="#refsXML">[XMLNS]</a>,
- and its
+ XML document, as defined in the
+ <a href="#refsNamespacesInXML">[Namespaces in XML]</a>
+ specification, and its
<dfn id="root-element">root element</dfn>
<a href="#must-requirement">must</a>
be an
Index: datatypes.html
===================================================================
RCS file: /sources/public/html5/markup/src/datatypes.html,v
retrieving revision 1.51
retrieving revision 1.52
diff -u -d -r1.51 -r1.52
--- datatypes.html 4 Aug 2010 12:59:18 -0000 1.51
+++ datatypes.html 8 Aug 2010 09:49:19 -0000 1.52
@@ -300,7 +300,7 @@
title="date-time"
>date-time</dfn>,
as defined in
- <a href="#refsRFC3339">[RFC3339]</a>,
+ <a href="#refsRFC3339">[RFC 3339]</a>,
with these additional qualifications:
<ul>
<li>the literal letters <code>T</code> and
@@ -344,7 +344,7 @@
title="data.iri-ref"
>IRI reference</dfn>,
as defined in
- <a href="#refsRFC3987">[RFC3987]</a>.</div>
+ <a href="#refsRFC3987">[RFC 3987]</a>.</div>
<div class="note">
<p>The empty string is a valid
<a href="#data.iri-ref">IRI reference</a>,
@@ -393,7 +393,7 @@
<div class="datatype-desc">An
<dfn id="data.iri">IRI</dfn>,
as defined in
- <a href="#refsRFC3987">[RFC3987]</a>.</div>
+ <a href="#refsRFC3987">[RFC 3987]</a>.</div>
</dd>
<dd>
<div class="example">
@@ -429,12 +429,9 @@
<dd></dd>
<dd>
<div class="datatype-desc">A string that identifies a valid
- <dfn
- id="mime-media-type"
- title="mime-media-type"
- >MIME media type</dfn>,
+ <var class="defined-elsewhere">MIME media type</var>,
as defined in
- <a href="#refsRFC2046">[RFC2046]</a>.</div> </dd>
+ <a href="#refsRFC2046">[RFC 2046]</a>.</div> </dd>
</dl>
<dl><dt>charset</dt>
<dd></dd>
@@ -450,10 +447,9 @@
>character set name</dfn>
given in a <code>Name</code> or <code>Alias</code> field
labeled as “preferred MIME name” in the IANA
- <cite>Character Sets</cite> registry
- <a href="#refsIANACHARSET">[IANACHARSET]</a>,
- if there is one; or if none of the <code>Alias</code>
- fields are so labeled, a
+ <a href="#refsCharacterSets">[Character Sets]</a>
+ registry, if there is one; or if none of the
+ <code>Alias</code> fields are so labeled, a
<a href="#case-insensitive">case-insensitive match</a>
for a <code>Name</code> field in the registry.
<p>For documents in the <a href="#xml-syntax">XML
@@ -517,28 +513,22 @@
<a href="#data-string">string</a>.</div>
</dd>
</dl>
- <dl><dt>mediaquery</dt>
+ <dl><dt>langcode</dt>
<dd></dd>
<dd>
<div class="datatype-desc">A valid
- <dfn
- id="media-query"
- title="media-query"
- >media query list</dfn>,
+ <var class="defined-elsewhere">language tag</var>,
as defined in
- <a href="#refsMediaQueries">[MediaQueries]</a>.</div>
+ <a href="#refsBCP47">[BCP 47]</a>.</div>
</dd>
</dl>
- <dl><dt>langcode</dt>
+ <dl><dt>mediaquery</dt>
<dd></dd>
<dd>
<div class="datatype-desc">A valid
- <dfn
- id="language-tag"
- title="language-tag"
- >language tag</dfn>,
+ <var class="defined-elsewhere">media query list</var>,
as defined in
- <a href="#refsBCP47">[BCP47]</a>.</div>
+ <a href="#refsMediaQueries">[Media Queries]</a>.</div>
</dd>
</dl>
<dl><dt>mimetypelist</dt>
@@ -581,8 +571,8 @@
<a href="#must-requirement">must</a>
match the JavaScript
<var class="defined-elsewhere">Pattern</var>
- production
- <a href="#refsECMA262">[ECMA262]</a>.</div>
+ production as specified in
+ <a href="#refsECMA262">[ECMA 262]</a>.</div>
</dd>
</dl>
<dl><dt>datetime-local</dt>
@@ -613,7 +603,7 @@
title="full-date"
>full-date</dfn>,
as defined in
- <a href="#refsRFC3339">[RFC3339]</a>,
+ <a href="#refsRFC3339">[RFC 3339]</a>,
with the additional qualification that the year component is
four or more digits representing a number greater than 0.</div>
<div class="example">
@@ -689,7 +679,7 @@
title="partial-time"
>partial-time</dfn>,
as defined in
- <a href="#refsRFC3339">[RFC3339]</a>.</div>
+ <a href="#refsRFC3339">[RFC 3339]</a>.</div>
</dd>
<dd>
<div class="example">
@@ -710,11 +700,11 @@
<p>…where
<var class="defined-elsewhere">atext</var>
is as defined in
- <a href="#refsRFC5322">[RFC5322]</a>,
+ <a href="#refsRFC5322">[RFC 5322]</a>,
and
<var class="defined-elsewhere">ldh-str</var>
is as defined in
- <a href="#refsRFC1034">[RFC1034]</a>.</p>
+ <a href="#refsRFC1034">[RFC 1034]</a>.</p>
</div>
<div class="example">
<p>Examples:</p>
Index: header.src.html
===================================================================
RCS file: /sources/public/html5/markup/src/header.src.html,v
retrieving revision 1.43
retrieving revision 1.44
diff -u -d -r1.43 -r1.44
--- header.src.html 31 Jul 2010 20:31:25 -0000 1.43
+++ header.src.html 8 Aug 2010 09:49:20 -0000 1.44
@@ -52,8 +52,7 @@
It is intended to complement the normative conformance
criteria defined in the
<a href="http://dev.w3.org/html5/spec/">HTML5: A vocabulary and associated APIs for HTML and XHTML</a>
- specification
- <a href="references.html#refsHTML5">[HTML5]</a>,
+ specification,
as well as information in related deliverables published by
the HTML Working Group and from other sources.
By design, this reference does not describe related APIs in detail,
Index: references.html
===================================================================
RCS file: /sources/public/html5/markup/src/references.html,v
retrieving revision 1.24
retrieving revision 1.25
diff -u -d -r1.24 -r1.25
--- references.html 4 Aug 2010 12:59:18 -0000 1.24
+++ references.html 8 Aug 2010 09:49:20 -0000 1.25
@@ -7,7 +7,7 @@
href="http://tools.ietf.org/html/std68"
>Augmented BNF for Syntax Specifications: ABNF</a></cite>.
D. Crocker, P. Overell.</dd>
- <dt><dfn id="refsBCP47">BCP47</dfn></dt>
+ <dt><dfn id="refsBCP47">BCP 47</dfn></dt>
<dd><cite><a href="http://tools.ietf.org/html/bcp47"
>Tags for Identifying Languages</a></cite>. A.
Phillips, M. Davis.</dd>
@@ -15,11 +15,15 @@
tags, see in particular <a
href="http://tools.ietf.org/html/bcp47#appendix-A"
>http://tools.ietf.org/html/bcp47#appendix-A</a>)</span></dd>
+ <dt><dfn id="refsCharacterSets">Character Sets</dfn></dt>
+ <dd><cite><a
+ href="http://www.iana.org/assignments/character-sets"
+ >Character Sets</a></cite>. Internet Assigned Numbers Authority (IANA).</dd>
<dt><dfn id="refsCSS">CSS</dfn></dt>
<dd><cite><a href="http://www.w3.org/TR/2008/WD-css-beijing-20080516/"
>Cascading Style Sheets (CSS) Snapshot 2007</a></cite>.
Elika J. Etemad.</dd>
- <dt><dfn id="refsDOMCORE">DOMCORE</dfn></dt>
+ <dt><dfn id="refsDOMCore">DOM Core</dfn></dt>
<dd><cite><a
href="http://www.w3.org/TR/DOM-Level-3-Core/"
>Document Object Model (DOM) Level 3 Core</a></cite>.
@@ -34,17 +38,11 @@
<dd><span class="references-note" >(see in particular <a
href="http://www.w3.org/TR/DOM-Level-3-Core/core.html#Node3-textContent"
>http://www.w3.org/TR/DOM-Level-3-Core/core.html#Node3-textContent</a>)</span></dd>
- <dt><dfn id="refsECMA262">ECMA262</dfn></dt>
+ <dt><dfn id="refsECMA262">ECMA 262</dfn></dt>
<dd><cite><a
href="http://www.ecma-international.org/publications/standards/Ecma-262.htm"
>ECMAScript Language Specification</a></cite>.
5th edition.</dd>
- <dt><dfn id="refsEntities">Entities</dfn></dt>
- <dd><cite><a
- href="http://www.w3.org/TR/xml-entity-names/"
- >XML Entity definitions for Characters</a></cite>.
- David Carlisle, Patrick Ion.
- W3C Recommendation.</dd>
<dd><span class="references-note" >(see in particular <a
href="http://www.w3.org/TR/xml-entity-names/byalpha.html"
>http://www.w3.org/TR/xml-entity-names/byalpha.html</a>)</span></dd>
@@ -54,17 +52,13 @@
>HTML 5: A vocabulary and associated APIs for HTML and XHTML</a></cite>.
Ian Hickson.
W3C Editor’s Draft.</dd>
- <dt><dfn id="refsHTML5AUTHOR">HTML5AUTHOR</dfn></dt>
+ <dt><dfn id="refsHTML5ForWebAuthors">HTML5 for Web Authors</dfn></dt>
<dd><cite><a
href="http://dev.w3.org/html5/spec-author-view/"
>HTML5 (Edition for Web Authors)</a></cite>.
Ian Hickson.
W3C Editor’s Draft.</dd>
- <dt><dfn id="refsIANACHARSET">IANACHARSET</dfn></dt>
- <dd><cite><a
- href="http://www.iana.org/assignments/character-sets"
- >Character Sets</a></cite>. Internet Assigned Numbers Authority (IANA).</dd>
- <dt><dfn id="refsMediaQueries">MediaQueries</dfn></dt>
+ <dt><dfn id="refsMediaQueries">Media Queries</dfn></dt>
<dd><cite><a
href="http://www.w3.org/TR/2009/CR-css3-mediaqueries-20090915/"
>Media Queries</a></cite>.
@@ -73,34 +67,39 @@
<dd><span class="references-note" >(see in particular <a
href="http://www.w3.org/TR/2009/CR-css3-mediaqueries-20090915/#syntax"
>http://www.w3.org/TR/2009/CR-css3-mediaqueries-20090915/#syntax</a>)</span></dd>
- <dt><dfn id="refsRFC1034">RFC1034</dfn></dt>
+ <dt><dfn id="refsNamespacesInXML">Namespaces in XML</dfn></dt>
+ <dd><cite><a href="http://www.w3.org/TR/xml-names/"
+ >Namespaces in XML 1.0</a></cite>.
+ Tim Bray, Dave Hollander, Andrew Layman, Richard Tobin.
+ W3C Recommendation.</dd>
+ <dt><dfn id="refsRFC1034">RFC 1034</dfn></dt>
<dd><cite><a href="http://tools.ietf.org/html/rfc1034" >Internet
Message Format</a></cite>. P. Mockapetris.</dd>
<dd><span class="references-note" >(see in particular <a
href="http://tools.ietf.org/html/rfc1034#section-3.5"
>http://tools.ietf.org/html/rfc1034#section-3.5</a></span></dd>
- <dt><dfn id="refsRFC2046">RFC2046</dfn></dt>
+ <dt><dfn id="refsRFC2046">RFC 2046</dfn></dt>
<dd><cite><a href="http://tools.ietf.org/html/rfc2046"
>Multipurpose Internet Mail Extensions (MIME) Part Two: Media Types</a></cite>.
N. Freed, N. Borenstein.</dd>
<dd><span class="references-note" >(see in particular <a
href="http://tools.ietf.org/html/rfc2046#section-2"
>http://tools.ietf.org/html/rfc2046#section-2</a>)</span></dd>
- <dt><dfn id="refsRFC3339">RFC3339</dfn></dt>
+ <dt><dfn id="refsRFC3339">RFC 3339</dfn></dt>
<dd><cite><a href="http://tools.ietf.org/html/rfc3339" >Date and
Time on the Internet: Timestamps</a></cite>.
G. Klyne, C. Newman.</dd>
<dd><span class="references-note" >(see in particular <a
href="http://tools.ietf.org/html/rfc3339#section-5.6"
>http://tools.ietf.org/html/rfc3339#section-5.6</a>)</span></dd>
- <dt><dfn id="refsRFC3987">RFC3987</dfn></dt>
+ <dt><dfn id="refsRFC3987">RFC 3987</dfn></dt>
<dd><cite><a href="http://tools.ietf.org/html/rfc3987"
>Internationalized Resource Identifiers (IRIs)</a></cite>.
M. Duerst, M. Suignard.</dd>
<dd><span class="references-note" >(see in particular <a
href="http://tools.ietf.org/html/rfc3987#section-2.2"
>http://tools.ietf.org/html/rfc3987#section-2.2</a>)</span></dd>
- <dt><dfn id="refsRFC5322">RFC5322</dfn></dt>
+ <dt><dfn id="refsRFC5322">RFC 5322</dfn></dt>
<dd><cite><a href="http://tools.ietf.org/html/rfc5322" >Internet
Message Format</a></cite>. P. Resnick.</dd>
<dd><span class="references-note" >(see in particular <a
@@ -117,10 +116,11 @@
>XML Base</a></cite>.
Jonathan Marsh, Richard Tobin.
W3C Recommendation.</dd>
- <dt><dfn id="refsXMLNS">XMLNS</dfn></dt>
- <dd><cite><a href="http://www.w3.org/TR/xml-names/"
- >Namespaces in XML 1.0</a></cite>.
- Tim Bray, Dave Hollander, Andrew Layman, Richard Tobin.
+ <dt><dfn id="refsXMLEntities">XML Entities</dfn></dt>
+ <dd><cite><a
+ href="http://www.w3.org/TR/xml-entity-names/"
+ >XML Entity definitions for Characters</a></cite>.
+ David Carlisle, Patrick Ion.
W3C Recommendation.</dd>
</dl>
</section>
Index: syntax.html
===================================================================
RCS file: /sources/public/html5/markup/src/syntax.html,v
retrieving revision 1.86
retrieving revision 1.87
diff -u -d -r1.86 -r1.87
--- syntax.html 4 Aug 2010 12:59:18 -0000 1.86
+++ syntax.html 8 Aug 2010 09:49:20 -0000 1.87
@@ -8,10 +8,11 @@
and
<a href="#xml-syntax">the XML syntax</a>,
but it does not describe the XML syntax in detail (the XML
- syntax is instead defined by rules in the XML specification
+ syntax is instead defined by rules in the
<a href="#refsXML">[XML]</a>
- and in the Namespaces in XML 1.0 specification
- <a href="#refsXML">[XMLNS]</a>).</p>
+ specification and in the
+ <a href="#refsNamespacesInXML">[Namespaces in XML]</a>
+ specification).</p>
<p>This section is divided into the following parts:</p>
<div class="toc"/>
<section id="doctype-syntax">
@@ -208,8 +209,11 @@
<a href="#must-requirement">must</a>
be a valid character encoding name, and
<a href="#must-requirement">must</a>
- be the preferred name for that encoding.
- <a href="#refsIANACHARSET">[IANACHARSET]</a></li>
+ be the preferred name for that encoding,
+ as specified in
+ the IANA
+ <a href="#refsCharacterSets">[Character Sets]</a>
+ registry.</li>
<li>The character encoding declaration
<a href="#must-requirement">must</a>
be serialized
@@ -318,7 +322,7 @@
<dfn id="text-content" title="text-content">text content</dfn>
of an element is as defined in
<cite>Document Object Model (DOM) Level 3 Core</cite>
- <a href="#refsDOMCORE">[DOMCORE]</a>.</p>
+ <a href="#refsDOMCore">[DOM Core]</a>.</p>
<p>A
<dfn id="void-element" title="void-element">void element</dfn>
is an element whose
@@ -915,8 +919,7 @@
"<code title="U+0026 AMPERSAND">&</code>"
character.</li>
<li>One of the entity names defined in
- <cite>XML Entity definitions for Characters</cite>
- <a href="#refsEntities">[Entities]</a>,
+ <a href="#refsXMLEntities">[XML Entities]</a>,
using the same case.</li>
<li>A
"<code title="U+003B SEMICOLON">;</code>"
Index: intro-scope.html
===================================================================
RCS file: /sources/public/html5/markup/src/intro-scope.html,v
retrieving revision 1.13
retrieving revision 1.14
diff -u -d -r1.13 -r1.14
--- intro-scope.html 25 Jun 2010 05:32:27 -0000 1.13
+++ intro-scope.html 8 Aug 2010 09:49:20 -0000 1.14
@@ -20,13 +20,10 @@
</ul>
<p>The first two of the above design goals make this reference
similar in scope to the
- <a href="http://dev.w3.org/html5/spec-author-view/">HTML5 (Edition for Web Authors)</a>
- subset
- <a href="references.html#refsHTML5AUTHOR">[HTML5AUTHOR]</a>
- of the normative
- <a href="http://dev.w3.org/html5/spec/">HTML5: A vocabulary and associated APIs for HTML and XHTML</a>
- full specification
- <a href="references.html#refsHTML5">[HTML5]</a>.</p>
+ <a href="#refsHTML5ForWebAuthors">[HTML5 for Web Authors]</a>
+ subset of the normative
+ <a href="#refsHTML5">[HTML5]</a>
+ full specification.</p>
<p>Certain purposes are intentionally out of scope for this
reference document; specifically, it:</p>
<ul>
@@ -42,9 +39,8 @@
<p>For implementation conformance criteria for
<a href="#html-consumer">HTML consumers</a>
and detailed information on related APIs, instead see the
- <a href="http://dev.w3.org/html5/spec/">HTML5: A vocabulary and associated APIs for HTML and XHTML</a>
- full specification
- <a href="references.html#refsHTML5">[HTML5]</a>.</p>
+ <a href="references.html#refsHTML5">[HTML5]</a>
+ full specification.</p>
<p>Finally, because this document is intended for use strictly
as a reference, it does not attempt to also be a tutorial or
“how to” authoring guide.</p>
Received on Sunday, 8 August 2010 09:49:25 UTC