chrome/common/extensions/docs/permission_warnings.html - Issue 10642015: Basic setup for generating app docs

Side by Side Diff: chrome/common/extensions/docs/permission_warnings.html

Issue 10642015: Basic setup for generating app docs (Closed) Base URL: svn://svn.chromium.org/chrome/trunk/src

Patch Set: fix Created 8 years, 6 months ago

Use n/p to move between diff chunks; N/P to move between comments. Draft comments are only viewable by you.

Jump to:

View unified diff | Download patch | Annotate | Revision Log

« chrome/common/extensions/docs/js/api_page_generator.js ('K') | « chrome/common/extensions/docs/pageCapture.html ('k') | chrome/common/extensions/docs/permissions.html » ('j') | no next file with comments »
Toggle Intra-line Diffs ('i') | Expand Comments ('e') | Collapse Comments ('c') | Hide Comments ('s')

OLD	NEW
	(Empty)
1 <!DOCTYPE html><!-- This page is a placeholder for generated extensions api doc. Note:

2 1) The <head> information in this page is significant, should be uniform

3 across api docs and should be edited only with knowledge of the

4 templating mechanism.

5 3) All <body>.innerHTML is genereated as an rendering step. If viewed in a

6 browser, it will be re-generated from the template, json schema and

7 authored overview content.

8 4) The <body>.innerHTML is also generated by an offline step so that this

9 page may easily be indexed by search engines.

10 --><html xmlns="http://www.w3.org/1999/xhtml"><head>

11 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">

12 <link href="css/ApiRefStyles.css" rel="stylesheet" type="text/css">

13 <link href="css/print.css" rel="stylesheet" type="text/css" media="print">

14 <script type="text/javascript" src="../../../third_party/jstemplate/jstempla te_compiled.js">

15 </script>

16 <script type="text/javascript" src="../../../../third_party/json_minify/mini fy-sans-regexp.js">

17 </script>

18 <script type="text/javascript" src="js/api_page_generator.js"></script>

19 <script type="text/javascript" src="js/bootstrap.js"></script>

20 <script type="text/javascript" src="js/sidebar.js"></script>

21 <title>Permission Warnings - Google Chrome Extensions - Google Code</title></h ead>

22 <body> <div id="devModeWarning" class="displayModeWarning">

23 You are viewing extension docs in chrome via the 'file:' scheme: are you exp ecting to see local changes when you refresh? You'll need run chrome with --allo w-file-access-from-files.

24 </div>

25 <div id="branchWarning" class="displayModeWarning">

26 <span>WARNING: This is the <span id="branchName">BETA</span> documentation.

27 It may not work with the stable release of Chrome.</span>

28 <select id="branchChooser">

29 <option>Choose a different version...

30 </option><option value="">Stable

31 </option><option value="beta">Beta

32 </option><option value="dev">Dev

33 </option><option value="trunk">Trunk

34 </option></select>

35 </div>

36 <div id="unofficialWarning" class="displayModeWarning">

37 <span>WARNING: This is unofficial documentation. It may not work with the

38 current release of Chrome.</span>

39 <button id="goToOfficialDocs">Go to the official docs</button>

40 </div>

41 <div id="gc-container" class="labs">

42 <!-- SUBTEMPLATES: DO NOT MOVE FROM THIS LOCATION -->

43 <!-- In particular, sub-templates that recurse, must be used by allowing

44 jstemplate to make a copy of the template in this section which

45 are not operated on by way of the jsskip="true" -->

46 <!-- /SUBTEMPLATES -->

47 <a id="top"></a>

48 <div id="skipto">

49 <a href="#gc-pagecontent">Skip to page content</a>

50 <a href="#gc-toc">Skip to main navigation</a>

51 </div>

52 <!-- API HEADER -->

53 <table id="header" width="100%" cellspacing="0" border="0">

54 <tbody><tr>

55 <td valign="middle"><a href="http://code.google.com/"><img src="images/c ode_labs_logo.gif" height="43" width="161" alt="Google Code Labs" style="border: 0; margin:0;"></a></td>

56 <td valign="middle" width="100%" style="padding-left:0.6em;">

57 <form action="http://www.google.com/cse" id="cse" style="margin-top:0. 5em">

58 <div id="gsc-search-box">

59 <input type="hidden" name="cx" value="002967670403910741006:61_cvz fqtno">

60 <input type="hidden" name="ie" value="UTF-8">

61 <input type="text" name="q" value="" size="55">

62 <input class="gsc-search-button" type="submit" name="sa" value="Se arch">

