Add registerPort / lookupPort to generated interfaces with documentation

lib/dom/templates/html/interface/interface_Window.darttemplate

 // Copyright (c) 2011, the Dart project authors.  Please see the AUTHORS file
 // for details. All rights reserved. Use of this source code is governed by a
 // BSD-style license that can be found in the LICENSE file.
 
 // WARNING: Do not edit - generated code.
 
 $!COMMENT
 interface $ID$EXTENDS {
 
   /**
+   * Register a [port] on this window under the given [name].  This
+   * port may be retrieved by any isolate (or JavaScript script)
+   * running in this window.
+   */
+  void registerPort(String name, SendPortSync port);

[Siggi Cherem (dart-lang), 2012/07/10 23:50:41]

should this be registerSyncPort? (do we expect to later have a registerAsyncPort
as well?)

[vsm, 2012/07/10 23:53:24]

We do want to allow SendPort (i.e., the async one) at some point.  Not sure
whether to just have one register function (with a var or to be determined
common base type param) or to break it in two.

On 2012/07/10 23:50:41, sigmund wrote:

+
+  /**
+   * Lookup a port by its [name].  Return null if no port is
+   * registered under [name].
+   */
+  SendPortSync lookupPort(String name);
+
+  /**
    * Executes a [callback] after the next batch of browser layout measurements
    * has completed or would have completed if any browser layout measurements
    * had been scheduled.
    */
   void requestLayoutFrame(TimeoutHandler callback);
 
 
   /** @domName DOMWindow.webkitRequestAnimationFrame */
   int requestAnimationFrame(RequestAnimationFrameCallback callback);
 
   void cancelAnimationFrame(int id);
 
   IDBFactory get indexedDB();
 
 $!MEMBERS
 }