[html5] r7878 - [e] (0) Rewrite this prose to be more explicit and clear. Fixing https://www.w3. [...]

[whatwg at whatwg.org]

Author: ianh
Date: 2013-05-31 12:35:36 -0700 (Fri, 31 May 2013)
New Revision: 7878

Modified:
   complete.html
   index
   source
Log:
[e] (0) Rewrite this prose to be more explicit and clear.
Fixing https://www.w3.org/Bugs/Public/show_bug.cgi?id=21658
Affected topics: DOM APIs

Modified: complete.html
===================================================================
--- complete.html	2013-05-31 19:25:08 UTC (rev 7877)
+++ complete.html	2013-05-31 19:35:36 UTC (rev 7878)
@@ -8148,19 +8148,29 @@
 
    <li>
 
-    <p>If <var title="">input</var> is an Array object or an Object
-    object, then, for each enumerable own property in <var title="">input</var>, add a new property to <var title="">output</var> having the same name, and having a value
-    created from invoking the <a href=#internal-structured-cloning-algorithm>internal structured cloning
-    algorithm</a> recursively with the value of the property as the
-    "<var title="">input</var>" argument and <var title="">memory</var> as the "<var title="">memory</var>"
-    argument. The order of the properties in the <var title="">input</var> and <var title="">output</var> objects must
-    be the same, and any properties that involve running script must
-    be processed in that same order. If obtaining the value of the
-    property involved executing script, and that script threw an
-    uncaught exception, then abort the overall <a href=#structured-clone>structured
-    clone</a> algorithm, with that exception being passed through
-    to the caller.</p>
+    <p>If <var title="">input</var> is an Array object or an Object object, then, for each
+    enumerable own property in <var title="">input</var>, run the following steps:</p>
 
+    <ol><li><p>Let <var title="">name</var> be the name of the property.</li>
+
+     <li><p>Let <var title="">source value</var> be the result of calling the [[Get]] internal
+     method of <var title="">input</var> with the argument <var title="">name</var>. If the [[Get]]
+     internal method of a property involved executing script, and that script threw an uncaught
+     exception, then abort the overall <a href=#structured-clone>structured clone</a> algorithm, with that exception
+     being passed through to the caller.</li>
+
+     <li><p>Let <var title="">cloned value</var> be the result of invoking the <a href=#internal-structured-cloning-algorithm>internal
+     structured cloning algorithm</a> recursively with <var title="">source value</var> as the
+     "<var title="">input</var>" argument and <var title="">memory</var> as the "<var title="">memory</var>" argument. If this results in an exception, then abort the overall
+     <a href=#structured-clone>structured clone</a> algorithm, with that exception being passed through to the
+     caller.</li>
+
+     <li><p>Add a new property to <var title="">output</var> having the name <var title="">name</var>, and having the value <var title="">cloned value</var>.</li>
+
+    </ol><p>The order of the properties in the <var title="">input</var> and <var title="">output</var>
+    objects must be the same, and any properties whose [[Get]] internal method involves running
+    script must be processed in that same order.</p>
+
     <p class=note>This does not walk the prototype chain.</p>
 
     <p class=note>Property descriptors, setters, getters, and

Modified: index
===================================================================
--- index	2013-05-31 19:25:08 UTC (rev 7877)
+++ index	2013-05-31 19:35:36 UTC (rev 7878)
@@ -8148,19 +8148,29 @@
 
    <li>
 
-    <p>If <var title="">input</var> is an Array object or an Object
-    object, then, for each enumerable own property in <var title="">input</var>, add a new property to <var title="">output</var> having the same name, and having a value
-    created from invoking the <a href=#internal-structured-cloning-algorithm>internal structured cloning
-    algorithm</a> recursively with the value of the property as the
-    "<var title="">input</var>" argument and <var title="">memory</var> as the "<var title="">memory</var>"
-    argument. The order of the properties in the <var title="">input</var> and <var title="">output</var> objects must
-    be the same, and any properties that involve running script must
-    be processed in that same order. If obtaining the value of the
-    property involved executing script, and that script threw an
-    uncaught exception, then abort the overall <a href=#structured-clone>structured
-    clone</a> algorithm, with that exception being passed through
-    to the caller.</p>
+    <p>If <var title="">input</var> is an Array object or an Object object, then, for each
+    enumerable own property in <var title="">input</var>, run the following steps:</p>
 