63 <br>

64 <span class="greytext">e.g. "page action" or "tabs"</span>

65 </div>

66 </form>

67 <script type="text/javascript" src="https://www.google.com/jsapi"></sc ript>

68 <script type="text/javascript">google.load("elements", "1", {packages: "transliteration"});</script>

69 <script type="text/javascript" src="https://www.google.com/coop/cse/t1 3n?form=cse&t13n_langs=en"></script>

70 <script type="text/javascript" src="https://www.google.com/coop/cse/br and?form=cse&lang=en"></script>

71 </td>

72 </tr>

73 </tbody></table>

74 <div id="codesiteContent" class="">

75 <a id="gc-topnav-anchor"></a>

76 <div id="gc-topnav">

77 <h1>Google Chrome Extensions (<a href="http://code.google.com/labs/">Lab s</a>)</h1>

78 <ul id="home" class="gc-topnav-tabs">

79 <li id="home_link">

80 <a href="index.html" title="Google Chrome Extensions home page">Home </a>

81 </li>

82 <li id="docs_link">

83 <a href="docs.html" title="Official Google Chrome Extensions documen tation">Docs</a>

84 </li>

85 <li id="faq_link">

86 <a href="faq.html" title="Answers to frequently asked questions abou t Google Chrome Extensions">FAQ</a>

87 </li>

88 <li id="samples_link">

89 <a href="samples.html" title="Sample extensions (with source code)"> Samples</a>

90 </li>

91 <li id="group_link">

92 <a href="http://groups.google.com/a/chromium.org/group/chromium-exte nsions" title="Google Chrome Extensions developer forum">Group</a>

93 </li>

94 <li id="so_link">

95 <a href="http://stackoverflow.com/questions/tagged/google-chrome-ext ension" title="[google-chrome-extension] tag on Stack Overflow">Questions?</a>

96 </li>

97 </ul>

98 </div> <!-- end gc-topnav -->

99 <div class="g-section g-tpl-170">

100 <!-- SIDENAV -->

101 <div class="g-unit g-first" id="gc-toc">

102 <ul>

103 <li><a href="getstarted.html">Getting Started</a></li>

104 <li><a href="overview.html">Overview</a></li>

105 <li><a href="whats_new.html">What's New?</a></li>

106 <li><h2><a href="devguide.html">Developer's Guide</a></h2>

107 <ul>

108 <li>Browser UI

109 <ul>

110 <li><a href="browserAction.html">Browser Actions</a></li>

111 <li><a href="contextMenus.html">Context Menus</a></li>

112 <li><a href="notifications.html">Desktop Notifications</a></li >

113 <li><a href="omnibox.html">Omnibox</a></li>

114 <li><a href="options.html">Options Pages</a></li>

115 <li><a href="override.html">Override Pages</a></li>

116 <li><a href="pageAction.html">Page Actions</a></li>

117 </ul>

118 </li>

119 <li>Browser Interaction

120 <ul>

121 <li><a href="bookmarks.html">Bookmarks</a></li>

122 <li><a href="cookies.html">Cookies</a></li>

123 <li><a href="devtools.html">Developer Tools</a></li>

124 <li><a href="events.html">Events</a></li>

125 <li><a href="history.html">History</a></li>

126 <li><a href="management.html">Management</a></li>

127 <li><a href="tabs.html">Tabs</a></li>

128 <li><a href="windows.html">Windows</a></li>

129 </ul>

130 </li>

131 <li>Implementation

132 <ul>

133 <li><a href="a11y.html">Accessibility</a></li>

134 <li><a href="background_pages.html">Background Pages</a></li>

135 <li><a href="content_scripts.html">Content Scripts</a></li>

136 <li><a href="xhr.html">Cross-Origin XHR</a></li>

137 <li><a href="i18n.html">Internationalization</a></li>

138 <li><a href="messaging.html">Message Passing</a></li>

139 <li><a href="permissions.html">Optional Permissions</a></li>

140 <li><a href="npapi.html">NPAPI Plugins</a></li>

141 </ul>

142 </li>

143 <li>Finishing

144 <ul>

145 <li><a href="hosting.html">Hosting</a></li>

146 <li><a href="external_extensions.html">Other Deployment Option s</a></li>

147 </ul>

148 </li>

149 </ul>

150 </li>

151 <li><h2><a href="apps.html">Packaged Apps</a></h2></li>

152 <li><h2><a href="tutorials.html">Tutorials</a></h2>

153 <ul>

