First part of remembering platform app window geometry.

chrome/common/extensions/api/app_window.idl

Index: chrome/common/extensions/api/app_window.idl
diff --git a/chrome/common/extensions/api/app_window.idl b/chrome/common/extensions/api/app_window.idl
index 7c61e06b6f3cc4e287d4d8536d2bdb045abc9958..3bafb3d308943f36612fec6ddcc941c975d5c95d 100644
--- a/chrome/common/extensions/api/app_window.idl
+++ b/chrome/common/extensions/api/app_window.idl
@@ -6,6 +6,21 @@
 
 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;