[html5] r2654 - [e] (0) Revamp the CanvasPixelArray and Window[n] texts, for better compatibilit [...]

whatwg at whatwg.org whatwg at whatwg.org
Tue Jan 13 02:57:05 PST 2009


Author: ianh
Date: 2009-01-13 02:57:04 -0800 (Tue, 13 Jan 2009)
New Revision: 2654

Modified:
   index
   source
Log:
[e] (0) Revamp the CanvasPixelArray and Window[n] texts, for better compatibility with WebIDL.

Modified: index
===================================================================
--- index	2009-01-13 10:14:04 UTC (rev 2653)
+++ index	2009-01-13 10:57:04 UTC (rev 2654)
@@ -21110,20 +21110,22 @@
   <p>The object's <span>indices of the supported indexed
   properties</span> are the numbers in the range 0 .. <span><var title="">h</var>×<var title="">w</var>×4-1</span>.</p>
 
-  <p>The value of the <span>corresponding indexed property</span> <var title="">index</var> whenever an indexed property is retrieved is
-  the value of the <var title="">index</var>th component in the
-  array.</p>
+  <p>When a <code><a href=#canvaspixelarray>CanvasPixelArray</a></code> object is indexed to
+  retrieve an indexed property <var title="">index</var>, the value
+  returned must be the value of the <var title="">index</var>th
+  component in the array.</p>
 
-  <p>The behavior for setting an indexed property <var title="">index</var> to a value <var title="">value</var> is to set
-  the value of the <var title="">index</var>th component in the array
-  to <var title="">value</var>. JS <code>undefined</code> values must
-  be converted to zero. Other values must first be converted to
-  numbers using JavaScript's ToNumber algorithm, and if the result is
-  a NaN value, then the value be must converted to zero. If the result
-  is less than 0, it must be clamped to zero. If the result is more
-  than 255, it must be clamped to 255. If the number is not an
-  integer, it should be rounded to the nearest integer using the IEEE
-  754r <i>convertToIntegerTiesToEven</i> rounding mode.  <a href=#refsECMA262>[ECMA262]</a> <a href=#refsIEEE754r>[IEEE754R]</a></p>
+  <p>When a <code><a href=#canvaspixelarray>CanvasPixelArray</a></code> object is indexed to modify
+  an indexed property <var title="">index</var> with value <var title="">value</var>, the value of the <var title="">index</var>th
+  component in the array must be set to <var title="">value</var>. JS
+  <code>undefined</code> values must be converted to zero. Other
+  values must first be converted to numbers using JavaScript's
+  ToNumber algorithm, and if the result is a NaN value, then the value
+  must be converted to zero. If the result is less than 0, it must be
+  clamped to zero. If the result is more than 255, it must be clamped
+  to 255. If the number is not an integer, it should be rounded to the
+  nearest integer using the IEEE 754r
+  <i>convertToIntegerTiesToEven</i> rounding mode. <a href=#refsECMA262>[ECMA262]</a> <a href=#refsIEEE754r>[IEEE754R]</a></p>
 
   <p class=note>The width and height (<var title="">w</var> and <var title="">h</var>) might be different from the <var title="">sw</var>
   and <var title="">sh</var> arguments to the above methods, e.g. if
@@ -33526,8 +33528,7 @@
 
    <li>The <code title=dom-frames><a href=#dom-frames>frames</a></code> attribute
 