154 <li><a href="tut_debugging.html">Debugging</a></li>

155 <li><a href="tut_analytics.html">Google Analytics</a></li>

156 <li><a href="tut_oauth.html">OAuth</a></li>

157 </ul>

158 </li>

159 <li><h2>Reference</h2>

160 <ul>

161 <li>Formats

162 <ul>

163 <li><a href="manifest.html">Manifest Files</a></li>

164 <li><a href="match_patterns.html">Match Patterns</a></li>

165 </ul>

166 </li>

167 <li class="leftNavSelected">Permission Warnings</li>

168 <li><a href="api_index.html">chrome.* APIs</a></li>

169 <li><a href="api_other.html">Other APIs</a></li>

170 </ul>

171 </li>

172 <li><h2><a href="samples.html">Samples</a></h2></li>

173 <div class="line"> </div>

174 <li><h2>More</h2>

175 <ul>

176 <li><a href="http://code.google.com/chrome/webstore/docs/index.htm l">Chrome Web Store</a></li>

177 <li><a href="http://code.google.com/chrome/apps/docs/developers_gu ide.html">Hosted Apps</a></li>

178 <li><a href="themes.html">Themes</a></li>

179 </ul>

180 </li>

181 </ul>

182 </div>

183 <script>

184 initToggles();

185 </script>

186 <div class="g-unit" id="gc-pagecontent">

187 <div id="pageTitle">

188 <h1 class="page_title">Permission Warnings</h1>

189 </div>

190 <!-- TABLE OF CONTENTS -->

191 <div id="toc">

192 <h2>Contents</h2>

193 <ol>

194 <li>

195 <a href="#examples"> Examples of permission warnings </a>

196 <ol>

197 </ol>

198 </li><li>

199 <a href="#warnings"> Warnings and their triggers </a>

200 <ol>

201 </ol>

202 </li><li>

203 <a href="#nowarning"> Permissions that don't cause warnings </a>

204 <ol>

205 </ol>

206 </li><li>

207 <a href="#test"> Testing permission warnings </a>

208 <ol>

209 </ol>

210 </li><li>

211 <a href="#api">API</a>

212 <ol>

213 </ol>

214 </li>

215 </ol>

216 </div>

217 <!-- /TABLE OF CONTENTS -->

218 <!-- Standard content lead-in for experimental API pages -->

219 <!-- STATIC CONTENT PLACEHOLDER -->

220 <div id="static"><div id="pageData-name" class="pageData">Permission War nings</div>

221 <div id="pageData-showTOC" class="pageData">true</div>

222 <!--

223 NOTE: When this doc is updated, the online help should also be updated:

224 http://www.google.com/support/chrome_webstore/bin/answer.py?hl=en&answer=186213

225 We should periodically look at

226 http://src.chromium.org/viewvc/chrome/trunk/src/chrome/app/generated_resources.g rd?view=markup

227 to make sure that we're covering all messages. Search for

228 IDS_EXTENSION_PROMPT_WARNING

229 (e.g. IDS_EXTENSION_PROMPT_WARNING_BROWSING_HISTORY).

230 -->

231 <p>

232 To use most chrome.* APIs and extension capabilities,

233 your extension must declare its intent in the

234 <a href="manifest.html">manifest</a>,

235 often in the "permissions" field.

236 Some of these declarations

237 result in a warning when

238 a user installs your extension.

239 </p>

240 <p>

241 When you autoupdate your extension,

242 the user might see another warning

243 if the extension requests new permissions.

244 These new permissions might be new APIs that your extension uses,

245 or they might be new websites

246 that your extension needs access to.

247 </p>

248 <h2 id="examples"> Examples of permission warnings </h2>

249 <p>

250 Here's a typical dialog

251 that a user might see when installing an extension:

252 </p>

253 <img src="images/perms-hw1.png" width="410" height="193" alt="Permission warning : 'It can: Access your data on api.flickr.com'">

254 <p>

255 The warning about access to data on api.flickr.com

256 is caused by the following lines

257 in the extension's manifest:

258 </p>

259 <pre>"permissions": [

260 <b>"http://api.flickr.com/"</b>

261 ],

262 </pre>

263 <p class="note">

264 <b>Note:</b>

265 You don't see permission warnings when

266 you load an unpacked extension.

267 You get permission warnings only when you install an extension

268 from a <code>.crx</code> file.

269 </p>

270 <p>

271 If you add a permission to the extension when you autoupdate it,

272 the user might see a new permission warning.

273 For example,

