experimental.downloads extension api docs

chrome/common/extensions/docs/static/experimental.downloads.html

Index: chrome/common/extensions/docs/static/experimental.downloads.html
diff --git a/chrome/common/extensions/docs/static/experimental.downloads.html b/chrome/common/extensions/docs/static/experimental.downloads.html
new file mode 100644
index 0000000000000000000000000000000000000000..131a46b39d2ac9e80d30ea008a6da7271df0c42d
--- /dev/null
+++ b/chrome/common/extensions/docs/static/experimental.downloads.html
@@ -0,0 +1,30 @@
+<p>The downloads API allows you to programmatically initiate downloads. In the
+future, you will also be able to monitor and manipulate downloads.</p>
+
+<h2 id="manifest">Manifest</h2>
+
+<p>The downloads API is currently experimental, so you must declare the
+"experimental" permission to use it. Also, you must specify the hostname of any
+URLs to be downloaded. For example:</p>
+
+<pre>{
+  "name": "Download Selected Links",
+  "description": "Select links on a page and download them.",
+  "version": "0.1",
+  "permissions": [
+    "experimental", "http://*/*", "https://*/*"
+  ]}</pre>

[mkearney, 2012/03/13 17:51:51]

Very small comment to move } down a line. It looks a little better and makes it
a little easier for developers to copy/paste.

[benjhayden, 2012/03/13 18:16:13]

Done.

+
+<p>If the URL’s hostname is not specified in the permissions, then the
+chrome.extensions.lastError object will indicate that the extension does not
+have permission to access that hostname.
+<a href="#properties">downloads.ERROR_*</a> are some of the errors that may be
+returned.</p>
+
+<h2 id="examples"> Examples </h2>
+
+<p>You can find simple examples of using the downloads module in the
+<a href="http://src.chromium.org/viewvc/chrome/trunk/src/chrome/common/extensions/docs/examples/api/downloads/">examples/api/downloads</a>
+directory. For other examples and for help in viewing the source code, see
+<a href="samples.html">Samples</a>.</p>
+