W3C home > Mailing lists > Public > public-html-commits@w3.org > August 2009

html5/spec Overview.html,1.2852,1.2853

From: Ian Hickson via cvs-syncmail <cvsmail@w3.org>
Date: Tue, 25 Aug 2009 23:45:05 +0000
To: public-html-commits@w3.org
Message-Id: <E1Mg5hJ-0003WG-C1@lionel-hutz.w3.org>
Update of /sources/public/html5/spec
In directory hutz:/tmp/cvs-serv13488

Modified Files:
	Overview.html 
Log Message:
Add extra restrictions on <a name>. (whatwg r3674)

Index: Overview.html
===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.2852
retrieving revision 1.2853
diff -u -d -r1.2852 -r1.2853
--- Overview.html	25 Aug 2009 21:57:40 -0000	1.2852
+++ Overview.html	25 Aug 2009 23:45:01 -0000	1.2853
@@ -4887,9 +4887,9 @@
    <dt><var title="">collection</var>[<var title="">name</var>]</dt>
    <dt><var title="">collection</var>(<var title="">name</var>)</dt>
    <dd>
-    <p>Returns the first item with ID or name <var title="">name</var>
+    <p>Returns the first item with <a href="#concept-id" title="concept-id">ID</a> or name <var title="">name</var>
     from the collection.</p>
-    <p>Returns null if no element with that ID or name could be found.</p>
+    <p>Returns null if no element with that <a href="#concept-id" title="concept-id">ID</a> or name could be found.</p>
     <p>Only <code><a href="#the-a-element">a</a></code>, <code><a href="#the-applet-element">applet</a></code>, <code><a href="#the-area-element">area</a></code>,
     <code><a href="#the-embed-element">embed</a></code>, <code><a href="#the-form-element">form</a></code>, <code><a href="#frame">frame</a></code>,
     <code><a href="#frameset">frameset</a></code>, <code><a href="#the-iframe-element">iframe</a></code>, <code><a href="#the-img-element">img</a></code>, and
@@ -4936,7 +4936,7 @@
    <code><a href="#the-img-element">img</a></code>, or <code><a href="#the-object-element">object</a></code> element with a <code title="">name</code> attribute equal to <var title="">key</var>,
    or,</li>
 
-   <li>It is an element with an ID <var title="">key</var>.</li>
+   <li>It is an element with an <a href="#concept-id" title="concept-id">ID</a> <var title="">key</var>.</li>
 
   </ul><p>If no such elements are found, then the method must return
   null.</p>
@@ -4977,9 +4977,9 @@
    <dt><var title="">collection</var>[<var title="">name</var>]</dt>
    <dt><var title="">collection</var>(<var title="">name</var>)</dt>
    <dd>
-    <p>Returns the item with ID or name <var title="">name</var> from the collection.</p>
+    <p>Returns the item with <a href="#concept-id" title="concept-id">ID</a> or name <var title="">name</var> from the collection.</p>
     <p>If there are multiple matching items, then an <code><a href="#htmlallcollection">HTMLAllCollection</a></code> object containing all those elements is returned.</p>
-    <p>Returns null if no element with that ID or name could be found.</p>
+    <p>Returns null if no element with that <a href="#concept-id" title="concept-id">ID</a> or name could be found.</p>
     <p>Only <code><a href="#the-a-element">a</a></code>, <code><a href="#the-applet-element">applet</a></code>, <code><a href="#the-area-element">area</a></code>,
     <code><a href="#the-embed-element">embed</a></code>, <code><a href="#the-form-element">form</a></code>, <code><a href="#frame">frame</a></code>,
     <code><a href="#frameset">frameset</a></code>, <code><a href="#the-iframe-element">iframe</a></code>, <code><a href="#the-img-element">img</a></code>, and
@@ -5035,7 +5035,7 @@
      <code><a href="#the-object-element">object</a></code> elements with a <code title="">name</code>
      attribute equal to <var title="">key</var>, or,</li>
 
-     <li>elements with an ID <var title="">key</var>.</li>
+     <li>elements with an <a href="#concept-id" title="concept-id">ID</a> <var title="">key</var>.</li>
 
     </ul></li>
 
@@ -5086,9 +5086,9 @@
    <dt><var title="">collection</var>[<var title="">name</var>]</dt>
    <dt><var title="">collection</var>(<var title="">name</var>)</dt>
    <dd>