+    <ol><li><p>Let <var title="">name</var> be the name of the property.</li>
+
+     <li><p>Let <var title="">source value</var> be the result of calling the [[Get]] internal
+     method of <var title="">input</var> with the argument <var title="">name</var>. If the [[Get]]
+     internal method of a property involved executing script, and that script threw an uncaught
+     exception, then abort the overall <a href=#structured-clone>structured clone</a> algorithm, with that exception
+     being passed through to the caller.</li>
+
+     <li><p>Let <var title="">cloned value</var> be the result of invoking the <a href=#internal-structured-cloning-algorithm>internal
+     structured cloning algorithm</a> recursively with <var title="">source value</var> as the
+     "<var title="">input</var>" argument and <var title="">memory</var> as the "<var title="">memory</var>" argument. If this results in an exception, then abort the overall
+     <a href=#structured-clone>structured clone</a> algorithm, with that exception being passed through to the
+     caller.</li>
+
+     <li><p>Add a new property to <var title="">output</var> having the name <var title="">name</var>, and having the value <var title="">cloned value</var>.</li>
+
+    </ol><p>The order of the properties in the <var title="">input</var> and <var title="">output</var>
+    objects must be the same, and any properties whose [[Get]] internal method involves running
+    script must be processed in that same order.</p>
+
     <p class=note>This does not walk the prototype chain.</p>
 
     <p class=note>Property descriptors, setters, getters, and

Modified: source
===================================================================
--- source	2013-05-31 19:25:08 UTC (rev 7877)
+++ source	2013-05-31 19:35:36 UTC (rev 7878)
@@ -7816,23 +7816,35 @@
 
    <li>
 
-    <p>If <var title="">input</var> is an Array object or an Object
-    object, then, for each enumerable own property in <var
-    title="">input</var>, add a new property to <var
-    title="">output</var> having the same name, and having a value
-    created from invoking the <span>internal structured cloning
-    algorithm</span> recursively with the value of the property as the
-    "<var title="">input</var>" argument and <var
-    title="">memory</var> as the "<var title="">memory</var>"
-    argument. The order of the properties in the <var
-    title="">input</var> and <var title="">output</var> objects must
-    be the same, and any properties that involve running script must
-    be processed in that same order. If obtaining the value of the
-    property involved executing script, and that script threw an
-    uncaught exception, then abort the overall <span>structured
-    clone</span> algorithm, with that exception being passed through
-    to the caller.</p>
+    <p>If <var title="">input</var> is an Array object or an Object object, then, for each
+    enumerable own property in <var title="">input</var>, run the following steps:</p>
 
+    <ol>
+
+     <li><p>Let <var title="">name</var> be the name of the property.</p></li>
+
+     <li><p>Let <var title="">source value</var> be the result of calling the [[Get]] internal
+     method of <var title="">input</var> with the argument <var title="">name</var>. If the [[Get]]
+     internal method of a property involved executing script, and that script threw an uncaught
+     exception, then abort the overall <span>structured clone</span> algorithm, with that exception
+     being passed through to the caller.</p></li>
+
+     <li><p>Let <var title="">cloned value</var> be the result of invoking the <span>internal
+     structured cloning algorithm</span> recursively with <var title="">source value</var> as the
+     "<var title="">input</var>" argument and <var title="">memory</var> as the "<var
+     title="">memory</var>" argument. If this results in an exception, then abort the overall
+     <span>structured clone</span> algorithm, with that exception being passed through to the
+     caller.</p></li>
+
+     <li><p>Add a new property to <var title="">output</var> having the name <var
+     title="">name</var>, and having the value <var title="">cloned value</var>.</p></li>
+
+    </ol>
+
+    <p>The order of the properties in the <var title="">input</var> and <var title="">output</var>
+    objects must be the same, and any properties whose [[Get]] internal method involves running
+    script must be processed in that same order.</p>
+
     <p class="note">This does not walk the prototype chain.</p>
 
     <p class="note">Property descriptors, setters, getters, and