Update media galleries documentation.

BUG=116025
NOTRY=TRUE

Review URL: https://chromiumcodereview.appspot.com/10832079

git-svn-id: svn://svn.chromium.org/chrome/trunk/src@149139 0039d316-1c4b-4281-b951-d872f2087c98

chrome/common/extensions/api/media_galleries.idl

@@ -17,8 +17,11 @@ namespace mediaGalleries {
   };
 
   [inline_doc] dictionary MediaFileSystemsDetails {
-    // Whether to prompt the user for additional media galleries before
-    // returning the permitted set. Default is silent.
+    // Whether to prompt the user for permission to additional media galleries
+    // before returning the permitted set. Default is silent.  If the value
+    // 'yes' is passed, or if the application has not been granted access to
+    // any media galleries and the value 'if_needed' is passed, then the
+    // media gallery configuration dialog will be displayed.
     GetMediaFileSystemsInteractivity? interactive;
   };
 

chrome/common/extensions/docs/static/mediaGalleries.html

+<div id="pageData-name" class="pageData">Media Galleries</div>
+
+<!-- BEGIN AUTHORED CONTENT -->
+<p>
+The media galleries API allows you to access media files (images,
+video, audio) from the user's local disks (with the user's consent).
+</p>
+
+<p>
+Using the API, you can prompt the user for permission to access the media
+galleries. The permission dialog will contain common media locations for
+the platform and will allow the user to add additional locations. From those
+locations, only media files will be present in the file system objects.
+</P>
+
+<h2 id="manifest">Manifest</h2>
+<p>You must declare the type of access to the media gallery you require
+in your extension's manifest to use the API.  Currently only the
+"mediaGalleriesRead" permission is allowed.  This permission does not
+currently trigger an install time permission prompt because it requires
+the user to grant permission at runtime.</p>
+
+<p>
+You may also specify the "mediaGalleriesAllGalleries" permission to get
+access to all auto-detected media galleries on the user's computer.  This
+permission displays an install time prompt indicating that the extension
+will have access to all of the user's media files.
+</p>
+
+<!-- END AUTHORED CONTENT -->