1 files changed, 9 insertions, 0 deletions
diff --git a/docs/fs.md b/docs/fs.md
index 52f991c2..ca02082b 100644
--- a/docs/fs.md
+++ b/docs/fs.md
@@ -15,6 +15,15 @@ separate editor and withholds `PARDES_PID` from its pane shells, so a pardes
 started in one of them runs a session of its own; its 9P service stays
 available.
 
+A forwarded launch returns at once, as acme's `B` does. `--wait` (`-w`)
+returns only once the pane the file landed in -- the one already showing
+it, if any -- is deleted (exit 0), or the session goes away (exit 1), as
+acme's `E` does: what an `$EDITOR` must do, since fish's Ctrl-O
+(`edit_command_buffer`), `git commit` and `crontab -e` read the file back
+when the editor exits. Set `EDITOR='pardes --wait'`; `GIT_EDITOR` follows
+`EDITOR` when unset. Outside pardes `--wait` changes nothing, a session
+blocking anyway.
+
 Look resolves the OS filesystem first, then the editor's virtual filesystem.
 Explicit paths bypass that search: