[html5] r4857 - [e] (0) Fix meaning of 'live' throughout. Hide a Window object that had leaked o [...]

whatwg at whatwg.org whatwg at whatwg.org
Wed Mar 17 16:50:33 PDT 2010


Author: ianh
Date: 2010-03-17 16:50:31 -0700 (Wed, 17 Mar 2010)
New Revision: 4857

Modified:
   complete.html
   index
   source
Log:
[e] (0) 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.

Modified: complete.html
===================================================================
--- complete.html	2010-03-17 23:23:57 UTC (rev 4856)
+++ complete.html	2010-03-17 23:50:31 UTC (rev 4857)
@@ -2107,11 +2107,10 @@
   be <dfn title="">setting</dfn> when a new value is assigned to
   it.</p>
 
-  <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>
+  <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>
 
   <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
@@ -5974,8 +5973,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
@@ -6129,14 +6128,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>
 
@@ -6249,22 +6246,20 @@
   <a href=#represented-by-the-collection>represented by the collection</a>.</p>
 
   <p>The <dfn id=dom-htmlpropertiescollection-names title=dom-HTMLPropertiesCollection-names><code>names</code></dfn>
-  attribute must return a live <code>DOMStringList</code> object
-  giving the <a href=#property-names>property names</a> of all the elements
+  attribute must return a <a href=#live>live</a> <code>DOMStringList</code>
+  object giving the <a href=#property-names>property names</a> of all the elements
   <a href=#represented-by-the-collection>represented by the collection</a>, listed in <a href=#tree-order>tree
   order</a>, but with duplicates removed, leaving only the first
   occurrence of each name. The same object must be returned each
   time.</p>
 
   <p>The <dfn id=dom-htmlpropertiescollection-nameditem title=dom-HTMLPropertiesCollection-namedItem><code>namedItem(<var title="">name</var>)</code></dfn> method must return a
-  <code><a href=#propertynodelist>PropertyNodeList</a></code> object representing a live view of the
-  <code><a href=#htmlpropertiescollection>HTMLPropertiesCollection</a></code> object, further filtered so that
-  the only nodes in the <code><a href=#propertynodelist>PropertyNodeList</a></code> object are those
-  that have a <a href=#property-names title="property names">property name</a> equal
-  to <var title="">name</var>. The nodes in the
-  <code><a href=#propertynodelist>PropertyNodeList</a></code> object must be sorted in <a href=#tree-order>tree
-  order</a>, and the same object must be returned each time a
-  particular <var title="">name</var> is queried.</p>
+  <code><a href=#propertynodelist>PropertyNodeList</a></code> object representing a
+  <a href=#live>live</a> view of the <code><a href=#htmlpropertiescollection>HTMLPropertiesCollection</a></code>
+  object, further filtered so that the only nodes in the
+  <code><a href=#propertynodelist>PropertyNodeList</a></code> object are those that have a <a href=#property-names title="property names">property name</a> equal to <var title="">name</var>. The nodes in the <code><a href=#propertynodelist>PropertyNodeList</a></code>
+  object must be sorted in <a href=#tree-order>tree order</a>, and the same
+  object must be returned each time a particular <var title="">name</var> is queried.</p>
 
   <hr><p>Members of the <code><a href=#propertynodelist>PropertyNodeList</a></code> interface inherited
   from the <code><a href=#nodelist>NodeList</a></code> interface must behave as they would
@@ -7476,19 +7471,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
@@ -7504,7 +7499,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
@@ -25603,9 +25598,9 @@
   value.</p>
 
   <p>When set to a <code><a href=#canvaspattern>CanvasPattern</a></code> or
-  <code><a href=#canvasgradient>CanvasGradient</a></code> object, the assignment is live, meaning
-  that changes made to the object after the assignment do affect
-  subsequent stroking or filling of shapes.</p>
+  <code><a href=#canvasgradient>CanvasGradient</a></code> object, the assignment is
+  <a href=#live>live</a>, meaning that changes made to the object after the
+  assignment do affect subsequent stroking or filling of shapes.</p>
 
   <p>On getting, if the value is a color, then the <a href=#serialization-of-a-color title="serialization of a color">serialization of the color</a>
   must be returned. Otherwise, if it is not a color but a
@@ -28501,7 +28496,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>
 