274 assume you add a new site and the "tabs" permission

275 to the previous example:

276 </p>

277 <pre>"permissions": [

278 "http://api.flickr.com/",

279 <b>"http://*.flickr.com/",

280 "tabs"</b>

281 ],

282 </pre>

283 <p>

284 When the extension autoupdates,

285 the increased permissions

286 cause the extension to be disabled

287 until the user re-enables it.

288 Here's the warning the user sees:

289 </p>

290 <img src="images/perms-hw2-disabled.png" width="814" height="30" alt="Warning te xt: 'The newest version of the extension Hello World requires more permissions, so it has been disabled. [Re-enable].'">

291 <p>

292 Clicking the Re-enable button

293 brings up the following warning:

294 </p>

295 <img src="images/perms-hw2.png" width="412" height="220" alt="Permission warning : 'It can: Access your data on api.flickr.com and flickr.com; Read and modify yo ur browsing history'">

296 <h2 id="warnings"> Warnings and their triggers </h2>

297 <p>

298 It can be surprising when adding a permission such as "tabs"

299 results in the seemingly unrelated warning

300 that the extension can access your browsing activity.

301 The reason for the warning is that

302 although the <code>chrome.tabs</code> API

303 might be used only to open new tabs,

304 it can also be used to see the URL that's associated

305 with every newly opened tab

306 (using their <a href="tabs.html#type-Tab">Tab</a> objects).

307 </p>

308 <p class="note">

309 <b>Note:</b>

310 As of Google Chrome 7,

311 you no longer need to specify the "tabs" permission

312 just to call <code>chrome.tabs.create()</code>

313 or <code>chrome.tabs.update()</code>.

314 </p>

315 <p>

316 The following table lists the warning messages

317 that users can see,

318 along with the manifest entries

319 that trigger them.

320 </p>

321 <p>

322 </p><table>

323 <tbody><tr>

324 <th>Warning message</th> <th>Manifest entry that causes&nb sp;it</th> <th>Notes</th>

325 </tr>

326 <tr>

327 <td style="font-weight:bold">

328 <!-- IDS_EXTENSION_PROMPT_WARNING_FULL_ACCESS -->

329 Access all data on your computer and the websites you visit

330 </td>

331 <td>

332 "plugins"

333 </td>

334 <td>

335 The "plugins" permission is required by

336 <a href="npapi.html">NPAPI plugins</a>.

337 </td>

338 </tr>

339 <tr>

340 <td style="font-weight:bold">

341 <!-- IDS_EXTENSION_PROMPT_WARNING_BOOKMARKS -->

342 Read and modify your bookmarks

343 </td>

344 <td>

345 "bookmarks" permission

346 </td>

347 <td>

348 The "bookmarks" permission is required by the

349 <a href="bookmarks.html"><code>chrome.bookmarks</code></a> module.

350 </td>

351 </tr>

352 <tr>

353 <td style="font-weight:bold">

354 <!-- IDS_EXTENSION_PROMPT_WARNING_BROWSING_HISTORY -->

355 Read and modify your browsing history

356 </td>

357 <td>

358 <!-- HasEffectiveBrowsingHistoryPermission -->

359 "history" permission

360 </td>

361 <td>

362 <p>

363 The "history" permission is required by

364 <a href="history.html"><code>chrome.history</code></a>.

365 </p>

366 </td>

367 </tr>

368 <tr>

369 <td style="font-weight:bold">

370 <!-- IDS_EXTENSION_PROMPT_WARNING_TABS -->

371 Access your tabs and browsing activity

372 </td>

373 <td>

374 <!-- HasEffectiveBrowsingHistoryPermission -->

375 Any of the following:

376 <ul>

377 <li> "tabs" permission </li>

378 <li> "webNavigation" permission </li>

379 </ul>

380 </td>

381 <td>

382 <p>

383 The "tabs" permission is required by the

384 <a href="tabs.html"><code>chrome.tabs</code></a> and

385 <a href="windows.html"><code>chrome.windows</code></a> modules.

386 </p>

387 <p>

388 The "webNavigation" permission is required by the

389 <a href="webNavigation.html"><code>chrome.webNavigation</code></a> module.

390 </p>

391 </td>

392 </tr>

393 <tr>

394 <td style="font-weight:bold">

395 <!-- IDS_EXTENSION_PROMPT_WARNING_CONTENT_SETTINGS -->

396 Manipulate settings that specify whether websites can use features such as c ookies, JavaScript, and plug-ins

397 </td>

398 <td>