-    <p>Returns the item with ID or <code title="attr-fe-name"><a href="#attr-fe-name">name</a></code> <var title="">name</var> from the collection.</p>
+    <p>Returns the item with <a href="#concept-id" title="concept-id">ID</a> or <code title="attr-fe-name"><a href="#attr-fe-name">name</a></code> <var title="">name</var> from the collection.</p>
     <p>If there are multiple matching items, then a <code><a href="#radionodelist">RadioNodeList</a></code> object containing all those elements is returned.</p>
-    <p>Returns null if no element with that ID or <code title="attr-fe-name"><a href="#attr-fe-name">name</a></code> could be found.</p>
+    <p>Returns null if no element with that <a href="#concept-id" title="concept-id">ID</a> or <code title="attr-fe-name"><a href="#attr-fe-name">name</a></code> could be found.</p>
    </dd>
 
    <dt><var title="">radioNodeList</var> . <var title="">value</var> [ = <var title="">value</var> ]</dt>
@@ -5212,9 +5212,9 @@
    <dt><var title="">collection</var>[<var title="">name</var>]</dt>
    <dt><var title="">collection</var>(<var title="">name</var>)</dt>
    <dd>
-    <p>Returns the item with ID or <code title="attr-option-name">name</code> <var title="">name</var> from the collection.</p>
+    <p>Returns the item with <a href="#concept-id" title="concept-id">ID</a> or <code title="attr-option-name">name</code> <var title="">name</var> from the collection.</p>
     <p>If there are multiple matching items, then a <code>NodeList</code> object containing all those elements is returned.</p>
-    <p>Returns null if no element with that ID could be found.</p>
+    <p>Returns null if no element with that <a href="#concept-id" title="concept-id">ID</a> could be found.</p>
    </dd>
 
    <dt><var title="">collection</var> . <code title="dom-HTMLOptionsCollection-add"><a href="#dom-htmloptionscollection-add">add</a></code>(<var title="">element</var> [, <var title="">before</var> ] )</dt>
@@ -6933,14 +6933,16 @@
   fine-grained interface than is otherwise possible with HTML elements
   and attributes, a set of <a href="#annotations-for-assistive-technology-products">annotations for assistive technology
   products</a> can be specified.<h5 id="the-id-attribute"><span class="secno">3.2.3.1 </span>The <dfn title="attr-id"><code>id</code></dfn> attribute</h5><p class="XXX annotation"><b>Status: </b><i>Implemented and widely deployed</i><p>The <code title="attr-id"><a href="#the-id-attribute">id</a></code> attribute