@@ -40446,9 +40441,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>;
@@ -44849,8 +44843,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
@@ -48396,15 +48390,15 @@
   <p>The <dfn id=dom-document-getitems title=dom-document-getItems><code>document.getItems(<var title="">typeNames</var>)</code></dfn> method takes an optional
   string that contains an <a href=#unordered-set-of-unique-space-separated-tokens>unordered set of unique
   space-separated tokens</a> representing types. When called, the
-  method must return a live <code><a href=#nodelist>NodeList</a></code> object containing
-  all the elements in the document, in <a href=#tree-order>tree order</a>, that
-  are each <a href=#top-level-microdata-items>top-level microdata items</a> with a <a href=#item-type title="item type">type</a> equal to one of the types specified in
-  that argument, having obtained the types by <a href=#split-a-string-on-spaces title="split a
-  string on spaces">splitting the string on spaces</a>. If there
-  are no tokens specified in the argument, or if the argument is
-  missing, then the method must return a <code><a href=#nodelist>NodeList</a></code>
-  containing all the <a href=#top-level-microdata-items>top-level microdata items</a> in the
-  document.
+  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 are each <a href=#top-level-microdata-items>top-level microdata items</a>
+  with a <a href=#item-type title="item type">type</a> equal to one of the types
+  specified in that argument, having obtained the types by <a href=#split-a-string-on-spaces title="split a string on spaces">splitting the string on
+  spaces</a>. If there are no tokens specified in the argument, or
+  if the argument is missing, then the method must return a
+  <code><a href=#nodelist>NodeList</a></code> containing all the <a href=#top-level-microdata-items>top-level microdata
+  items</a> in the document.
   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 object as
   the object returned by the earlier call. In other cases, a new
@@ -62436,8 +62430,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
@@ -70303,9 +70297,9 @@
     set to the <a href=#unicode-serialization-of-an-origin title="Unicode serialization of an
     origin">Unicode serialization</a> of the <a href=#origin>origin</a> of
     the script that invoked the method, and the <code title=dom-MessageEvent-source><a href=#dom-messageevent-source>source</a></code> attribute must be
-    set to the <a href="#script's-global-object">script's global object</a>.</p> <!--
-    invariant: the global object is always a Window if the script can
-    see this method -->
+    set to the <a href="#script's-global-object">script's global object</a>'s
+    <code><a href=#windowproxy>WindowProxy</a></code> object.</p> <!-- invariant: the global
+    object is always a Window if the script can see this method -->
 
    </li>
 
@@ -70419,9 +70413,9 @@
     set to the <a href=#unicode-serialization-of-an-origin title="Unicode serialization of an
     origin">Unicode serialization</a> of the <a href=#origin>origin</a> of
     the script that invoked the method, and the <code title=dom-MessageEvent-source><a href=#dom-messageevent-source>source</a></code> attribute must be
-    set to the <a href="#script's-global-object">script's global object</a>.</p> <!--
-    invariant: the global object is always a Window if the script can
-    see this method -->
+    set to the <a href="#script's-global-object">script's global object</a>'s
+    <code><a href=#windowproxy>WindowProxy</a></code> object.</p> <!-- invariant: the global
+    object is always a Window if the script can see this method -->
 
    </li>
 
@@ -70441,9 +70435,9 @@
 
    </li>
 
-  </ol><p class=note>These steps, with the exception of the second and
-  third steps and the penultimate step, are identical to those in the
-  previous section.</p>
+  </ol><p class=note>These steps, with the exception of the third,
+  fourth, and fifth steps and the penultimate step, are identical to
+  those in the previous section.</p>
 
   <!-- v2: we can merge this section and the previous section when
   implementations have shipped postMessage(). Anne asked that these

Modified: index
===================================================================
--- index	2010-03-17 23:23:57 UTC (rev 4856)
+++ index	2010-03-17 23:50:31 UTC (rev 4857)
@@ -2006,11 +2006,10 @@
   be <dfn title="">setting</dfn> when a new value is assigned to
   it.</p>
 
-  <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>
+  <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>
 
   <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
@@ -5873,8 +5872,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
@@ -6028,14 +6027,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>
 
@@ -6148,22 +6145,20 @@
   <a href=#represented-by-the-collection>represented by the collection</a>.</p>
 
   <p>The <dfn id=dom-htmlpropertiescollection-names title=dom-HTMLPropertiesCollection-names><code>names</code></dfn>
