From 91303f2f046164d743d1284887e573e1a7e4906f Mon Sep 17 00:00:00 2001
From: "kathyw@chromium.org"
 <kathyw@chromium.org@0039d316-1c4b-4281-b951-d872f2087c98>
Date: Mon, 28 Feb 2011 22:12:45 +0000
Subject: Add info about "background" permission (new for M10).

BUG=none
TEST=none

Review URL: http://codereview.chromium.org/6574028

git-svn-id: svn://svn.chromium.org/chrome/trunk/src@76274 0039d316-1c4b-4281-b951-d872f2087c98
---
 .../common/extensions/docs/background_pages.html   |  8 ++++++
 chrome/common/extensions/docs/manifest.html        | 33 +++++++++++++++++++++-
 .../extensions/docs/static/background_pages.html   |  8 ++++++
 chrome/common/extensions/docs/static/manifest.html | 33 +++++++++++++++++++++-
 4 files changed, 80 insertions(+), 2 deletions(-)

diff --git a/chrome/common/extensions/docs/background_pages.html b/chrome/common/extensions/docs/background_pages.html
index 2516499..3df0cc7 100644
--- a/chrome/common/extensions/docs/background_pages.html
+++ b/chrome/common/extensions/docs/background_pages.html
@@ -369,6 +369,14 @@ like this:
   ...
 }</pre>
 
+<p>
+If you need the browser to start up early—so
+you can display notifications, for example—then
+you might also want to specify the
+<a href="manifest.html#permissions">"background" permission</a>.
+</p>
+
+
 <a name="H2-1"></a><h2>Details</h2>
 
 <p>
diff --git a/chrome/common/extensions/docs/manifest.html b/chrome/common/extensions/docs/manifest.html
index 73f24dc..8fb20a8 100644
--- a/chrome/common/extensions/docs/manifest.html
+++ b/chrome/common/extensions/docs/manifest.html
@@ -635,7 +635,7 @@ or packaged app can use.
 <p class="note">
 <strong>Note:</strong>
 Hosted apps can use the
-"geolocation", "notifications", and "unlimitedStorage" permissions,
+"background", "geolocation", "notifications", and "unlimitedStorage" permissions,
 but not any other permissions listed in this table.
 </p>
 
@@ -657,6 +657,37 @@ but not any other permissions listed in this table.
   </td>
 </tr>
 <tr>
+  <td> "background" </td>
+  <td> <p>
+       Makes Chrome start up early and and shut down late,
+       so that apps and extensions can have a longer life.
+       </p>
+
+       <p>
+       When any installed hosted app, packaged app, or extension
+       has "background" permission, Chrome runs (invisibly)
+       as soon as the user logs into their computer—before
+       the user launches Chrome.
+       The "background" permission also makes Chrome continue running
+       (even after its last window is closed)
+       until the user explicitly quits Chrome.
+       </p>
+
+       <p class="note">
+       <b>Note:</b>
+       Disabled apps and extensions
+       are treated as if they aren't installed.
+       </p>
+
+       <p>
+       You typically use the "background" permission with a
+       <a href="background_pages.html">background page</a>
+       or (for hosted apps) a
+       <a href="http://code.google.com/chrome/apps/docs/background.html">background window</a>.
+       </p>
+       </td>
+</tr>
+<tr>
   <td> "bookmarks" </td>
   <td> Required if the extension uses the
        <a href="bookmarks.html">chrome.bookmarks</a> module. </td>
diff --git a/chrome/common/extensions/docs/static/background_pages.html b/chrome/common/extensions/docs/static/background_pages.html
index 2fd8a837..f4689be 100644
--- a/chrome/common/extensions/docs/static/background_pages.html
+++ b/chrome/common/extensions/docs/static/background_pages.html
@@ -41,6 +41,14 @@ like this:
   ...
 }</pre>
 
+<p>
+If you need the browser to start up early&mdash;so
+you can display notifications, for example&mdash;then
+you might also want to specify the
+<a href="manifest.html#permissions">"background" permission</a>.
+</p>
+
+
 <h2>Details</h2>
 
 <p>
diff --git a/chrome/common/extensions/docs/static/manifest.html b/chrome/common/extensions/docs/static/manifest.html
index aed4953..cb2cf6b 100644
--- a/chrome/common/extensions/docs/static/manifest.html
+++ b/chrome/common/extensions/docs/static/manifest.html
@@ -297,7 +297,7 @@ or packaged app can use.
 <p class="note">
 <strong>Note:</strong>
 Hosted apps can use the
-"geolocation", "notifications", and "unlimitedStorage" permissions,
+"background", "geolocation", "notifications", and "unlimitedStorage" permissions,
 but not any other permissions listed in this table.
 </p>
 
@@ -319,6 +319,37 @@ but not any other permissions listed in this table.
   </td>
 </tr>
 <tr>
+  <td> "background" </td>
+  <td> <p>
+       Makes Chrome start up early and and shut down late,
+       so that apps and extensions can have a longer life.
+       </p>
+
+       <p>
+       When any installed hosted app, packaged app, or extension
+       has "background" permission, Chrome runs (invisibly)
+       as soon as the user logs into their computer&mdash;before
+       the user launches Chrome.
+       The "background" permission also makes Chrome continue running
+       (even after its last window is closed)
+       until the user explicitly quits Chrome.
+       </p>
+
+       <p class="note">
+       <b>Note:</b>
+       Disabled apps and extensions
+       are treated as if they aren't installed.
+       </p>
+
+       <p>
+       You typically use the "background" permission with a
+       <a href="background_pages.html">background page</a>
+       or (for hosted apps) a
+       <a href="http://code.google.com/chrome/apps/docs/background.html">background window</a>.
+       </p>
+       </td>
+</tr>
+<tr>
   <td> "bookmarks" </td>
   <td> Required if the extension uses the
        <a href="bookmarks.html">chrome.bookmarks</a> module. </td>
-- 
cgit v1.1