Document fullscreen/ESC behaviour.

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 9b3dabd9a4dda55613c57a8eeff2def3c4b28ef2..de1455ed8793a6a38cbbe8459a410f4c071dbdd9 100644
--- a/chrome/common/extensions/api/app_window.idl
+++ b/chrome/common/extensions/api/app_window.idl
@@ -135,7 +135,14 @@ namespace app.window {
     // Focus the window.
     static void focus();
 
-    // Fullscreens the window.
+    // Fullscreens the window.<br>
+    // The user will be able to restore the window by pressing ESC. An
+    // application can prevent the fullscreen state to be left when ESC is
+    // pressed by requesting the <b>overrideEscFullscreen</b> permission and
+    // canceling the event by calling .preventDefault(), like this:<br>
+    // <code>function(createdWindow) { createdWindow.contentWindow.onKeyDown =
+    // function(e) { if (e.keyCode == 27 /* ESC */) { e.preventDefault(); } } };

[benwells, 2014/01/06 05:28:24]

Nit: Just having the below is enough:

window.onKeyDown = function(e) .....

+    // </code>
     static void fullscreen();
 
     // Is the window fullscreen?