[giow] (1) Move the 'ports' argument to the end of postMessage() inst…

…ead of in the middle. git-svn-id: http://svn.whatwg.org/webapps@4870 340c8d12-0b0e-0410-8428-c7bf67bfef74
whatwg · Mar 25, 2010 · 00d91c1 · 00d91c1
1 parent 332f9ca
commit 00d91c1
Show file tree

Hide file tree

Showing 3 changed files with 16 additions and 16 deletions.
diff --git a/complete.html b/complete.html
@@ -52909,7 +52909,7 @@ <h3 id=the-window-object><span class=secno>6.2 </span>The <code><a href=#window>
 
   // <a href=#crossDocumentMessages>cross-document messaging</a>
   void <a href=#dom-window-postmessage-2 title=dom-window-postMessage-2>postMessage</a>(in any message, in DOMString targetOrigin);
-  void <a href=#dom-window-postmessage-3 title=dom-window-postMessage-3>postMessage</a>(in any message, in <a href=#messageportarray>MessagePortArray</a> ports, in DOMString targetOrigin);
+  void <a href=#dom-window-postmessage-3 title=dom-window-postMessage-3>postMessage</a>(in any message, in DOMString targetOrigin, in <a href=#messageportarray>MessagePortArray</a> ports);
 
   // <a href=#event-handler-idl-attributes>event handler IDL attributes</a>
            attribute <a href=#function>Function</a> <a href=#handler-onabort title=handler-onabort>onabort</a>;
@@ -70660,9 +70660,9 @@ <h4 id=posting-messages><span class=secno>10.4.3 </span>Posting messages</h4>
 
   <h4 id=posting-messages-with-message-ports><span class=secno>10.4.4 </span>Posting messages with message ports</h4>
 
-  <p>When a script invokes the <dfn id=dom-window-postmessage-3 title=dom-window-postMessage-3><code>postMessage(<var title="">message</var>, <var title="">ports</var>, <var title="">targetOrigin</var>)</code></dfn> method (with three
-  arguments) on a <code><a href=#window>Window</a></code> object, the user agent must
-  follow these steps:
+  <p>When a script invokes the <dfn id=dom-window-postmessage-3 title=dom-window-postMessage-3><code>postMessage(<var title="">message</var>, <var title="">targetOrigin</var>, <var title="">ports</var>)</code></dfn> method (with three arguments) on
+  a <code><a href=#window>Window</a></code> object, the user agent must follow these
+  steps:
 
   <ol><!-- EXCEPT WHERE NOTED, THESE STEPS ARE IDENTICAL TO THE PREVIOUS SECTION --><!-- one exception is the use of -3 instead of -2 in the xrefs --><li>
 
@@ -70812,7 +70812,7 @@ <h4 id=introduction-9><span class=secno>10.5.1 </span>Introduction</h4>
   <p>One of the ports is kept as the local port, and the other port is
   sent to the remote code, e.g. using <code title=dom-window-postMessage-3><a href=#dom-window-postmessage-3>postMessage()</a></code>:</p>
 
-  <pre>otherWindow.postMessage('hello', [channel.port2], 'http://example.com');</pre>
+  <pre>otherWindow.postMessage('hello', 'http://example.com', [channel.port2]);</pre>
 
   <p>To send messages, the <code title=dom-MessagpePort-postMessage>postMessage()</code> method on
   the port is used:</p>