-  attribute must return a live <code>DOMStringList</code> object
-  giving the <a href=#property-names>property names</a> of all the elements
+  attribute must return a <a href=#live>live</a> <code>DOMStringList</code>
+  object giving the <a href=#property-names>property names</a> of all the elements
   <a href=#represented-by-the-collection>represented by the collection</a>, listed in <a href=#tree-order>tree
   order</a>, but with duplicates removed, leaving only the first
   occurrence of each name. The same object must be returned each
   time.</p>
 
   <p>The <dfn id=dom-htmlpropertiescollection-nameditem title=dom-HTMLPropertiesCollection-namedItem><code>namedItem(<var title="">name</var>)</code></dfn> method must return a
-  <code><a href=#propertynodelist>PropertyNodeList</a></code> object representing a live view of the
-  <code><a href=#htmlpropertiescollection>HTMLPropertiesCollection</a></code> object, further filtered so that
-  the only nodes in the <code><a href=#propertynodelist>PropertyNodeList</a></code> object are those
-  that have a <a href=#property-names title="property names">property name</a> equal
-  to <var title="">name</var>. The nodes in the
-  <code><a href=#propertynodelist>PropertyNodeList</a></code> object must be sorted in <a href=#tree-order>tree
-  order</a>, and the same object must be returned each time a
-  particular <var title="">name</var> is queried.</p>
+  <code><a href=#propertynodelist>PropertyNodeList</a></code> object representing a
+  <a href=#live>live</a> view of the <code><a href=#htmlpropertiescollection>HTMLPropertiesCollection</a></code>
+  object, further filtered so that the only nodes in the
+  <code><a href=#propertynodelist>PropertyNodeList</a></code> object are those that have a <a href=#property-names title="property names">property name</a> equal to <var title="">name</var>. The nodes in the <code><a href=#propertynodelist>PropertyNodeList</a></code>
+  object must be sorted in <a href=#tree-order>tree order</a>, and the same
+  object must be returned each time a particular <var title="">name</var> is queried.</p>
 
   <hr><p>Members of the <code><a href=#propertynodelist>PropertyNodeList</a></code> interface inherited
   from the <code><a href=#nodelist>NodeList</a></code> interface must behave as they would
@@ -7375,19 +7370,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
@@ -7403,7 +7398,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
@@ -25505,9 +25500,9 @@
   value.</p>
 
   <p>When set to a <code><a href=#canvaspattern>CanvasPattern</a></code> or
-  <code><a href=#canvasgradient>CanvasGradient</a></code> object, the assignment is live, meaning
-  that changes made to the object after the assignment do affect
-  subsequent stroking or filling of shapes.</p>
+  <code><a href=#canvasgradient>CanvasGradient</a></code> object, the assignment is
+  <a href=#live>live</a>, meaning that changes made to the object after the
+  assignment do affect subsequent stroking or filling of shapes.</p>
 
   <p>On getting, if the value is a color, then the <a href=#serialization-of-a-color title="serialization of a color">serialization of the color</a>
   must be returned. Otherwise, if it is not a color but a
@@ -28403,7 +28398,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>
 
@@ -40348,9 +40343,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>;
@@ -44751,8 +44745,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
@@ -48298,15 +48292,15 @@
   <p>The <dfn id=dom-document-getitems title=dom-document-getItems><code>document.getItems(<var title="">typeNames</var>)</code></dfn> method takes an optional
   string that contains an <a href=#unordered-set-of-unique-space-separated-tokens>unordered set of unique
   space-separated tokens</a> representing types. When called, the
-  method must return a live <code><a href=#nodelist>NodeList</a></code> object containing
-  all the elements in the document, in <a href=#tree-order>tree order</a>, that
-  are each <a href=#top-level-microdata-items>top-level microdata items</a> with a <a href=#item-type title="item type">type</a> equal to one of the types specified in
-  that argument, having obtained the types by <a href=#split-a-string-on-spaces title="split a
-  string on spaces">splitting the string on spaces</a>. If there
-  are no tokens specified in the argument, or if the argument is
-  missing, then the method must return a <code><a href=#nodelist>NodeList</a></code>
-  containing all the <a href=#top-level-microdata-items>top-level microdata items</a> in the
-  document.
+  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 are each <a href=#top-level-microdata-items>top-level microdata items</a>
+  with a <a href=#item-type title="item type">type</a> equal to one of the types
+  specified in that argument, having obtained the types by <a href=#split-a-string-on-spaces title="split a string on spaces">splitting the string on
+  spaces</a>. If there are no tokens specified in the argument, or
+  if the argument is missing, then the method must return a
+  <code><a href=#nodelist>NodeList</a></code> containing all the <a href=#top-level-microdata-items>top-level microdata
+  items</a> in the document.
   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 object as
   the object returned by the earlier call. In other cases, a new
