W3C home > Mailing lists > Public > public-html-diffs@w3.org > March 2010

hixie: 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)

From: poot <cvsmail@w3.org>
Date: Thu, 18 Mar 2010 08:50:52 +0900 (JST)
To: public-html-diffs@w3.org
Message-Id: <20100317235052.5CB922BC06@toro.w3.mag.keio.ac.jp>
hixie: 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)

http://dev.w3.org/cvsweb/html5/spec/Overview.html?r1=1.3891&r2=1.3892&f=h
http://html5.org/tools/web-apps-tracker?from=4856&to=4857

===================================================================
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:51:21 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Saturday, 18 December 2010 06:14:18 GMT