- From: Michael Smith via cvs-syncmail <cvsmail@w3.org>
- Date: Wed, 17 Mar 2010 23:56:35 +0000
- To: public-html-commits@w3.org
Update of /sources/public/html5/spec
In directory hutz:/tmp/cvs-serv6258
Modified Files:
dom.html editing.html forms.html infrastructure.html
interactive-elements.html spec.html the-canvas-element.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)
[updated by splitter]
Index: infrastructure.html
===================================================================
RCS file: /sources/public/html5/spec/infrastructure.html,v
retrieving revision 1.883
retrieving revision 1.884
diff -u -d -r1.883 -r1.884
--- infrastructure.html 16 Mar 2010 09:06:35 -0000 1.883
+++ infrastructure.html 17 Mar 2010 23:56:32 -0000 1.884
@@ -400,11 +400,10 @@
<code>Foo</code>".</p><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><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>The terms <dfn title="">fire</dfn> and <dfn title="">dispatch</dfn> are used interchangeably in the context of
+ it.</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
defined by the DOM Events specification. <!--
http://krijnhoetmer.nl/irc-logs/webapps/20091218 --> <a href="references.html#refsDOMEVENTS">[DOMEVENTS]</a></p><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><p>The term <dfn id="plugin">plugin</dfn> is used to mean any content handler
@@ -3865,8 +3864,8 @@
<li>Otherwise, if there are no nodes in the collection that have
either an <code title="attr-id"><a href="dom.html#the-id-attribute">id</a></code> attribute or a <code title="attr-fe-name"><a href="forms.html#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="dom.html#the-id-attribute">id</a></code> attribute
@@ -4011,14 +4010,12 @@
either an <code title="attr-id"><a href="dom.html#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="dom.html#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="dom.html#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>
Index: the-canvas-element.html
===================================================================
RCS file: /sources/public/html5/spec/the-canvas-element.html,v
retrieving revision 1.739
retrieving revision 1.740
diff -u -d -r1.739 -r1.740
--- the-canvas-element.html 4 Mar 2010 20:56:41 -0000 1.739
+++ the-canvas-element.html 17 Mar 2010 23:56:33 -0000 1.740
@@ -1067,7 +1067,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="infrastructure.html#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>
Index: dom.html
===================================================================
RCS file: /sources/public/html5/spec/dom.html,v
retrieving revision 1.878
retrieving revision 1.879
diff -u -d -r1.878 -r1.879
--- dom.html 17 Mar 2010 23:26:31 -0000 1.878
+++ dom.html 17 Mar 2010 23:56:32 -0000 1.879
@@ -894,19 +894,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="infrastructure.html#nodelist">NodeList</a></code>
- containing all the <a href="infrastructure.html#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="infrastructure.html#case-sensitive">case-sensitive</a> manner), in <a href="infrastructure.html#tree-order">tree order</a>. A
- new <code><a href="infrastructure.html#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="infrastructure.html#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="infrastructure.html#live">live</a>
+ <code><a href="infrastructure.html#nodelist">NodeList</a></code> containing all the <a href="infrastructure.html#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="infrastructure.html#case-sensitive">case-sensitive</a> manner), in <a href="infrastructure.html#tree-order">tree order</a>.
+ When the method is invoked on a <code><a href="infrastructure.html#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="infrastructure.html#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="infrastructure.html#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="infrastructure.html#live">live</a>
<code><a href="infrastructure.html#nodelist">NodeList</a></code> object containing all the elements in the
document, in <a href="infrastructure.html#tree-order">tree order</a>, that have all the classes
specified in that argument, having obtained the classes by <a href="infrastructure.html#split-a-string-on-spaces" title="split a string on spaces">splitting a string on
@@ -922,7 +922,7 @@
<code><a href="infrastructure.html#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="infrastructure.html#live">live</a>
<code><a href="infrastructure.html#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
Index: forms.html
===================================================================
RCS file: /sources/public/html5/spec/forms.html,v
retrieving revision 1.871
retrieving revision 1.872
diff -u -d -r1.871 -r1.872
--- forms.html 9 Mar 2010 00:36:39 -0000 1.871
+++ forms.html 17 Mar 2010 23:56:32 -0000 1.872
@@ -8425,9 +8425,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="infrastructure.html#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>;
Index: interactive-elements.html
===================================================================
RCS file: /sources/public/html5/spec/interactive-elements.html,v
retrieving revision 1.871
retrieving revision 1.872
diff -u -d -r1.871 -r1.872
--- interactive-elements.html 10 Mar 2010 10:26:30 -0000 1.871
+++ interactive-elements.html 17 Mar 2010 23:56:32 -0000 1.872
@@ -3634,8 +3634,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
Index: editing.html
===================================================================
RCS file: /sources/public/html5/spec/editing.html,v
retrieving revision 1.875
retrieving revision 1.876
diff -u -d -r1.875 -r1.876
--- editing.html 13 Mar 2010 00:46:53 -0000 1.875
+++ editing.html 17 Mar 2010 23:56:32 -0000 1.876
@@ -2198,8 +2198,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="infrastructure.html#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
Index: spec.html
===================================================================
RCS file: /sources/public/html5/spec/spec.html,v
retrieving revision 1.893
retrieving revision 1.894
diff -u -d -r1.893 -r1.894
--- spec.html 17 Mar 2010 23:26:31 -0000 1.893
+++ spec.html 17 Mar 2010 23:56:33 -0000 1.894
@@ -307,7 +307,7 @@
</dl><p>This specification is available in the following formats:
<a href="Overview.html">single page HTML</a>,
<a href="spec.html">multipage HTML</a>.
-This is revision 1.3891.
+This is revision 1.3892.
</p>
<p class="copyright"><a href="http://www.w3.org/Consortium/Legal/ipr-notice#Copyright">Copyright</a>
© 2010 <a href="http://www.w3.org/"><abbr title="World Wide
Received on Wednesday, 17 March 2010 23:56:37 UTC