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..7edc05a7bb31099e9c09e034ad41bf62246bf24e 100644
--- a/chrome/common/extensions/api/tab_capture.idl
+++ b/chrome/common/extensions/api/tab_capture.idl
@@ -47,7 +47,10 @@ 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
+    // of this method for the currently active tab must also first be "granted"

[not at google - send to devlin, 2013/04/18 18:29:21]

must also first be -> can only be

"granted" -> granted

user action of clicking on the extension icon -> user action

and then link to the activeTab docs :)

[mark a. foltz, 2013/04/18 18:30:05]

Might say:

Use of this method requires that the user first grants permission for the active
tab by clicking on the extension's browser action.

Question:
Is the same permission granted by clicking on a page action?
 

[not at google - send to devlin, 2013/04/18 18:31:36]

Yes - and several other user actions.

[mark a. foltz, 2013/04/18 18:33:23]

Okay, then might say "clicking on the extension" or some other generic phrase in
the suggestion above.

[justinlin, 2013/04/18 20:10:00]

Done. Yea, that sounds better.

[justinlin, 2013/04/18 20:10:00]

Just "granted through a user action" like Ben suggested?

+    // through a user action of clicking on the extension icon. 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,