Deprecate 'singleton' option in chrome.apps.window.create().

chrome/common/extensions/api/app_window.idl

 // Copyright (c) 2012 The Chromium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
 // Use the <code>chrome.app.window</code> API to create windows. Windows
 // have an optional frame with title bar and size controls. They are not
 // associated with any Chrome browser windows.
 namespace app.window {
   dictionary Bounds {
     long? left;
     long? top;
     long? width;
     long? height;
   };
 
   // State of a window: normal, fullscreen, maximized, minimized.
   enum State { normal, fullscreen, maximized, minimized };
 
   // 'shell' is the default window type. 'panel' is managed by the OS
   // (Currently experimental, Ash only).
   [nodoc] enum WindowType { shell, panel };
 
   dictionary CreateWindowOptions {
     // Id to identify the window. This will be used to remember the size
     // and position of the window and restore that geometry when a window
     // with the same id is later opened.
+    // If a window with a given id is created while another window with the same
+    // id already exists, the currently opened window will be focused instead of
+    // creating a new window.
     DOMString? id;
 
     // Default width of the window. (Deprecated; regular bounds act like this
     // now.)
     [nodoc] long? defaultWidth;
 
     // Default height of the window. (Deprecated; regular bounds act like this
     // now.)
     [nodoc] long? defaultHeight;
 
@@ skipping 58 matching lines @@
     boolean? hidden;
 
     // If true, the window will be resizable by the user. Defaults to true.
     boolean? resizable;
 
     // By default if you specify an id for the window, the window will only be
     // created if another window with the same id doesn't already exist. If a
     // window with the same id already exists that window is activated instead.
     // If you do want to create multiple windows with the same id, you can
     // set this property to false.
-    boolean? singleton;
+    // (Deprecated; multiple windows with the same id is no longer supported.)
+    [nodoc] boolean? singleton;
 
     // If true, the window will stay above most other windows. If there are
     // multiple windows of this kind, the currently focused window will be in
     // the foreground. Defaults to false. Call <code>setAlwaysOnTop()</code> on
     // the window to change this property after creation.
     boolean? alwaysOnTop;
   };
 
   // Called in the creating window (parent) before the load event is called in
   // the created window (child). The parent can set fields or functions on the
@@ skipping 148 matching lines @@
     // Fired when the window is maximized.
     [nocompile] static void onMaximized();
 
     // Fired when the window is minimized.
     [nocompile] static void onMinimized();
 
     // Fired when the window is restored from being minimized or maximized.
     [nocompile] static void onRestored();
   };
 };