Fixes for Andrea.

Author: ntoll

docs/api.md

@@ -345,9 +345,10 @@ information.
 #### `pyscript.fs.mount`
 
 Mount a directory on the user's local filesystem into the browser's virtual
-filesystem. If no previous transient user activation has taken place, this
-function will result in a minimalist dialog to provide the
-[transient user activation](https://developer.mozilla.org/en-US/docs/Glossary/Transient_activation).
+filesystem. If no previous
+[transient user activation](https://developer.mozilla.org/en-US/docs/Glossary/Transient_activation)
+has taken place, this function will result in a minimalist dialog to provide
+the required transient user activation.
 
 This asynchronous function takes four arguments:
 
@@ -356,7 +357,9 @@ This asynchronous function takes four arguments:
 * `mode` (default: `"readwrite"`) - indicates how the code may interact with
   the mounted filesystem. May also be just `"read"` for read-only access.
 * `id` (default: `"pyscript"`) - indicate a unique name for the handler
-  associated with a directory on the user's local filesystem.
+  associated with a directory on the user's local filesystem. This allows users
+  to select different folders and mount them at the same path in the
+  virtual filesystem.
 * `root` (default: `""`) - a hint to the browser for where to start picking the
   path that should be mounted in Python. Valid values are: `desktop`,
   `documents`, `downloads`, `music`, `pictures` or `videos` as per
@@ -370,6 +373,23 @@ from pyscript import fs
 await fs.mount("/local")
 ```
 
+If the call to `fs.mount` happens after a click or other transient event, the
+confirmation dialog will not be shown.
+
+```python title="Mounting without a transient event dialog."
+from pyscript import fs
+
+
+async def handler(event):
+    """
+    The click event that calls this handler is already a transient event.
+    """
+    await fs.mount("/local")
+
+
+my_button.onclick = handler
+```
+
 #### `pyscript.fs.sync`
 
 Given a named `path` for a mount point on the browser's virtual filesystem,
@@ -384,8 +404,8 @@ await fs.sync("/local")
 #### `pyscript.fs.unmount`
 
 Asynchronously unmount the named `path` from the browser's virtual filesystem.
-This will free up memory. A call to [`fs.sync`](#pyscriptfssync) is
-automatically made before unmounting.
+This will free up memory and allow you to re-use the path to mount a different
+directory.
 
 ```python title="Unmount from the virtual filesystem."
 await fs.unmount("/local")

docs/user-guide/filesystem.md

@@ -3,7 +3,7 @@
 As you know, the filesystem is where you store files. For Python to work there
 needs to be a filesystem in which Python packages, modules and data for your
 apps can be found. When you `import` a library, or when you `open` a file, it
-is on the filesystem that Python looks.
+is on the in-browser virtual filesystem that Python looks.
 
 However, things are not as they may seem.
 
@@ -31,7 +31,7 @@ PyScript interacts with two filesystems.
     Access to the device's local filesystem **is only available in Chromium
     based browsers**.
 
-    Firefox and Safari do not support this capability, and so it is not
+    Firefox and Safari do not support this capability (yet), and so it is not
     available to PyScript running in these browsers.
 
 ## The in-browser filesystem