- 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