Update HTML5 fullscreen/pointerlock documentation re: ESC handling.

chrome/common/extensions/docs/templates/articles/api_other.html

 <h1>Web APIs</h1>
 
 <p>
 In addition to the
 <a href="api_index">chrome.* APIs</a>,
 extensions can use all the APIs
 that the browser provides
 to web pages and apps.
 If the browser doesn't support an API you want to use,
 you can bundle additional API libraries into your extension.
@@ skipping 28 matching lines @@
   <li> application cache
     (<a href="http://www.html5rocks.com/tutorials/appcache/beginner/">tutorial</a>) </li>
   <li> canvas
     (<a href="http://www.html5rocks.com/en/tutorials/#canvas">articles</a>) </li>
 {{?is_apps}}
   <li> fullscreen
     (<a href="http://updates.html5rocks.com/2011/10/Let-Your-Content-Do-the-Talking-Fullscreen-API">article</a>)
     <ul>
       <li>In Chrome Apps, fullscreen is entered without
         prompting the user or providing exit instructions.
-        Also, there is no default exit behavior. In normal webpages,
-        the browser intercepts the ESC key to exit fullscreen.
-        This behavior is not present in Chrome Apps.</li>
+        HTML5 fullscreen requires the <code>app.window.fullscreen</code>
+        permission in the manifest. In normal webpages,
+        the browser intercepts the ESC key to exit fullscreen ensuring
+        a consistent escape method for users.
+        That is also the behavior in Chrome Apps unless the
+        <code>app.window.fullscreen.overrideEsc</code>
+        permission is used to enable the app to call
+        <code>preventDefault</code> on keydown and keyup events.</li>
     </ul>
   </li>
 {{/is_apps}}
   <li> geolocation
     (<a href="http://www.html5rocks.com/tutorials/geolocation/trip_meter/">tutorial</a>) </li>
   <li> local storage
     (<a href="http://www.html5rocks.com/en/tutorials/offline/storage/">tutorial</a>) </li>
   <li> notifications
     (<a href="http://www.html5rocks.com/tutorials/notifications/quick/">tutorial</a>) </li>
 {{?is_apps}}
   <li> pointer lock
     (<a href="http://www.html5rocks.com/en/tutorials/pointerlock/intro/">tutorial</a>)
     <ul>
       <li>In Chrome Apps, pointer lock is entered without
         requiring a user gesture,

[benwells, 2014/11/20 23:21:00]

Could we also update this to mention the pointer lock permission?

[scheib, 2014/11/20 23:32:38]

Done.

         prompting the user, or providing exit instructions.
         Also, there is no default exit behavior. In normal webpages,
         the browser intercepts the ESC key to exit pointer lock.
         This behavior is not present in Chrome Apps.</li>
     </ul>
   </li>
 {{/is_apps}}
   <li> video
     (<a href="http://www.html5rocks.com/en/tutorials/video/basics/">tutorial</a>) </li>
   <li> web database
@@ skipping 26 matching lines @@
 <dt><strong> V8 APIs</strong>, such as<strong> JSON </strong></dt>
 <dd> Because JSON is in V8, you don't need to include a JSON library to use JSON functions. </dd>
 <dt><strong>APIs in bundled libraries</strong></dt>
 <dd> If you want to use a library that the browser doesn't provide
 (for example, jQuery),
 you can bundle that library's JavaScript files with your extension.
 Bundled libraries work in extensions
 just as they do in other web pages.
 </dd>
 </dl>