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;
@@ skipping 84 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.)

[benwells, 2013/11/04 01:54:01]

Update doco for ID to mention that if a window with the same ID is already open,
it will be focused instead of shown.

+    [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();
   };
 };