First part of remembering platform app window geometry.

chrome/common/extensions/docs/apps/app.window.html

Index: chrome/common/extensions/docs/apps/app.window.html
diff --git a/chrome/common/extensions/docs/apps/app.window.html b/chrome/common/extensions/docs/apps/app.window.html
index 483a8e73f35a6d5cd6085d8996866c3d29598875..97b3c150a9a7c6c27ce5ec4754b4b67b390c1a1d 100644
--- a/chrome/common/extensions/docs/apps/app.window.html
+++ b/chrome/common/extensions/docs/apps/app.window.html
@@ -236,6 +236,7 @@
                       <var><span>options</span></var></span><span class="optional"><span>, </span><span>function</span>
                       <var><span>CreateWindowCallback</span></var></span>)</div>
               <div class="description">
+                <p>The size and position of a window can be specified in a number of different ways. The most simple option is not specifying anything at all, in which case a default size and platform dependent position will be used. Another option is to use the top/left and width/height properties, which will always put the window at the specified coordinates with the specified size. Yet another option is to give the window a (unique) id. This id is then used to remember the size and position of the window whenever it is moved or resized. This size and position is then used on subsequent opening of a window with the same id. The defaultLeft/defaultTop and defaultWidth/defaultHeight properties can be used to specify a position and size when no geometry has been stored for the window yet. You can also combine these various options, explicitly specifying for example the size while having the position be remembered or other combinations like that. Size and position are dealt with seperately, but individual coordinates are not. So if you specify a top (or left) coordinate, you should also specify a left (or top) coordinate, and similar for size. If you specify both a regular and a default value for the same option the regular value is the only one that takes effect.</p>
                 <!-- PARAMETERS -->
                 <h4>Parameters</h4>
                 <dl>
@@ -597,6 +598,102 @@
               <div>
                 <div>
           <dt>
+            <var>defaultHeight</var>
+              <em>
+                <!-- TYPE -->
+                <div style="display:inline">
+                  (
+                    <span class="optional">optional</span>
+                    <span id="typeTemplate">
+                      <span>
+                        <span>integer</span>
+                      </span>
+                    </span>
+                  )
+                </div>
+              </em>
+          </dt>
+          <dd>Default height of the window.</dd>
+          <!-- OBJECT PROPERTIES -->
+          <!-- OBJECT METHODS -->
+          <!-- OBJECT EVENT FIELDS -->
+          <!-- FUNCTION PARAMETERS -->
+        </div>
+              </div><div>
+                <div>
+          <dt>
+            <var>defaultLeft</var>
+              <em>
+                <!-- TYPE -->
+                <div style="display:inline">
+                  (
+                    <span class="optional">optional</span>
+                    <span id="typeTemplate">
+                      <span>
+                        <span>integer</span>
+                      </span>
+                    </span>
+                  )
+                </div>
+              </em>
+          </dt>
+          <dd>Default X coordinate of the window.</dd>
+          <!-- OBJECT PROPERTIES -->
+          <!-- OBJECT METHODS -->
+          <!-- OBJECT EVENT FIELDS -->
+          <!-- FUNCTION PARAMETERS -->
+        </div>
+              </div><div>
+                <div>
+          <dt>
+            <var>defaultTop</var>
+              <em>
+                <!-- TYPE -->
+                <div style="display:inline">
+                  (
+                    <span class="optional">optional</span>
+                    <span id="typeTemplate">
+                      <span>
+                        <span>integer</span>
+                      </span>
+                    </span>
+                  )
+                </div>
+              </em>
+          </dt>
+          <dd>Default Y coordinate of the window.</dd>
+          <!-- OBJECT PROPERTIES -->
+          <!-- OBJECT METHODS -->
+          <!-- OBJECT EVENT FIELDS -->
+          <!-- FUNCTION PARAMETERS -->
+        </div>
+              </div><div>
+                <div>
+          <dt>
+            <var>defaultWidth</var>
+              <em>
+                <!-- TYPE -->
+                <div style="display:inline">
+                  (
+                    <span class="optional">optional</span>
+                    <span id="typeTemplate">
+                      <span>
+                        <span>integer</span>
+                      </span>
+                    </span>
+                  )
+                </div>
+              </em>
+          </dt>
+          <dd>Default width of the window.</dd>
+          <!-- OBJECT PROPERTIES -->
+          <!-- OBJECT METHODS -->
+          <!-- OBJECT EVENT FIELDS -->
+          <!-- FUNCTION PARAMETERS -->
+        </div>
+              </div><div>
+                <div>
+          <dt>
             <var>frame</var>
               <em>
                 <!-- TYPE -->
@@ -645,6 +742,30 @@
               </div><div>
                 <div>
           <dt>
+            <var>id</var>
+              <em>
+                <!-- TYPE -->
+                <div style="display:inline">
+                  (
+                    <span class="optional">optional</span>
+                    <span id="typeTemplate">
+                      <span>
+                        <span>string</span>
+                      </span>
+                    </span>
+                  )
+                </div>
+              </em>
+          </dt>
+          <dd>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 (and no explicit size or position) is later opened.</dd>
+          <!-- OBJECT PROPERTIES -->
+          <!-- OBJECT METHODS -->
+          <!-- OBJECT EVENT FIELDS -->
+          <!-- FUNCTION PARAMETERS -->
+        </div>
+              </div><div>
+                <div>
+          <dt>
             <var>left</var>
               <em>
                 <!-- TYPE -->