@@ -62364,8 +62358,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
@@ -64410,9 +64404,9 @@
     set to the <a href=#unicode-serialization-of-an-origin title="Unicode serialization of an
     origin">Unicode serialization</a> of the <a href=#origin>origin</a> of
     the script that invoked the method, and the <code title=dom-MessageEvent-source><a href=#dom-messageevent-source>source</a></code> attribute must be
-    set to the <a href="#script's-global-object">script's global object</a>.</p> <!--
-    invariant: the global object is always a Window if the script can
-    see this method -->
+    set to the <a href="#script's-global-object">script's global object</a>'s
+    <code><a href=#windowproxy>WindowProxy</a></code> object.</p> <!-- invariant: the global
+    object is always a Window if the script can see this method -->
 
    </li>
 
@@ -64526,9 +64520,9 @@
     set to the <a href=#unicode-serialization-of-an-origin title="Unicode serialization of an
     origin">Unicode serialization</a> of the <a href=#origin>origin</a> of
     the script that invoked the method, and the <code title=dom-MessageEvent-source><a href=#dom-messageevent-source>source</a></code> attribute must be
-    set to the <a href="#script's-global-object">script's global object</a>.</p> <!--
-    invariant: the global object is always a Window if the script can
-    see this method -->
+    set to the <a href="#script's-global-object">script's global object</a>'s
+    <code><a href=#windowproxy>WindowProxy</a></code> object.</p> <!-- invariant: the global
+    object is always a Window if the script can see this method -->
 
    </li>
 
@@ -64548,9 +64542,9 @@
 
    </li>
 
-  </ol><p class=note>These steps, with the exception of the second and
-  third steps and the penultimate step, are identical to those in the
-  previous section.</p>
+  </ol><p class=note>These steps, with the exception of the third,
+  fourth, and fifth steps and the penultimate step, are identical to
+  those in the previous section.</p>
 
   <!-- v2: we can merge this section and the previous section when
   implementations have shipped postMessage(). Anne asked that these

Modified: source
===================================================================
--- source	2010-03-17 23:23:57 UTC (rev 4856)
+++ source	2010-03-17 23:50:31 UTC (rev 4857)
@@ -979,12 +979,10 @@
   be <dfn title="">setting</dfn> when a new value is assigned to
   it.</p>
 
-  <p>If a DOM object is said to be <dfn>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>
+  <p>If a DOM object is said to be <dfn>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>
 
   <p>The terms <dfn title="">fire</dfn> and <dfn
   title="">dispatch</dfn> are used interchangeably in the context of
@@ -5584,8 +5582,8 @@
    title="attr-fe-name">name</code> attribute equal to <var
    title="">name</var>, then return null and stop the algorithm.</li>
 
-   <li>Otherwise, create a <code>RadioNodeList</code> object
-   representing a live view of the
+   <li>Otherwise, create a new <code>RadioNodeList</code> object
+   representing a <span>live</span> view of the
    <code>HTMLFormControlsCollection</code> object, further filtered so
    that the only nodes in the <code>RadioNodeList</code> object are
    those that have either an <code title="attr-id">id</code> attribute
@@ -5773,14 +5771,14 @@
    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>NodeList</code> object representing a
-   live view of the <code>HTMLOptionsCollection</code> object, further
-   filtered so that the only nodes in the <code>NodeList</code> object
-   are those that have either an <code title="attr-id">id</code>
-   attribute or a <code title="attr-option-name">name</code> attribute
-   equal to <var title="">name</var>. The nodes in the
-   <code>NodeList</code> object must be sorted in <span>tree
-   order</span>.</li>
+   <li>Otherwise, create a new <code>NodeList</code> object
+   representing a <span>live</span> view of the
+   <code>HTMLOptionsCollection</code> object, further filtered so that
+   the only nodes in the <code>NodeList</code> object are those that
+   have either an <code title="attr-id">id</code> attribute or a <code
+   title="attr-option-name">name</code> attribute equal to <var
+   title="">name</var>. The nodes in the <code>NodeList</code> object
+   must be sorted in <span>tree order</span>.</li>
 
    <li>Return that <code>NodeList</code> object.</li>
 