-  <a href="#represents">represents</a> its element's unique identifier. The value
-  must be unique in the element's <a href="#home-subtree">home subtree</a> and must
-  contain at least one character. The value must not contain any <a href="#space-character" title="space character">space characters</a>.</p><!-- space characters are disallowed because space-separated lists
-  of IDs otherwise would not be able to reach all valid IDs --><p class="note">An element's unique identifier can be used for a
-  variety of purposes, most notably as a way to link to specific parts
-  of a document using fragment identifiers, as a way to target an
-  element when scripting, and as a way to style a specific element
-  from CSS.<div class="impl">
+  <a href="#represents">represents</a> its element's <dfn id="concept-id" title="concept-id">unique
+  identifier (ID)</dfn>. The value must be unique amongst all the IDs
+  in the element's <a href="#home-subtree">home subtree</a> and must contain at least
+  one character. The value must not contain any <a href="#space-character" title="space
+  character">space characters</a>.</p><!-- space characters are disallowed because space-separated lists
+  of IDs otherwise would not be able to reach all valid IDs --><p class="note">An element's <a href="#concept-id" title="concept-id">unique
+  identifier</a> can be used for a variety of purposes, most
+  notably as a way to link to specific parts of a document using
+  fragment identifiers, as a way to target an element when scripting,
+  and as a way to style a specific element from CSS.<div class="impl">
 
   <p>If the value is not the empty string, user agents must associate
   the element with the given value (exactly, including any space
@@ -7906,7 +7908,7 @@
    <p>To avoid this confusion, explicit <code><a href="#the-p-element">p</a></code> elements can be
    used.</p>
 
-  </div><h4 id="annotations-for-assistive-technology-products"><span class="secno">3.2.6 </span><dfn>Annotations for assistive technology products</dfn></h4><p class="XXX annotation"><b>Status: </b><i>First draft. </i><span><a href="http://www.w3.org/html/wg/tracker/issues/35">ISSUE-35</a> (aria-processing) and <a href="http://www.w3.org/html/wg/tracker/issues/14">ISSUE-14</a> (aria-role) block progress to Last Call</span><p>Authors may use the ARIA <code title="attr-aria-role">role</code>
+  </div><h4 id="annotations-for-assistive-technology-products"><span class="secno">3.2.6 </span><dfn>Annotations for assistive technology products</dfn></h4><p class="XXX annotation"><b>Status: </b><i>First draft. </i><span><a href="http://www.w3.org/html/wg/tracker/issues/14">ISSUE-14</a> (aria-role) and <a href="http://www.w3.org/html/wg/tracker/issues/35">ISSUE-35</a> (aria-processing) block progress to Last Call</span><p>Authors may use the ARIA <code title="attr-aria-role">role</code>
   and <code title="attr-aria-*">aria-*</code> attributes on <a href="#html-elements">HTML
   elements</a>, in accordance with the requirements described in
   the ARIA specifications, except where these conflict with the
@@ -17580,7 +17582,7 @@
   <a href="#reflect">reflect</a> the respective content attributes of the same
   name.</p>
 
-  </div><h4 id="video"><span class="secno">4.8.7 </span>The <dfn><code>video</code></dfn> element</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments. </i><span><a href="http://www.w3.org/html/wg/tracker/issues/7">ISSUE-7</a> (video-codecs), <a href="http://www.w3.org/html/wg/tracker/issues/9">ISSUE-9</a> (video-synchronization) and <a href="http://www.w3.org/html/wg/tracker/issues/10">ISSUE-10</a> (video-smil) block progress to Last Call</span><dl class="element"><dt>Categories</dt>
+  </div><h4 id="video"><span class="secno">4.8.7 </span>The <dfn><code>video</code></dfn> element</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments. </i><span><a href="http://www.w3.org/html/wg/tracker/issues/10">ISSUE-10</a> (video-smil), <a href="http://www.w3.org/html/wg/tracker/issues/7">ISSUE-7</a> (video-codecs) and <a href="http://www.w3.org/html/wg/tracker/issues/9">ISSUE-9</a> (video-synchronization) block progress to Last Call</span><dl class="element"><dt>Categories</dt>
    <dd><a href="#flow-content">Flow content</a>.</dd>
    <dd><a href="#phrasing-content">Phrasing content</a>.</dd>
    <dd><a href="#embedded-content">Embedded content</a>.</dd>
@@ -65387,10 +65389,11 @@
   should be entirely omitted instead (with the value "<code title="">JavaScript</code>", it has no effect), or replaced with use
   of the <code title="attr-script-type"><a href="#attr-script-type">type</a></code> attribute.<p>Authors should not specify the <code title="attr-a-name"><a href="#attr-a-name">name</a></code> attribute on <code><a href="#the-a-element">a</a></code>
   elements. If the attribute is present, its value must not be the
-  empty string. In earlier versions of the language, this attribute
-  served a similar role as the <code title="attr-id"><a href="#the-id-attribute">id</a></code>
-  attribute. The <code title="attr-id"><a href="#the-id-attribute">id</a></code> attribute should be
-  used instead.<p class="note">The <code title="attr-table-summary"><a href="#attr-table-summary">summary</a></code>
+  empty string and must not be equal to the value of any of the <a href="#concept-id" title="concept-id">IDs</a> in the element's <a href="#home-subtree">home
+  subtree</a> other than the element's own <a href="#concept-id" title="concept-id">ID</a>, if any. If this attribute is present
+  and the element has an <a href="#concept-id" title="concept-id">ID</a>, then the
+  attribute's value must be equal to the element's <a href="#concept-id" title="concept-id">ID</a>. In earlier versions of the language,
+  this attribute served a similar role as the <code title="attr-id"><a href="#the-id-attribute">id</a></code> attribute. The <code title="attr-id"><a href="#the-id-attribute">id</a></code> attribute should be used instead.<p class="note">The <code title="attr-table-summary"><a href="#attr-table-summary">summary</a></code>
   attribute, defined in the <code><a href="#the-table-element">table</a></code> section, will also
   trigger a warning.<div class="impl">
 
@@ -68045,6 +68048,7 @@
   Robin Berjon,
   Roland Steiner,
   Roman Ivanov,
+  Roy Fielding,
   Ryan King,
   S. Mike Dierken,
   Sam Dutton,
Received on Tuesday, 25 August 2009 23:45:16 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Tuesday, 25 August 2009 23:45:17 GMT