First part of remembering platform app window geometry.

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.
 
 // File-level comment to appease parser. Eventually this will not be necessary.
 
 namespace app.window {
   dictionary CreateWindowOptions {
+    // id to identify the window.
+    DOMString? id;
+
+    // Default width of the window.
+    long? defaultWidth;
+
+    // Default height of the window.
+    long? defaultHeight;
+
+    // Default X coordinate of the window.
+    long? defaultLeft;
+
+    // Default Y coordinate of the window.
+    long? defaultTop;
+

[asargent_no_longer_on_chrome, 2012/08/28 18:49:41]

We should add a comment somewhere explaining to developers the difference
between width/height and defaultWidth/defaultHeight (similarly for left/top and
defaultLeft/defaultTop). Is it an error to specify both a regular and default
value? etc.

You can add this comment either above line 8 where we start the definition of
hte CreateWindowOptions dictionary, or later in the file above the declaration
of the |create| function. 

[Marijn Kruisselbrink, 2012/08/28 22:14:58]

Okay, attempted to write some sort of explanation, not sure if it all makes
sense or is the best way to explain it all...
Also adding it above line 8 didn't make it show up in the generated docs at all
(also I'm not sure if I should be using html <p> tags for the paragraphs,
existing docs don't seem to, but then paragraphs get all merged together in the
generated html)

     // Width of the window.
     long? width;
 
     // Height of the window.
     long? height;
 
     // X coordinate of the window.
     long? left;
 
     // Y coordinate of the window.
@@ skipping 27 matching lines @@
                        optional CreateWindowCallback callback);
 
     static void focus();
     static void maximize();
     static void minimize();
     static void restore();
     [nocompile] static void moveTo(long x, long y);
     [nocompile] static void resizeTo(long width, long height);
   };
 };