@@ -5926,8 +5924,8 @@
 
   <p>The <dfn
   title="dom-HTMLPropertiesCollection-names"><code>names</code></dfn>
-  attribute must return a live <code>DOMStringList</code> object
-  giving the <span>property names</span> of all the elements
+  attribute must return a <span>live</span> <code>DOMStringList</code>
+  object giving the <span>property names</span> of all the elements
   <span>represented by the collection</span>, listed in <span>tree
   order</span>, but with duplicates removed, leaving only the first
   occurrence of each name. The same object must be returned each
@@ -5936,14 +5934,15 @@
   <p>The <dfn
   title="dom-HTMLPropertiesCollection-namedItem"><code>namedItem(<var
   title="">name</var>)</code></dfn> method must return a
-  <code>PropertyNodeList</code> object representing a live view of the
-  <code>HTMLPropertiesCollection</code> object, further filtered so that
-  the only nodes in the <code>PropertyNodeList</code> object are those
-  that have a <span title="property names">property name</span> equal
-  to <var title="">name</var>. The nodes in the
-  <code>PropertyNodeList</code> object must be sorted in <span>tree
-  order</span>, and the same object must be returned each time a
-  particular <var title="">name</var> is queried.</p>
+  <code>PropertyNodeList</code> object representing a
+  <span>live</span> view of the <code>HTMLPropertiesCollection</code>
+  object, further filtered so that the only nodes in the
+  <code>PropertyNodeList</code> object are those that have a <span
+  title="property names">property name</span> equal to <var
+  title="">name</var>. The nodes in the <code>PropertyNodeList</code>
+  object must be sorted in <span>tree order</span>, and the same
+  object must be returned each time a particular <var
+  title="">name</var> is queried.</p>
 
   <hr>
 
@@ -7362,21 +7361,21 @@
   <p>The <dfn
   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>NodeList</code>
-  containing all the <span>HTML elements</span> in that document that
-  have a <code title="">name</code> attribute whose value is equal to
-  the <var title="">name</var> argument (in a
-  <span>case-sensitive</span> manner), in <span>tree order</span>. A
-  new <code>NodeList</code> object must be returned each time unless
-  the argument is the same as the last time the method was invoked on
-  this <code>Document</code> object, in which case the object must be
-  the same as the object returned by the previous call.</p>
+  title="">name</var>, and must return a <span>live</span>
+  <code>NodeList</code> containing all the <span>HTML elements</span>
+  in that document that have a <code title="">name</code> attribute
+  whose value is equal to the <var title="">name</var> argument (in a
+  <span>case-sensitive</span> manner), in <span>tree order</span>.
+  When the method is invoked on a <code>Document</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>NodeList</code> object must be returned.</p>
 
   <p>The <dfn
   title="dom-document-getElementsByClassName"><code>getElementsByClassName(<var
   title="">classNames</var>)</code></dfn> method takes a string that
   contains a <span>set of space-separated tokens</span> representing
-  classes. When called, the method must return a live
+  classes. When called, the method must return a <span>live</span>
   <code>NodeList</code> object containing all the elements in the
   document, in <span>tree order</span>, that have all the classes
   specified in that argument, having obtained the classes by <span
@@ -7395,7 +7394,7 @@
   <p>The <dfn
   title="dom-getElementsByClassName"><code>getElementsByClassName(<var
   title="">classNames</var>)</code></dfn> method on the
-  <code>HTMLElement</code> interface must return a live
+  <code>HTMLElement</code> interface must return a <span>live</span>
   <code>NodeList</code> with the nodes that the
   <code>HTMLDocument</code> <code
   title="dom-document-getElementsByClassName">getElementsByClassName()</code>
@@ -27744,9 +27743,9 @@
   value.</p>
 
   <p>When set to a <code>CanvasPattern</code> or
-  <code>CanvasGradient</code> object, the assignment is live, meaning
-  that changes made to the object after the assignment do affect
-  subsequent stroking or filling of shapes.</p>
+  <code>CanvasGradient</code> object, the assignment is
+  <span>live</span>, meaning that changes made to the object after the
+  assignment do affect subsequent stroking or filling of shapes.</p>
 
   <p>On getting, if the value is a color, then the <span
   title="serialization of a color">serialization of the color</span>
