html5/spec Overview.html,1.1823,1.1824

Update of /sources/public/html5/spec
In directory hutz:/tmp/cvs-serv22181

Modified Files:
	Overview.html 
Log Message:
Revamp the CanvasPixelArray and Window[n] texts, for better compatibility with WebIDL. (whatwg r2654)

Index: Overview.html
===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.1823
retrieving revision 1.1824
diff -u -d -r1.1823 -r1.1824
--- Overview.html	13 Jan 2009 10:14:10 -0000	1.1823
+++ Overview.html	13 Jan 2009 10:57:10 -0000	1.1824
@@ -17145,18 +17145,20 @@
   <dfn id=dom-canvaspixelarray-length title=dom-canvaspixelarray-length><code>length</code></dfn>
   attribute of a <code><a href=#canvaspixelarray>CanvasPixelArray</a></code> object must return this
   number.<p>The object's <span>indices of the supported indexed
-  properties</span> are the numbers in the range 0 .. <span><var title="">h</var>&times;<var title="">w</var>&times;4-1</span>.<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>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=#references>[ECMA262]</a> <a href=#references>[IEEE754R]</a><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>
+  properties</span> are the numbers in the range 0 .. <span><var title="">h</var>&times;<var title="">w</var>&times;4-1</span>.<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>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=#references>[ECMA262]</a> <a href=#references>[IEEE754R]</a><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
   the canvas is backed by a high-resolution bitmap, or if the <var title="">sw</var> and <var title="">sh</var> arguments are
   negative.<p>The <dfn id=dom-context-2d-putimagedata title=dom-context-2d-putImageData><code>putImageData(<var title="">imagedata</var>, <var title="">dx</var>, <var title="">dy</var>)</code></dfn> and <dfn id=dom-context-2d-putimagedata-dirty title=dom-context-2d-putImageData-dirty><code>putImageData(<var title="">imagedata</var>, <var title="">dx</var>, <var title="">dy</var>, <var title="">dirtyX</var>, <var title="">dirtyY</var>, <var title="">dirtyWidth</var>, <var title="">dirtyHeight</var>)</code></dfn> methods write data from
@@ -27192,8 +27194,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.<h4 id=apis-for-creating-and-navigating-browsing-contexts-by-name><span class=secno>5.2.2 </span>APIs for creating and navigating browsing contexts by name</h4><p>The <dfn id=dom-open title=dom-open><code>open()</code></dfn> method on
   <code><a href=#window>Window</a></code> objects provides a mechanism for <a href=#navigate title=navigate>navigating</a> an existing <a href=#browsing-context>browsing
@@ -27257,14 +27258,16 @@
   attribute on the <code><a href=#window>Window</a></code> interface must return 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>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
+  <code>Document</code>.<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>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>
+  <code>Document</code>. These properties are the <dfn id=dynamic-nested-browsing-context-properties>dynamic nested
+  browsing context properties</dfn>.<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.<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
   its <code>Document</code>s and <a href=#view title=view>views</a>, and

Received on Tuesday, 13 January 2009 10:57:26 UTC