diff --git a/index b/index
@@ -52810,7 +52810,7 @@ interface <dfn id=window>Window</dfn> {
 
   // <a href=#crossDocumentMessages>cross-document messaging</a>
   void <a href=#dom-window-postmessage-2 title=dom-window-postMessage-2>postMessage</a>(in any message, in DOMString targetOrigin);
-  void <a href=#dom-window-postmessage-3 title=dom-window-postMessage-3>postMessage</a>(in any message, in <a href=#messageportarray>MessagePortArray</a> ports, in DOMString targetOrigin);
+  void <a href=#dom-window-postmessage-3 title=dom-window-postMessage-3>postMessage</a>(in any message, in DOMString targetOrigin, in <a href=#messageportarray>MessagePortArray</a> ports);
 
   // <a href=#event-handler-idl-attributes>event handler IDL attributes</a>
            attribute <a href=#function>Function</a> <a href=#handler-onabort title=handler-onabort>onabort</a>;
@@ -64644,9 +64644,9 @@ function receiver(e) {
 
   <h4 id=posting-messages-with-message-ports><span class=secno>9.2.4 </span>Posting messages with message ports</h4>
 
-  <p>When a script invokes the <dfn id=dom-window-postmessage-3 title=dom-window-postMessage-3><code>postMessage(<var title="">message</var>, <var title="">ports</var>, <var title="">targetOrigin</var>)</code></dfn> method (with three
-  arguments) on a <code><a href=#window>Window</a></code> object, the user agent must
-  follow these steps:
+  <p>When a script invokes the <dfn id=dom-window-postmessage-3 title=dom-window-postMessage-3><code>postMessage(<var title="">message</var>, <var title="">targetOrigin</var>, <var title="">ports</var>)</code></dfn> method (with three arguments) on
+  a <code><a href=#window>Window</a></code> object, the user agent must follow these
+  steps:
 
   <ol><!-- EXCEPT WHERE NOTED, THESE STEPS ARE IDENTICAL TO THE PREVIOUS SECTION --><!-- one exception is the use of -3 instead of -2 in the xrefs --><li>
 
@@ -64796,7 +64796,7 @@ function receiver(e) {
   <p>One of the ports is kept as the local port, and the other port is
   sent to the remote code, e.g. using <code title=dom-window-postMessage-3><a href=#dom-window-postmessage-3>postMessage()</a></code>:</p>
 
-  <pre>otherWindow.postMessage('hello', [channel.port2], 'http://example.com');</pre>
+  <pre>otherWindow.postMessage('hello', 'http://example.com', [channel.port2]);</pre>
 
   <p>To send messages, the <code title=dom-MessagpePort-postMessage>postMessage()</code> method on
   the port is used:</p>

diff --git a/source b/source
@@ -59557,7 +59557,7 @@ interface <dfn>Window</dfn> {
 
 <!--END w3c-html-->  // <span>cross-document messaging</span>
   void <span title="dom-window-postMessage-2">postMessage</span>(in any message, in DOMString targetOrigin);
-  void <span title="dom-window-postMessage-3">postMessage</span>(in any message, in <span>MessagePortArray</span> ports, in DOMString targetOrigin);
+  void <span title="dom-window-postMessage-3">postMessage</span>(in any message, in DOMString targetOrigin, in <span>MessagePortArray</span> ports);
 <!--START w3c-html-->
   // <span>event handler IDL attributes</span>
            attribute <span>Function</span> <span title="handler-onabort">onabort</span>;
@@ -79420,10 +79420,10 @@ function receiver(e) {
 
   <p>When a script invokes the <dfn
   title="dom-window-postMessage-3"><code>postMessage(<var
-  title="">message</var>, <var title="">ports</var>, <var
-  title="">targetOrigin</var>)</code></dfn> method (with three
-  arguments) on a <code>Window</code> object, the user agent must
-  follow these steps:
+  title="">message</var>, <var title="">targetOrigin</var>, <var
+  title="">ports</var>)</code></dfn> method (with three arguments) on
+  a <code>Window</code> object, the user agent must follow these
+  steps:
 
   <ol>
 
@@ -79594,7 +79594,7 @@ function receiver(e) {
   sent to the remote code, e.g. using <code
   title="dom-window-postMessage-3">postMessage()</code>:</p>
 
-  <pre>otherWindow.postMessage('hello', [channel.port2], 'http://example.com');</pre>
+  <pre>otherWindow.postMessage('hello', 'http://example.com', [channel.port2]);</pre>
 
   <p>To send messages, the <code
   title="dom-MessagpePort-postMessage">postMessage()</code> method on