Update tabCapture API docs with browser action info.

chrome/common/extensions/api/tab_capture.idl

Index: chrome/common/extensions/api/tab_capture.idl
diff --git a/chrome/common/extensions/api/tab_capture.idl b/chrome/common/extensions/api/tab_capture.idl
index cfca548cc1372f8cfa219e87ad67a4d982f72c31..7d94369162f0d138f6e72ea2fb0d3466a29625fd 100644
--- a/chrome/common/extensions/api/tab_capture.idl
+++ b/chrome/common/extensions/api/tab_capture.idl
@@ -47,7 +47,11 @@ namespace tabCapture {
 
   interface Functions {
     // Captures the visible area of the currently active tab.
-    // Extensions must have the "tabCapture" permission to use this method.
+    // Extensions must have the "tabCapture" permission to use this method. Use

[not at google - send to devlin, 2013/04/18 20:17:13]

nit: "extensions must have the tabCapture permission to use this method" is
implied by this being the tabCapture API. I'd just delete that sentence.

[justinlin, 2013/04/18 21:06:44]

Done.

+    // of this method for the currently active tab can only be granted
+    // through a user action. See:

[not at google - send to devlin, 2013/04/18 20:17:13]

"User action" isn't quite accurate; it might imply that the API calls can only
be made during a user action, when in fact they can be made at any time during
of after a user action.

Something like "This method can only be used on a page which the extension has
been invoked on, similar to the way that <a href="activeTab">activeTab</a>
works."

[justinlin, 2013/04/18 21:06:44]

Done, something similar.

+    // http://developer.chrome.com/extensions/activeTab.html

[not at google - send to devlin, 2013/04/18 20:17:13]

could you make this

<a href="activeTab.html">activeTab</a>

+    // Note that Chrome internal pages cannot be captured.
     // |options| : Configures the returned media stream.
     // |callback| : Callback with either the stream returned or null.
     static void capture(CaptureOptions options,