[html5] r6653 - [giow] (0) Clarify that you can transfer a port more than once by avoiding confu [...]
whatwg at whatwg.org
whatwg at whatwg.org
Fri Oct 7 14:58:32 PDT 2011
Author: ianh
Date: 2011-10-07 14:58:30 -0700 (Fri, 07 Oct 2011)
New Revision: 6653
Modified:
complete.html
index
source
Log:
[giow] (0) Clarify that you can transfer a port more than once by avoiding confusing terminology that suggested otherwise.
Fixing http://www.w3.org/Bugs/Public/show_bug.cgi?id=13717
Modified: complete.html
===================================================================
--- complete.html 2011-10-07 21:41:56 UTC (rev 6652)
+++ complete.html 2011-10-07 21:58:30 UTC (rev 6653)
@@ -8920,9 +8920,10 @@
<p>To <dfn id=transfer-a-transferable-object>transfer a <code>Transferable</code> object</dfn> to a
new owner, the user agent must run the steps defined for the type of
object in question. The steps will return a new object of the same
- type, and will permanently neuter the original object. (This is an
- irreversible and non-idempotent operation; once an object has been
- transferred, it cannot be transferred, or indeed used, again.)</p>
+ type, and will permanently <dfn id=concept-transferable-neutered title=concept-Transferable-neutered>neuter</dfn> the original
+ object. (This is an irreversible and non-idempotent operation; once
+ an object has been transferred, it cannot be transferred, or indeed
+ used, again.)</p>
</div>
@@ -81589,9 +81590,9 @@
<p>If any object is listed in <var title="">transfer</var> more
than once, or any of the <code><a href=#transferable>Transferable</a></code> objects
- listed in <var title="">transfer</var> have already been <a href=#transfer-a-transferable-object title="transfer a Transferable object">transfered</a> once
- before, then throw a <code><a href=#datacloneerror>DataCloneError</a></code> exception and
- abort these steps.</p>
+ listed in <var title="">transfer</var> are marked as <a href=#concept-transferable-neutered title=concept-Transferable-neutered>neutered</a>, then
+ throw a <code><a href=#datacloneerror>DataCloneError</a></code> exception and abort these
+ steps.</p>
</li>
@@ -81603,9 +81604,9 @@
object">transferring</a> the object to the
<code><a href=#window>Window</a></code> object on which the method was invoked, and
add a mapping from the old object to the new transferred object
- to <var title="">transfer map</var>. If the objects are
- <code><a href=#messageport>MessagePort</a></code> objects, also append the new
- transferred object to the <var title="">new ports</var>
+ to <var title="">transfer map</var>. For each new
+ <code><a href=#messageport>MessagePort</a></code> object obtained in this manner, append
+ the new transferred object to the <var title="">new ports</var>
array.</p>
</li>
@@ -82013,7 +82014,8 @@
</ol><p id=transferMessagePort>To <a href=#transfer-a-transferable-object title="transfer a Transferable
object">transfer</a> a <code><a href=#messageport>MessagePort</a></code> object <var title="">old</var> to a new owner <var title="">owner</var>, a user
- agent must <a href=#clone-a-port title="clone a port">clone</a> the <var title="">old</var> object with the cloned being owned by <var title="">owner</var>, and must return the resulting object.</p>
+ agent must <a href=#clone-a-port title="clone a port">clone</a> the <var title="">old</var> object with the clone being owned by <var title="">owner</var>, thus obtaining <var title="">new</var>, must
+ <a href=#concept-transferable-neutered title=concept-Transferable-neutered>neuter</a> the <var title="">old</var> port, and must finally return <var title="">new</var>.</p>
<hr><!-- v2-onclose
<p>The <dfn title="dom-MessagePort-active"><code>active</code></dfn>
Modified: index
===================================================================
--- index 2011-10-07 21:41:56 UTC (rev 6652)
+++ index 2011-10-07 21:58:30 UTC (rev 6653)
@@ -8920,9 +8920,10 @@
<p>To <dfn id=transfer-a-transferable-object>transfer a <code>Transferable</code> object</dfn> to a
new owner, the user agent must run the steps defined for the type of
object in question. The steps will return a new object of the same
- type, and will permanently neuter the original object. (This is an
- irreversible and non-idempotent operation; once an object has been
- transferred, it cannot be transferred, or indeed used, again.)</p>
+ type, and will permanently <dfn id=concept-transferable-neutered title=concept-Transferable-neutered>neuter</dfn> the original
+ object. (This is an irreversible and non-idempotent operation; once
+ an object has been transferred, it cannot be transferred, or indeed
+ used, again.)</p>
</div>
@@ -81589,9 +81590,9 @@
<p>If any object is listed in <var title="">transfer</var> more
than once, or any of the <code><a href=#transferable>Transferable</a></code> objects
- listed in <var title="">transfer</var> have already been <a href=#transfer-a-transferable-object title="transfer a Transferable object">transfered</a> once
- before, then throw a <code><a href=#datacloneerror>DataCloneError</a></code> exception and
- abort these steps.</p>
+ listed in <var title="">transfer</var> are marked as <a href=#concept-transferable-neutered title=concept-Transferable-neutered>neutered</a>, then
+ throw a <code><a href=#datacloneerror>DataCloneError</a></code> exception and abort these
+ steps.</p>
</li>
@@ -81603,9 +81604,9 @@
object">transferring</a> the object to the
<code><a href=#window>Window</a></code> object on which the method was invoked, and
add a mapping from the old object to the new transferred object
- to <var title="">transfer map</var>. If the objects are
- <code><a href=#messageport>MessagePort</a></code> objects, also append the new
- transferred object to the <var title="">new ports</var>
+ to <var title="">transfer map</var>. For each new
+ <code><a href=#messageport>MessagePort</a></code> object obtained in this manner, append
+ the new transferred object to the <var title="">new ports</var>
array.</p>
</li>
@@ -82013,7 +82014,8 @@
</ol><p id=transferMessagePort>To <a href=#transfer-a-transferable-object title="transfer a Transferable
object">transfer</a> a <code><a href=#messageport>MessagePort</a></code> object <var title="">old</var> to a new owner <var title="">owner</var>, a user
- agent must <a href=#clone-a-port title="clone a port">clone</a> the <var title="">old</var> object with the cloned being owned by <var title="">owner</var>, and must return the resulting object.</p>
+ agent must <a href=#clone-a-port title="clone a port">clone</a> the <var title="">old</var> object with the clone being owned by <var title="">owner</var>, thus obtaining <var title="">new</var>, must
+ <a href=#concept-transferable-neutered title=concept-Transferable-neutered>neuter</a> the <var title="">old</var> port, and must finally return <var title="">new</var>.</p>
<hr><!-- v2-onclose
<p>The <dfn title="dom-MessagePort-active"><code>active</code></dfn>
Modified: source
===================================================================
--- source 2011-10-07 21:41:56 UTC (rev 6652)
+++ source 2011-10-07 21:58:30 UTC (rev 6653)
@@ -8895,9 +8895,11 @@
<p>To <dfn>transfer a <code>Transferable</code> object</dfn> to a
new owner, the user agent must run the steps defined for the type of
object in question. The steps will return a new object of the same
- type, and will permanently neuter the original object. (This is an
- irreversible and non-idempotent operation; once an object has been
- transferred, it cannot be transferred, or indeed used, again.)</p>
+ type, and will permanently <dfn
+ title="concept-Transferable-neutered">neuter</dfn> the original
+ object. (This is an irreversible and non-idempotent operation; once
+ an object has been transferred, it cannot be transferred, or indeed
+ used, again.)</p>
</div>
@@ -92447,10 +92449,10 @@
<p>If any object is listed in <var title="">transfer</var> more
than once, or any of the <code>Transferable</code> objects
- listed in <var title="">transfer</var> have already been <span
- title="transfer a Transferable object">transfered</span> once
- before, then throw a <code>DataCloneError</code> exception and
- abort these steps.</p>
+ listed in <var title="">transfer</var> are marked as <span
+ title="concept-Transferable-neutered">neutered</span>, then
+ throw a <code>DataCloneError</code> exception and abort these
+ steps.</p>
</li>
@@ -92462,9 +92464,9 @@
object">transferring</span> the object to the
<code>Window</code> object on which the method was invoked, and
add a mapping from the old object to the new transferred object
- to <var title="">transfer map</var>. If the objects are
- <code>MessagePort</code> objects, also append the new
- transferred object to the <var title="">new ports</var>
+ to <var title="">transfer map</var>. For each new
+ <code>MessagePort</code> object obtained in this manner, append
+ the new transferred object to the <var title="">new ports</var>
array.</p>
</li>
@@ -92933,8 +92935,11 @@
object">transfer</span> a <code>MessagePort</code> object <var
title="">old</var> to a new owner <var title="">owner</var>, a user
agent must <span title="clone a port">clone</span> the <var
- title="">old</var> object with the cloned being owned by <var
- title="">owner</var>, and must return the resulting object.</p>
+ title="">old</var> object with the clone being owned by <var
+ title="">owner</var>, thus obtaining <var title="">new</var>, must
+ <span title="concept-Transferable-neutered">neuter</span> the <var
+ title="">old</var> port, and must finally return <var
+ title="">new</var>.</p>
<hr>
<!-- v2-onclose
More information about the Commit-Watchers
mailing list