Updating the doc to reflect the new experimental.keybinding API.

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

+<!-- BEGIN AUTHORED CONTENT -->
+<p>
+The keybinding API allows you to add keyboard shortcuts that trigger actions in
+your extension. An action can be opening the browser action or page action popup
+or sending a command to the extension.

[Mike West, 2012/02/24 14:24:24]

Can you add a link here to the experimental docs? It's a pretty standard piece
of boilerplate, just copy paste out of any other experimental API's docs.

[Finnur, 2012/02/24 15:09:16]

This is generated automatically when you build the docs.

+</p>
+
+<h2 id="manifest">Manifest</h2>
+
+<p>
+You must declare the "keybinding" permission in your extension's manifest
+to use this API. Also note that "pageAction" and "browserAction" are reserved

[Mike West, 2012/02/24 14:24:24]

I'd recommend separating this into two parts: `permission` and `commands`.

The first is (again) boilerplate that you can copy from any other experimental
permission. You'll also need to make it clear that authors currently require the
`experimental` permission.

The second is part of the API's usage, and probably deserves it's own section.

So something like:

---

# Permissions 

Blah blah blah.

  {  sample code blah }

# Usage

The keybinding API allows you to define specific commands, and bind them to to a
default key combination. Each command your extension accepts must be listed in
the manifest as an attribute of the `commands` manifest key. Blah blah blah.

{ sample code }

In your background page, you can bind a handler to each of these commands via
[`chrome.experimental.keybinding.onCommand.addListener`](link). For example:

{ sample code }

The `browserAction` and `pageAction` commands are reserved for the action of
opening/closing your extension's popups. They won't generate events that you can
handle. If you need to take action based on your popup opening, consider
listening for an `onDomReady` event inside your popup's code.

+commands, which, if specified, open the popup for the pageAction (if visible)
+and browserAction, respectively. All other commands are sent to the extension in
+the form of a javascript event.
+</p>
+
+<pre>{
+  "name": "My extension",
+  ...
+<b>  "commands": {
+    "toggle-feature-foo": {
+      "key": "Ctrl+Shift+Y",
+      "description": "Toggle feature foo"
+    },
+    "browserAction": {
+      "key": "Ctrl+Shift+B"

[Mike West, 2012/02/24 14:24:24]

Probably also worth mentioning that `Ctrl+Alt` isn't supported.

+    },
+    "pageAction": {
+      "key": "Alt+P"
+    }
+
+  }</b>,
+  ...
+<b>  "permissions": [
+    "keybinding",
+  ]</b>,
+  ...
+}</pre>
+
+<h2>Examples</h2>
+<p>The following example adds a handler for the onCommand event:
+</p>
+
+<pre>
+chrome.experimental.keybinding.onCommand.addListener(function(command) {
+  console.log('Command:', command);
+});
+</pre>
+<!-- END AUTHORED CONTENT -->