Update documentation for "file_system_provider" manifest section.

chrome/common/extensions/api/file_system_provider.idl

 // Copyright 2013 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.fileSystemProvider</code> API to create file systems,
 // that can be accessible from the file manager on Chrome OS.
 [implemented_in="chrome/browser/chromeos/extensions/file_system_provider/file_system_provider_api.h"]
 namespace fileSystemProvider {
   // Error codes used by providing extensions in response to requests as well
   // as in case of errors when calling methods of the API. For success, <code>
@@ skipping 11 matching lines @@
     NOT_A_DIRECTORY,
     INVALID_OPERATION,
     SECURITY,
     ABORT,
     NOT_A_FILE,
     NOT_EMPTY,
     INVALID_URL,
     IO
   };
 
   // Mode of opening a file. Used by <code>onOpenFileRequested</code>.

[not at google - send to devlin, 2015/05/12 00:08:51]

These should be $(ref:onOpenFileRequested) (there are many instances in this
file).

[mtomasz, 2015/05/12 08:01:18]

I didn't know we can do that in IDL/json. Done.

   enum OpenFileMode {
     READ,
     WRITE
   };
 
   // Type of a change detected on the observed directory.
   enum ChangeType {
     CHANGED,
     DELETED
   };
@@ skipping 363 matching lines @@
     Change[]? changes;
 
     // Tag for the notification. Required if the file system was mounted with
     // the <code>supportsNotifyTag</code> option. Note, that this flag is
     // necessary to provide notifications about changes which changed even
     // when the system was shutdown.
     DOMString? tag;
   };
 
   // Options for the <code>onConfigureRequested()</code> event.
-  [nodoc] dictionary ConfigureRequestedOptions {
+  dictionary ConfigureRequestedOptions {
     // The identifier of the file system to be configured.
     DOMString fileSystemId;
 
     // The unique identifier of this request.
     long requestId;
   };
 
   // Callback to receive the result of getAll() function.
   callback GetAllCallback = void(FileSystemInfo[] fileSystems);
 
@@ skipping 54 matching lines @@
                         optional ResultCallback callback);
 
     // Returns all file systems mounted by the extension.
     static void getAll(GetAllCallback callback);
 
     // Returns information about a file system with the passed <code>
     // fileSystemId</code>.
     static void get(DOMString fileSystemId, GetCallback callback);
 
     // Notifies about changes in the watched directory at <code>
-    // observedPath</code> in <code>recursive</code mode. If the file system is
+    // observedPath</code> in <code>recursive</code> mode. If the file system is
     // mounted with <code>supportsNofityTag</code>, then <code>tag</code> must
     // be provided, and all changes since the last notification always reported,
     // even if the system was shutdown. The last tag can be obtained with <code>
     // getAll()</code>. Note, that <code>tag</code> is required in order to
     // enable the internal cache.
     //
     // Value of <code>tag</code> can be any string which is unique per call,
     // so it's possible to identify the last registered notification. Eg. if
     // the providing extension starts after a reboot, and the last registered
     // notification's tag is equal to "123", then it should call notify() for
@@ skipping 128 matching lines @@
     // abort request executed. If aborting fails, then <code>errorCallback
     // </code> must be called. Note, that callbacks of the aborted operation
     // must not be called, as they will be ignored. Despite calling <code>
     // errorCallback</code>, the request may be forcibly aborted. 
     [maxListeners=1] static void onAbortRequested(
         AbortRequestedOptions options,
         ProviderSuccessCallback successCallback,
         ProviderErrorCallback errorCallback);
 
     // Raised when showing a configuration dialog for <code>fileSystemId</code>
-    // is requested. If it's not supported, then this event must not be handled.
-    [maxListeners=1, nodoc] static void onConfigureRequested(
+    // is requested. If it's handled, the <code>
+    // file_system_provider.configurable</code> manfiest option must be set to
+    // true.
+    [maxListeners=1] static void onConfigureRequested(
         ConfigureRequestedOptions options,
         ProviderSuccessCallback successCallback,
         ProviderErrorCallback errorCallback);
 
     // Raised when showing a dialog for mounting a new file system is requested.
     // If the extension/app is a file handler, then this event shouldn't be
     // handled. Instead <code>onLaunched</code> should be handled in order to
-    // mount new file systems when a file is opened.
-    [maxListeners=1, nodoc] static void onMountRequested(
+    // mount new file systems when a file is opened. For multiple mounts, the
+    // <code>file_system_provider.multiple_mounts</code> manifest option must
+    // be set to true.
+    [maxListeners=1] static void onMountRequested(
         ProviderSuccessCallback successCallback,
         ProviderErrorCallback errorCallback);
 
     // Raised when setting a new directory watcher is requested. If an error
     // occurs, then <code>errorCallback</code> must be called.
     [maxListeners=1, nodoc] static void onAddWatcherRequested(
       AddWatcherRequestedOptions options,
       ProviderSuccessCallback successCallback,
       ProviderErrorCallback errorCallback);
 
     // Raised when the watcher should be removed. If an error occurs, then
     // <code>errorCallback</code> must be called.
     [maxListeners=1, nodoc] static void onRemoveWatcherRequested(
       RemoveWatcherRequestedOptions options,
       ProviderSuccessCallback successCallback,
       ProviderErrorCallback errorCallback);
   };
 };