nsPIWindowWatcher in Firefox 3.0

 A window has been created. Add it to our list.
      @param aWindow the window to add
      @param aChrome the corresponding chrome window. The DOM window
                     and chrome will be mapped together, and the corresponding
                     chrome can be retrieved using the (not private)
                     method getChromeForWindow. If null, any extant mapping
                     will be cleared.

 Find a named docshell tree item amongst all windows registered
 with the window watcher.  This may be a subframe in some window,
 for example.

 @param aName the name of the window.  Must not be null.
 @param aRequestor the tree item immediately making the request.
        We should make sure to not recurse down into its findItemWithName
        method.
 @param aOriginalRequestor the original treeitem that made the request.
        Used for security checks.
 @return the tree item with aName as the name, or null if there
         isn't one.  "Special" names, like _self, _top, etc, will be
         treated specially only if aRequestor is null; in that case they
         will be resolved relative to the first window the windowwatcher
         knows about.
 @see findItemWithName methods on nsIDocShellTreeItem and
      nsIDocShellTreeOwner

 Like the public interface's open(), but can deal with openDialog
      style arguments.
      @param aParent parent window, if any. Null if no parent.  If it is
             impossible to get to an nsIWebBrowserChrome from aParent, this
             method will effectively act as if aParent were null.
      @param aURL url to which to open the new window. Must already be
             escaped, if applicable. can be null.
      @param aName window name from JS window.open. can be null.  If a window
             with this name already exists, the openWindow call may just load
             aUrl in it (if aUrl is not null) and return it.
      @param aFeatures window features from JS window.open. can be null.
      @param aDialog use dialog defaults (see nsIDOMWindowInternal::openDialog)
      @param aArgs Window argument
      @return the new window

      @note This method may examine the JS context stack for purposes of
            determining the security context to use for the search for a given
            window named aName.
      @note This method should try to set the default charset for the new
            window to the default charset of the document in the calling window
            (which is determined based on the JS stack and the value of
            aParent).  This is not guaranteed, however.

 A window has been closed. Remove it from our list.
      @param aWindow the window to remove