Index: chrome/common/extensions/docs/templates/intros/fileSystemProvider.html |
diff --git a/chrome/common/extensions/docs/templates/intros/fileSystemProvider.html b/chrome/common/extensions/docs/templates/intros/fileSystemProvider.html |
index 7ca0ab38c80a3907636ac3abf58904e6b9a74e6c..2e95f18005116a2ee02751a078e5b87c87c814fe 100644 |
--- a/chrome/common/extensions/docs/templates/intros/fileSystemProvider.html |
+++ b/chrome/common/extensions/docs/templates/intros/fileSystemProvider.html |
@@ -22,25 +22,64 @@ Use cases include decompressing archives and accessing files in a cloud |
service other than Drive. |
</p> |
-<h2 id="archives">File handlers</h2> |
+<h2 id="archives">Mounting file systems</h2> |
<p> |
-Provided file systems can either provide file system contents from an external |
-source (such as a remote server), or using a local file (such as an archive) as |
-its input. |
+Providing extensions can either provide file system contents from an external |
+source (such as a remote server or a USB device), or using a local file (such as |
+an archive) as its input. |
</p> |
<p> |
-In the second case, the providing extension should have a |
+For file handlers, the providing extension should have a |
<a href="manifest/file_handlers">file_handlers</a> manifest entry in order |
to be launched when the file is selected in the file manager. |
When the extension is executed with a file to be handled, it has to mount a |
file system and start serving contents from the provided file. |
</p> |
+<p> |
+If the source is network or a device, then the file system should be mounted |
+when <a href="#event-onMountRequested">onMountDialogRequested</a> event is |
+called. |
+</p> |
+<p> |
+ <table> |
+ <tr> |
+ <th> |
+ <a href="#property-options-source">Source</a> of the file system data |
+ </th> |
+ <th>Entry point</th> |
+ </tr> |
+ <tr> |
+ <td> |
+ <code>"FILE"</code> |
+ </td> |
+ <td> |
+ <a href="apps/app_runtime#event-onLaunched">onLaunched</a> |
+ </td> |
+ </tr> |
+ <tr> |
+ <td> |
+ <code>"DEVICE"</code>, <code>"NETWORK"</code> |
+ </td> |
+ <td> |
+ <a href="#event-onMountRequested">onMountRequested</a> |
+ </td> |
+ </tr> |
+ </table> |
+</p> |
+ |
+<h2 id="archives">Configuring file systems</h2> |
+<p> |
+Provided file systems once mounted can be configured via the |
+<a href="#event-onConfigureRequested">onConfigureRequested</a> event. |
+It's especially useful for file systems which provide contents via network in |
+order to set proper credentials. Handling this event is optional. |
+</p> |
<h2 id="archives">Life cycle</h2> |
<p> |
Provided file systems once mounted are remembered by Chrome and remounted |
automatically after reboot or restart. Hence, once a file system is |
-<a href="method-mount">mounted</a> by a providing extension, it will stay until |
+<a href="#method-mount">mounted</a> by a providing extension, it will stay until |
either the extension is unloaded, or the extension calls the |
<a href="#method-unmount"> unmount</a> method. |
</p> |