Document feature differences of Fullscreen and Pointer Lock in packaged apps vs open web.

BUG=181656


Review URL: https://chromiumcodereview.appspot.com/12637015

git-svn-id: svn://svn.chromium.org/chrome/trunk/src@188809 0039d316-1c4b-4281-b951-d872f2087c98

2 files changed, 33 insertions, 7 deletions

diff --git a/chrome/common/extensions/docs/templates/articles/api_other.html b/chrome/common/extensions/docs/templates/articles/api_other.html
index 5b5e5c9..326800c 100644
--- a/chrome/common/extensions/docs/templates/articles/api_other.html
+++ b/chrome/common/extensions/docs/templates/articles/api_other.html
@@ -40,12 +40,37 @@ E.g. window.open(someUrl). --></dd>
     (<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 packaged 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 packaged apps.</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 packaged apps, pointer lock is entered without
+        requiring a user gesture,
+        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 packaged apps.</li>
+    </ul>
+  </li>
+{{/is_apps}}
   <li> video
     (<a href="http://www.html5rocks.com/en/tutorials/video/basics/">tutorial</a>) </li>
   <li> web database
diff --git a/chrome/common/extensions/docs/templates/articles/declare_permissions.html b/chrome/common/extensions/docs/templates/articles/declare_permissions.html
index a556b83..2868969 100644
--- a/chrome/common/extensions/docs/templates/articles/declare_permissions.html
+++ b/chrome/common/extensions/docs/templates/articles/declare_permissions.html
@@ -195,9 +195,9 @@ table.
 {{?is_apps}}
 <tr>
   <td id="fullscreen"> "fullscreen" </td>
-  <td> Allows the app to use the proposed HTML5
-       <a href="https://dvcs.w3.org/hg/fullscreen/raw-file/tip/Overview.html">fullscreen API</a>
-       without prompting the user for permission.</td>
+  <td> Allows the app to use the
+       <a href="https://dvcs.w3.org/hg/fullscreen/raw-file/tip/Overview.html">fullscreen API</a>.
+       See <a href="api_other.html">Other APIs</a> for behavior differences.</td>
 </tr>
 {{/is_apps}}
 <tr>
@@ -238,10 +238,11 @@ table.
 <tr>
   <td> "pointerLock" </td>
   <td> Required to use
-    <a href="http://www.w3.org/TR/pointerlock/">Pointer Lock</a> via calls to
-    <code>webkitRequestPointerLock</code> or Pepper's
-    <a href="https://developers.google.com/native-client/peppercpp/classpp_1_1_mouse_lock">
-    Mouse Lock API</a>. </td>
+       <a href="http://www.w3.org/TR/pointerlock/">Pointer Lock</a> via calls to
+       <code>webkitRequestPointerLock</code> or Pepper's
+       <a href="https://developers.google.com/native-client/peppercpp/classpp_1_1_mouse_lock">
+       Mouse Lock API</a>.
+       See <a href="api_other.html">Other APIs</a> for behavior differences.</td></td>
 </tr>
 {{/is_apps}}
 {{^is_apps}}