399 <!-- HasEffectiveBrowsingHistoryPermission -->

400 "contentSettings" permission

401 </td>

402 <td>

403 <p>

404 The "contentSettings" permission is required by

405 <a href="contentSettings.html"><code>chrome.contentSettings</code></a>.

406 </p>

407 </td>

408 </tr>

409 <tr>

410 <td style="font-weight:bold">

411 <!-- IDS_EXTENSION_PROMPT_WARNING_ALL_HOSTS -->

412 Access your data on all websites

413 </td>

414 <td>

415 <!-- HasEffectiveAccessToAllHosts() -->

416 Any of the following:

417 <ul>

418 <li> "debugger" permission </li>

419 <li> "proxy" permission </li>

420 <li> A match pattern in the "permissions" field

421 that matches all hosts </li>

422 <li> A "content_scripts" field with a "matches" entry

423 that matches all hosts </li>

424 <li> "devtools_page" </li>

425 </ul>

426 </td>

427 <td>

428 <p>

429 The "debugger" permission is required by the experimental

430 <a href="experimental.debugger.html">debugger</a> module.

431 </p>

432 <p>

433 The "proxy" permission is required by the

434 <a href="proxy.html"><code>chrome.proxy</code></a> module.

435 </p>

436 <p>

437 Any of the following URLs match all hosts:

438 </p>

439 <ul>

440 <li> <code>http:///</code> </li>

441 <li> <code>https:///</code> </li>

442 <li> <code>:///*</code> </li>

443 <li> <code><all_urls></code> </li>

444 </ul>

445 </td>

446 </tr>

447 <tr>

448 <td style="font-weight:bold">

449 <!-- IDS_EXTENSION_PROMPT_WARNING_?_HOST -->

450 <!-- IDS_EXTENSION_PROMPT_WARNING_4_OR_MORE_HOSTS -->

451 Access your data on <em>{list of websites}</em>

452 </td>

453 <td>

454 A match pattern in the "permissions" field

455 that specifies one or more hosts,

456 but not all hosts

457 </td>

458 <td>

459 <p>

460 Up to 3 sites are listed by name.

461 Subdomains aren't treated specially.

462 For example, <code>a.com</code> and <code>b.a.com</code>

463 are listed as different sites.

464 </p>

465 <p>

466 On autoupdate,

467 the user sees a permission warning

468 if the extension adds or changes sites.

469 For example, going from <code>a.com,b.com</code>

470 to <code>a.com,b.com,c.com</code>

471 triggers a warning.

472 Going from <code>b.a.com</code>

473 to <code>a.com</code>,

474 or vice versa,

475 also triggers a warning.

476 </p>

477 </td>

478 </tr>

479 <tr>

480 <td style="font-weight:bold">

481 <!-- IDS_EXTENSION_PROMPT_WARNING_ALL_PAGES_CONTENT -->

482 Access the content of pages you visit

483 </td>

484 <td>

485 "pageCapture" permission

486 </td>

487 <td>

488 The "pageCapture" permission is required by the

489 <a href="pageCapture.html"><code>chrome.pageCapture</code></a> module.

490 </td>

491 </tr>

492 <tr>

493 <td style="font-weight:bold">

494 <!-- IDS_EXTENSION_PROMPT_WARNING_MANAGEMENT -->

495 Manage your apps, extensions, and themes

496 </td>

497 <td>

498 "management" permission

499 </td>

500 <td>

501 The "management" permission is required by the

502 <a href="management.html"><code>chrome.management</code></a> module.

503 </td>

504 </tr>

505 <tr>

506 <td style="font-weight:bold">

507 <!-- IDS_EXTENSION_PROMPT_WARNING_GEOLOCATION -->

508 Detect your physical location

509 </td>

510 <td>

511 "geolocation" permission

512 </td>

513 <td>

514 Allows the extension to use the proposed HTML5

515 <a href="http://dev.w3.org/geo/api/spec-source.html">geolocation API</a>

516 without prompting the user for permission.

517 </td>

518 </tr>

519 <tr>

520 <td style="font-weight:bold">

521 <!-- IDS_EXTENSION_PROMPT_WARNING_CLIPBOARD-->

522 Access data you copy and paste

523 </td>

524 <td>

525 "clipboardRead" permission

526 </td>

527 <td>

528 Allows the extension to use the following editing commands with

529 <code>document.execCommand()</code>:

530 <ul>

531 <li> <code>"copy"</code> </li>

532 <li> <code>"cut"</code> </li>

533 </ul>