@@ -31252,7 +31251,7 @@
   for an <code>area</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 <span>live</span>; if the DOM is mutated, then the
   user agent must act as if it had rerun the algorithms for image
   maps.</p>
 
@@ -45120,9 +45119,9 @@
   <p>The <dfn title="dom-cva-validity"><code>validity</code></dfn>
   attribute must return a <code>ValidityState</code> object that
   represents the <span>validity states</span> of the element. This
-  object is live, and the same object must be returned each time the
-  element's <code title="dom-cva-validity">validity</code> attribute
-  is retrieved.</p>
+  object is <span>live</span>, and the same object must be returned
+  each time the element's <code
+  title="dom-cva-validity">validity</code> attribute is retrieved.</p>
 
 <pre class="idl">interface <dfn>ValidityState</dfn> {
   readonly attribute boolean <span title="dom-ValidityState-valueMissing">valueMissing</span>;
@@ -49845,8 +49844,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 <span title="command-facet-ID">ID</span> facet
@@ -53982,16 +53981,16 @@
   title="">typeNames</var>)</code></dfn> method takes an optional
   string that contains an <span>unordered set of unique
   space-separated tokens</span> representing types. When called, the
-  method must return a live <code>NodeList</code> object containing
-  all the elements in the document, in <span>tree order</span>, that
-  are each <span>top-level microdata items</span> with a <span
-  title="item type">type</span> equal to one of the types specified in
-  that argument, having obtained the types by <span title="split a
-  string on spaces">splitting the string on spaces</span>. If there
-  are no tokens specified in the argument, or if the argument is
-  missing, then the method must return a <code>NodeList</code>
-  containing all the <span>top-level microdata items</span> in the
-  document.
+  method must return a <span>live</span> <code>NodeList</code> object
+  containing all the elements in the document, in <span>tree
+  order</span>, that are each <span>top-level microdata items</span>
+  with a <span title="item type">type</span> equal to one of the types
+  specified in that argument, having obtained the types by <span
+  title="split a string on spaces">splitting the string on
+  spaces</span>. If there are no tokens specified in the argument, or
+  if the argument is missing, then the method must return a
+  <code>NodeList</code> containing all the <span>top-level microdata
+  items</span> in the document.
   When the method is invoked on a <code>Document</code> object again
   with the same argument, the user agent may return the same object as
   the object returned by the earlier call. In other cases, a new
@@ -70617,8 +70616,8 @@
   the last of those values that it was set to.</p>
 
   <p>The <dfn 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 <span>live</span> <code>DOMStringList</code>
+  that contains the list of formats that were added to the
   <code>DataTransfer</code> object in the corresponding <code
   title="event-dragstart">dragstart</code> event. The same object must
   be returned each time. If any files were included in the drag, then
@@ -79103,9 +79102,9 @@
     origin">Unicode serialization</span> of the <span>origin</span> of
     the script that invoked the method, and the <code
     title="dom-MessageEvent-source">source</code> attribute must be
-    set to the <span>script's global object</span>.</p> <!--
-    invariant: the global object is always a Window if the script can
-    see this method -->
+    set to the <span>script's global object</span>'s
+    <code>WindowProxy</code> object.</p> <!-- invariant: the global
+    object is always a Window if the script can see this method -->
 
    </li>
 
@@ -79240,9 +79239,9 @@
     origin">Unicode serialization</span> of the <span>origin</span> of
     the script that invoked the method, and the <code
     title="dom-MessageEvent-source">source</code> attribute must be
-    set to the <span>script's global object</span>.</p> <!--
-    invariant: the global object is always a Window if the script can
-    see this method -->
+    set to the <span>script's global object</span>'s
+    <code>WindowProxy</code> object.</p> <!-- invariant: the global
+    object is always a Window if the script can see this method -->
 
    </li>
 
@@ -79266,9 +79265,9 @@
 
   </ol>
 
-  <p class="note">These steps, with the exception of the second and
-  third steps and the penultimate step, are identical to those in the
-  previous section.</p>
+  <p class="note">These steps, with the exception of the third,
+  fourth, and fifth steps and the penultimate step, are identical to
+  those in the previous section.</p>
 
   <!-- v2: we can merge this section and the previous section when
   implementations have shipped postMessage(). Anne asked that these




More information about the Commit-Watchers mailing list