Adding static documentation to the speech input extension API.

chrome/common/extensions/docs/samples.json

 {
   "api": {
     "chrome.bookmarks.create": "bookmarks.html#method-create",
     "chrome.bookmarks.export": "bookmarks.html#method-export",
     "chrome.bookmarks.get": "bookmarks.html#method-get",
     "chrome.bookmarks.getChildren": "bookmarks.html#method-getChildren",
     "chrome.bookmarks.getRecent": "bookmarks.html#method-getRecent",
     "chrome.bookmarks.getSubTree": "bookmarks.html#method-getSubTree",
     "chrome.bookmarks.getTree": "bookmarks.html#method-getTree",
     "chrome.bookmarks.import": "bookmarks.html#method-import",
@@ skipping 2077 matching lines @@
         "options.html",
         "options.js",
         "tabs.js"
       ],
       "source_hash": "cb605c7bc53d81fe9504c871f475b09e9987df4a",
       "zip_path": "examples\/extensions\/speak_selection.zip"
     },
     {
       "api_calls": [
         "chrome.browserAction.onClicked",
+        "chrome.experimental.speechInput.isRecording",
+        "chrome.experimental.speechInput.onError",
+        "chrome.experimental.speechInput.onResult",
+        "chrome.experimental.speechInput.start",
+        "chrome.experimental.speechInput.stop"
+      ],
+      "crx_path": null,
+      "description": "Recognizes your speech and tells you the most likely result.",
+      "features": [
+        "background_page",
+        "browser_action",
+        "experimental"
+      ],
+      "icon": null,

[Satish, 2011/11/17 16:29:23]

should point this to a valid icon file name? the other entries above and below
seem to do it.

[Leandro Graciá Gil, 2011/11/17 22:02:45]

I don't recall changing this file. This is probably autogenerated.
In any case it looks like only the examples providing custom icons have
something non-null here. Since we don't have any custom icon in mind and there
are many other cases like this in the file I think it would be simpler to leave
it as it is.

+      "id": "a942b7626644674b7a56678930d054497b244ee7",
+      "name": "Speech recognizer",

[Satish, 2011/11/17 16:29:23]

capitalise the first letter of all words in the name.. same in the manifest.json
file

[Leandro Graciá Gil, 2011/11/17 22:02:45]

Done.

+      "packaged_app": false,
+      "path": "examples\/api\/speechInput\/basic\/",
+      "protocols": [],
+      "search_string": "SPEECH RECOGNIZER RECOGNIZES YOUR SPEECH AND TELLS YOU THE MOST LIKELY RESULT. BACKGROUND_PAGE BROWSER_ACTION EXPERIMENTAL CHROME.BROWSERACTION.ONCLICKED CHROME.EXPERIMENTAL.SPEECHINPUT.ISRECORDING CHROME.EXPERIMENTAL.SPEECHINPUT.ONERROR CHROME.EXPERIMENTAL.SPEECHINPUT.ONRESULT CHROME.EXPERIMENTAL.SPEECHINPUT.START CHROME.EXPERIMENTAL.SPEECHINPUT.STOP",
+      "source_files": [
+        "background.html",
+        "manifest.json"
+      ],
+      "source_hash": "a1db5394eb501dc0d23f584efcdc4f22e5155a4b",
+      "zip_path": "examples\/api\/speechInput\/basic.zip"
+    },
+    {
+      "api_calls": [
+        "chrome.browserAction.onClicked",
         "chrome.extension.getURL",
         "chrome.tabs.create",
         "chrome.tabs.get",
         "chrome.tabs.getAllInWindow",
         "chrome.tabs.getSelected",
         "chrome.tabs.move",
         "chrome.tabs.onAttached",
         "chrome.tabs.onCreated",
         "chrome.tabs.onDetached",
         "chrome.tabs.onMoved",
@@ skipping 286 matching lines @@
         "manifest.json",
         "popup.html",
         "popup.js",
         "sample.css"
       ],
       "source_hash": "62ca453d8d1551ff63dd7c78b49d546bc3af17c6",
       "zip_path": "examples\/api\/extension\/isAllowedAccess.zip"
     }
   ]
 }