-   <li>Any <span title="corresponding indexed property">corresponding
-   indexed properties</span> (used for <a href=#dom-window-item title=dom-window-item>accessing nested browsing contexts</a>)
+   <li>The <a href=#dynamic-nested-browsing-context-properties>dynamic nested browsing context properties</a>
 
   </ul><p>User agents must not allow scripts to override the <code title=dom-location><a href=#dom-location>location</a></code> object's setter.</p>
 
@@ -33630,21 +33631,22 @@
   contexts</a> of the <a href=#active-document title="active document">active</a>
   <code>Document</code>.</p>
 
-  <p>The <span>indices of the supported indexed properties</span> on the <code><a href=#window>Window</a></code> object at
-  any instant are the numbers in the range 0 .. <var title="">n</var>, where <var title="">n</var> is the
+  <p>The <span>indices of the supported indexed properties</span> on
+  the <code><a href=#window>Window</a></code> object at any instant are the numbers in the
+  range 0 .. <var title="">n</var>, where <var title="">n</var> is the
   number of <a href=#child-browsing-context title="child browsing context">child browsing
   contexts</a> of the <a href=#active-document title="active document">active</a>
-  <code>Document</code>.</p>
+  <code>Document</code>. These properties are the <dfn id=dynamic-nested-browsing-context-properties>dynamic nested
+  browsing context properties</dfn>.</p>
 
-  <p>The value of a <span>corresponding indexed property</span> <var title="">index</var> whenever <dfn id=dom-window-item title=dom-window-item>an
-  indexed property on a <code>Window</code> object is retrieved</dfn>
-  is the <var title="">index</var>th <a href=#child-browsing-context>child browsing
-  context</a> of the <a href=#active-document title="active document">active</a>
+  <p>When a <code><a href=#window>Window</a></code> object is <dfn id=dom-window-item title=dom-window-item>indexed to retrieve an indexed
+  property</dfn> <var title="">index</var>, the value returned must be
+  the <var title="">index</var>th <a href=#child-browsing-context>child browsing context</a>
+  of the <a href=#active-document title="active document">active</a>
   <code>Document</code>, sorted in document order of the elements
   nesting those browsing contexts.</p>
 
 
-
   <h4 id=garbage-collection-and-browsing-contexts><span class=secno>5.2.4 </span>Garbage collection and browsing contexts</h4>
 
   <p>A <a href=#browsing-context>browsing context</a> has a strong reference to each of

Modified: source
===================================================================
--- source	2009-01-13 10:14:04 UTC (rev 2653)
+++ source	2009-01-13 10:57:04 UTC (rev 2654)
@@ -23164,22 +23164,23 @@
   properties</span> are the numbers in the range 0 .. <span><var
   title="">h</var>×<var title="">w</var>×4-1</span>.</p>
 
-  <p>The value of the <span>corresponding indexed property</span> <var
-  title="">index</var> whenever an indexed property is retrieved is
-  the value of the <var title="">index</var>th component in the
-  array.</p>
+  <p>When a <code>CanvasPixelArray</code> object is indexed to
+  retrieve an indexed property <var title="">index</var>, the value
+  returned must be the value of the <var title="">index</var>th
+  component in the array.</p>
 
-  <p>The behavior for setting an indexed property <var
-  title="">index</var> to a value <var title="">value</var> is to set
-  the value of the <var title="">index</var>th component in the array
-  to <var title="">value</var>. JS <code>undefined</code> values must
-  be converted to zero. Other values must first be converted to
-  numbers using JavaScript's ToNumber algorithm, and if the result is
-  a NaN value, then the value be must converted to zero. If the result
-  is less than 0, it must be clamped to zero. If the result is more
-  than 255, it must be clamped to 255. If the number is not an
-  integer, it should be rounded to the nearest integer using the IEEE
-  754r <i>convertToIntegerTiesToEven</i> rounding mode.  <a
+  <p>When a <code>CanvasPixelArray</code> object is indexed to modify
+  an indexed property <var title="">index</var> with value <var
+  title="">value</var>, the value of the <var title="">index</var>th
+  component in the array must be set to <var title="">value</var>. JS
+  <code>undefined</code> values must be converted to zero. Other
+  values must first be converted to numbers using JavaScript's
+  ToNumber algorithm, and if the result is a NaN value, then the value
+  must be converted to zero. If the result is less than 0, it must be
+  clamped to zero. If the result is more than 255, it must be clamped
+  to 255. If the number is not an integer, it should be rounded to the
+  nearest integer using the IEEE 754r
+  <i>convertToIntegerTiesToEven</i> rounding mode. <a
   href="#refsECMA262">[ECMA262]</a> <a
   href="#refsIEEE754r">[IEEE754R]</a></p>
 
@@ -38071,9 +38072,7 @@
 
    <li>The <code title="dom-frames">frames</code> attribute
 
-   <li>Any <span title="corresponding indexed property">corresponding
-   indexed properties</span> (used for <span
-   title="dom-window-item">accessing nested browsing contexts</span>)
+   <li>The <span>dynamic nested browsing context properties</span>
 
   </ul>
 
@@ -38185,22 +38184,23 @@
   contexts</span> of the <span title="active document">active</span>
   <code>Document</code>.</p>
 
-  <p>The <span>indices of the supported indexed properties</span> on the <code>Window</code> object at
-  any instant are the numbers in the range 0 .. <var title="">n</var>, where <var title="">n</var> is the
+  <p>The <span>indices of the supported indexed properties</span> on
+  the <code>Window</code> object at any instant are the numbers in the
+  range 0 .. <var title="">n</var>, where <var title="">n</var> is the
   number of <span title="child browsing context">child browsing
   contexts</span> of the <span title="active document">active</span>
-  <code>Document</code>.</p>
+  <code>Document</code>. These properties are the <dfn>dynamic nested
+  browsing context properties</dfn>.</p>
 
-  <p>The value of a <span>corresponding indexed property</span> <var
-  title="">index</var> whenever <dfn title="dom-window-item">an
-  indexed property on a <code>Window</code> object is retrieved</dfn>
-  is the <var title="">index</var>th <span>child browsing
-  context</span> of the <span title="active document">active</span>
+  <p>When a <code>Window</code> object is <dfn
+  title="dom-window-item">indexed to retrieve an indexed
+  property</dfn> <var title="">index</var>, the value returned must be
+  the <var title="">index</var>th <span>child browsing context</span>
+  of the <span title="active document">active</span>
   <code>Document</code>, sorted in document order of the elements
   nesting those browsing contexts.</p>
 
 
-
   <h4>Garbage collection and browsing contexts</h4>
 
   <p>A <span>browsing context</span> has a strong reference to each of




More information about the Commit-Watchers mailing list