534 </td>

535 </tr>

536 <tr>

537 <td style="font-weight:bold">

538 <!-- IDS_EXTENSION_PROMPT_WARNING_PRIVACY-->

539 Manipulate privacy-related settings

540 </td>

541 <td>

542 "privacy" permission

543 </td>

544 <td>

545 The "privacy" permission is required by the

546 <a href="privacy.html"><code>chrome.privacy</code></a> module.

547 </td>

548 </tr>

549 <tr>

550 <td style="font-weight:bold">

551 <!-- IDS_EXTENSION_PROMPT_WARNING_TTS_ENGINE-->

552 Access all text spoken using synthesized speech

553 </td>

554 <td>

555 "ttsEngine" permission

556 </td>

557 <td>

558 The "ttsEngine" permission is required by the

559 <a href="ttsEngine.html"><code>chrome.ttsEngine</code></a> module.

560 </td>

561 </tr>

562 </tbody></table>

563 <p></p>

564 <h2 id="nowarning"> Permissions that don't cause warnings </h2>

565 <p>

566 The following permissions don't result in a warning:

567 </p>

568 <ul>

569 <li>"browsingData"</li>

570 <li>"chrome://favicon/"</li>

571 <li>"clipboardWrite"</li>

572 <li>"contextMenus"</li>

573 <li>"cookies"</li>

574 <li>"experimental"</li>

575 <li>"idle"</li>

576 <li>"notifications"</li>

577 <li>"storage"</li>

578 <li>"unlimitedStorage"</li>

579 <li>"webRequest"</li>

580 <li>"webRequestBlocking"</li>

581 </ul>

582 <h2 id="test"> Testing permission warnings </h2>

583 <p>

584 If you'd like to see exactly which warnings your users will get,

585 <a href="packaging.html">package your extension</a>

586 into a <code>.crx</code> file,

587 and install it.

588 </p>

589 <p>

590 To see the warnings users will get when your extension is autoupdated,

591 you can go to a little more trouble

592 and set up an autoupdate server.

593 To do this, first create an update manifest

594 and point to it from your extension,

595 using the "update_url" key

596 (see <a href="autoupdate.html">Autoupdating</a>).

597 Next, <a href="packaging.html">package the extension</a>

598 into a new <code>.crx</code> file,

599 and install the app from this <code>.crx</code> file.

600 Now, change the extension's manifest to contain the new permissions,

601 and <a href="packaging.html#update">repackage the extension</a>.

602 Finally, update the extension

603 (and all other extensions that have outstanding updates)

604 by clicking the <b>chrome://extensions</b> page's

605 <b>Update extensions now</b> button.

606 </p>

607 <h2 id="api">API</h2>

608 <p>

609 You can get a list of permission warnings for any manifest with

610 <a href="management.html#method-getPermissionWarnings">chrome.management.getPerm issionWarnings()</a>.

611 </p>

612 </div>

613 <!-- API PAGE -->

614 <!-- /apiPage -->

615 </div> <!-- /gc-pagecontent -->

616 </div> <!-- /g-section -->

617 </div> <!-- /codesiteContent -->

618 <div id="gc-footer" --="">

619 <div class="text">

620 <p>

621 Except as otherwise <a href="http://code.google.com/policies.html#restrictions ">noted</a>,

622 the content of this page is licensed under the <a rel="license" href="http://c reativecommons.org/licenses/by/3.0/">Creative Commons

623 Attribution 3.0 License</a>, and code samples are licensed under the

624 <a rel="license" href="http://code.google.com/google_bsd_license.html">BSD Lic ense</a>.

625 </p>

626 <p>

627 ©2011 Google

628 </p>

629 <!-- begin analytics -->

630 <script src="https://www.google-analytics.com/urchin.js" type="text/javascript"> </script>

631 <script src="https://www.google-analytics.com/ga.js" type="text/javascript"></sc ript>

632 <script type="text/javascript">

633 // chrome doc tracking

634 try {

635 var engdocs = _gat._getTracker("YT-10763712-2");

636 engdocs._trackPageview();

637 } catch(err) {}

638 // code.google.com site-wide tracking

639 try {

640 _uacct="UA-18071-1";

641 _uanchor=1;

642 _uff=0;

643 urchinTracker();

644 }

645 catch(e) {/* urchinTracker not available. */}

646 </script>

647 <!-- end analytics -->

648 </div>

649 </div> <!-- /gc-footer -->

650 </div> <!-- /gc-container -->

651 </body></html>

OLD	NEW