Documentation updates for chrome.tabCapture.

chrome/common/extensions/api/tab_capture.idl

 // Copyright (c) 2012 The Chromium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
 // Use the <code>chrome.tabCapture</code> API to interact with tab media
 // streams.
 namespace tabCapture {
 
   enum TabCaptureState {
     pending,
@@ skipping 29 matching lines @@
     MediaStreamConstraint? audioConstraints;
     MediaStreamConstraint? videoConstraints;
   };
 
   callback GetTabMediaCallback =
       void ([instanceOf=LocalMediaStream] object stream);
 
   callback GetCapturedTabsCallback = void (CaptureInfo[] result);
 
   interface Functions {
-    // Captures the visible area of the currently active tab.
-    // This method can only be used on the currently active page after the
-    // extension has been <em>invoked</em>, similar to the way that
-    // <a href="activeTab.html">activeTab</a> works.
+    // Captures the visible area of the currently active tab.  Capture can
+    // only be started on the currently active tab after the extension has been
+    // <em>invoked</em>.  Capture is maintained across page navigations within
+    // the tab, and stops when the tab is closed, or the media stream is closed
+    // by the extension.
+    //
     // |options| : Configures the returned media stream.
-    // |callback| : Callback with either the stream returned or null.
+    // |callback| : Callback with either the tab capture stream or
+    //   <code>null</code>.
     static void capture(CaptureOptions options,
                         GetTabMediaCallback callback);
 
     // Returns a list of tabs that have requested capture or are being
     // captured, i.e. status != stopped and status != error.
     // This allows extensions to inform the user that there is an existing
     // tab capture that would prevent a new tab capture from succeeding (or
     // to prevent redundant requests for the same tab).
+    // |callback| : Callback invoked with CaptureInfo[] for captured tabs.
     static void getCapturedTabs(GetCapturedTabsCallback callback);
   };
 
   interface Events {
     // Event fired when the capture status of a tab changes.
     // This allows extension authors to keep track of the capture status of
     // tabs to keep UI elements like page actions and infobars in sync.
+    // |info| : CaptureInfo with new capture status for the tab.
     static void onStatusChanged(CaptureInfo info);
   };
 
 };