- From: Ian Hickson via cvs-syncmail <cvsmail@w3.org>
- Date: Wed, 17 Mar 2010 23:50:40 +0000
- To: public-html-commits@w3.org
Update of /sources/public/html5/spec
In directory hutz:/tmp/cvs-serv5542
Modified Files:
Overview.html
Log Message:
Fix meaning of 'live' throughout. Hide a Window object that had leaked out instead of turning into a WindowProxy object. Fix a note that had rotted. (whatwg r4857)
Index: Overview.html
===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.3891
retrieving revision 1.3892
diff -u -d -r1.3891 -r1.3892
--- Overview.html 17 Mar 2010 23:24:03 -0000 1.3891
+++ Overview.html 17 Mar 2010 23:50:36 -0000 1.3892
@@ -1727,11 +1727,10 @@
<code>Foo</code>".<p>An IDL attribute is said to be <dfn title="">getting</dfn> when
its value is being retrieved (e.g. by author script), and is said to
be <dfn title="">setting</dfn> when a new value is assigned to
- it.<p>If a DOM object is said to be <dfn id="live">live</dfn>, then that means
- that any attributes returning that object <span class="impl">must</span> always return the same object (not a new
- object each time), and the attributes and methods on that object
- <span class="impl">must</span> operate on the actual underlying
- data, not a snapshot of the data.<p>The terms <dfn title="">fire</dfn> and <dfn title="">dispatch</dfn> are used interchangeably in the context of
+ it.<p>If a DOM object is said to be <dfn id="live">live</dfn>, then the
+ attributes and methods on that object <span class="impl">must</span>
+ operate on the actual underlying data, not a snapshot of the
+ data.<p>The terms <dfn title="">fire</dfn> and <dfn title="">dispatch</dfn> are used interchangeably in the context of
events, as in the DOM Events specifications. The term <dfn id="concept-events-trusted" title="concept-events-trusted">trusted event</dfn> is used as
defined by the DOM Events specification. <!--
http://krijnhoetmer.nl/irc-logs/webapps/20091218 --> <a href="#refsDOMEVENTS">[DOMEVENTS]</a><h4 id="plugins"><span class="secno">2.1.5 </span>Plugins</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><p>The term <dfn id="plugin">plugin</dfn> is used to mean any content handler
@@ -5192,8 +5191,8 @@
<li>Otherwise, if there are no nodes in the collection that have
either an <code title="attr-id"><a href="#the-id-attribute">id</a></code> attribute or a <code title="attr-fe-name"><a href="#attr-fe-name">name</a></code> attribute equal to <var title="">name</var>, then return null and stop the algorithm.</li>
- <li>Otherwise, create a <code><a href="#radionodelist">RadioNodeList</a></code> object
- representing a live view of the
+ <li>Otherwise, create a new <code><a href="#radionodelist">RadioNodeList</a></code> object
+ representing a <a href="#live">live</a> view of the
<code><a href="#htmlformcontrolscollection">HTMLFormControlsCollection</a></code> object, further filtered so
that the only nodes in the <code><a href="#radionodelist">RadioNodeList</a></code> object are
those that have either an <code title="attr-id"><a href="#the-id-attribute">id</a></code> attribute
@@ -5338,14 +5337,12 @@
either an <code title="attr-id"><a href="#the-id-attribute">id</a></code> attribute or a <code title="attr-option-name">name</code> attribute equal to <var title="">name</var>, then return null and stop the algorithm.</li>
<!-- IE returns an HTMLCollection instead; we may need to change to that for compat -->
- <li>Otherwise, create a <code><a href="#nodelist">NodeList</a></code> object representing a
- live view of the <code><a href="#htmloptionscollection">HTMLOptionsCollection</a></code> object, further
- filtered so that the only nodes in the <code><a href="#nodelist">NodeList</a></code> object
- are those that have either an <code title="attr-id"><a href="#the-id-attribute">id</a></code>
- attribute or a <code title="attr-option-name">name</code> attribute
- equal to <var title="">name</var>. The nodes in the
- <code><a href="#nodelist">NodeList</a></code> object must be sorted in <a href="#tree-order">tree
- order</a>.</li>
+ <li>Otherwise, create a new <code><a href="#nodelist">NodeList</a></code> object
+ representing a <a href="#live">live</a> view of the
+ <code><a href="#htmloptionscollection">HTMLOptionsCollection</a></code> object, further filtered so that
+ the only nodes in the <code><a href="#nodelist">NodeList</a></code> object are those that
+ have either an <code title="attr-id"><a href="#the-id-attribute">id</a></code> attribute or a <code title="attr-option-name">name</code> attribute equal to <var title="">name</var>. The nodes in the <code><a href="#nodelist">NodeList</a></code> object
+ must be sorted in <a href="#tree-order">tree order</a>.</li>
<li>Return that <code><a href="#nodelist">NodeList</a></code> object.</li>
@@ -6450,19 +6447,19 @@
</dl><div class="impl">
- <p>The <dfn id="dom-document-getelementsbyname" title="dom-document-getElementsByName"><code>getElementsByName(<var title="">name</var>)</code></dfn> method takes a string <var title="">name</var>, and must return a live <code><a href="#nodelist">NodeList</a></code>
- containing all the <a href="#html-elements">HTML elements</a> in that document that
- have a <code title="">name</code> attribute whose value is equal to
- the <var title="">name</var> argument (in a
- <a href="#case-sensitive">case-sensitive</a> manner), in <a href="#tree-order">tree order</a>. A
- new <code><a href="#nodelist">NodeList</a></code> object must be returned each time unless
- the argument is the same as the last time the method was invoked on
- this <code><a href="#document">Document</a></code> object, in which case the object must be
- the same as the object returned by the previous call.</p>
+ <p>The <dfn id="dom-document-getelementsbyname" title="dom-document-getElementsByName"><code>getElementsByName(<var title="">name</var>)</code></dfn> method takes a string <var title="">name</var>, and must return a <a href="#live">live</a>
+ <code><a href="#nodelist">NodeList</a></code> containing all the <a href="#html-elements">HTML elements</a>
+ in that document that have a <code title="">name</code> attribute
+ whose value is equal to the <var title="">name</var> argument (in a
+ <a href="#case-sensitive">case-sensitive</a> manner), in <a href="#tree-order">tree order</a>.
+ When the method is invoked on a <code><a href="#document">Document</a></code> object again
+ with the same argument, the user agent may return the same as the
+ object returned by the earlier call. In other cases, a new
+ <code><a href="#nodelist">NodeList</a></code> object must be returned.</p>
<p>The <dfn id="dom-document-getelementsbyclassname" title="dom-document-getElementsByClassName"><code>getElementsByClassName(<var title="">classNames</var>)</code></dfn> method takes a string that
contains a <a href="#set-of-space-separated-tokens">set of space-separated tokens</a> representing
- classes. When called, the method must return a live
+ classes. When called, the method must return a <a href="#live">live</a>
<code><a href="#nodelist">NodeList</a></code> object containing all the elements in the
document, in <a href="#tree-order">tree order</a>, that have all the classes
specified in that argument, having obtained the classes by <a href="#split-a-string-on-spaces" title="split a string on spaces">splitting a string on
@@ -6478,7 +6475,7 @@
<code><a href="#nodelist">NodeList</a></code> object must be returned.</p>
<p>The <dfn id="dom-getelementsbyclassname" title="dom-getElementsByClassName"><code>getElementsByClassName(<var title="">classNames</var>)</code></dfn> method on the
- <code><a href="#htmlelement">HTMLElement</a></code> interface must return a live
+ <code><a href="#htmlelement">HTMLElement</a></code> interface must return a <a href="#live">live</a>
<code><a href="#nodelist">NodeList</a></code> with the nodes that the
<code><a href="#htmldocument">HTMLDocument</a></code> <code title="dom-document-getElementsByClassName"><a href="#dom-document-getelementsbyclassname">getElementsByClassName()</a></code>
method would return when passed the same argument(s), excluding any
@@ -22245,7 +22242,7 @@
for an <code><a href="#the-area-element">area</a></code> element to correspond to multiple focusable
areas of the document.</p>
- <p>Image maps are <em>live</em>; if the DOM is mutated, then the
+ <p>Image maps are <a href="#live">live</a>; if the DOM is mutated, then the
user agent must act as if it had rerun the algorithms for image
maps.</p>
@@ -32757,9 +32754,8 @@
<p>The <dfn id="dom-cva-validity" title="dom-cva-validity"><code>validity</code></dfn>
attribute must return a <code><a href="#validitystate">ValidityState</a></code> object that
represents the <a href="#validity-states">validity states</a> of the element. This
- object is live, and the same object must be returned each time the
- element's <code title="dom-cva-validity"><a href="#dom-cva-validity">validity</a></code> attribute
- is retrieved.</p>
+ object is <a href="#live">live</a>, and the same object must be returned
+ each time the element's <code title="dom-cva-validity"><a href="#dom-cva-validity">validity</a></code> attribute is retrieved.</p>
<pre class="idl">interface <dfn id="validitystate">ValidityState</dfn> {
readonly attribute boolean <a href="#dom-validitystate-valuemissing" title="dom-ValidityState-valueMissing">valueMissing</a>;
@@ -36971,8 +36967,8 @@
attribute must return a list containing the elements that can
trigger the command (the command's <span
title="command-facet-Triggers">Triggers</span>). The list must be
- <span>live</span>. While the element does not define a command, the
- list must be empty.</p>
+ <span>live</span>. The same object must be returned each time. While
+ the element does not define a command, the list must be empty.</p>
-->
<p class="note">The <a href="#command-facet-id" title="command-facet-ID">ID</a> facet
@@ -48720,8 +48716,8 @@
the last of those values that it was set to.</p>
<p>The <dfn id="dom-datatransfer-types" title="dom-DataTransfer-types"><code>types</code></dfn>
- attribute must return a live <code>DOMStringList</code> that
- contains the list of formats that were added to the
+ attribute must return a <a href="#live">live</a> <code>DOMStringList</code>
+ that contains the list of formats that were added to the
<code><a href="#datatransfer">DataTransfer</a></code> object in the corresponding <code title="event-dragstart"><a href="#event-dragstart">dragstart</a></code> event. The same object must
be returned each time. If any files were included in the drag, then
the <code>DOMStringList</code> object must in addition include the
Received on Wednesday, 17 March 2010 23:50:42 UTC