Recipes work through a pane of their own, its look and exec, and keep a command pane while their open lasts; the docs give cmd panes, the err grep, alt-screen prompts, /pager's refusals, Tty+ on a ctl, --, and theme failures in words

Co-Authored-By: Claude Opus 5.5 <[email protected]>

1 files changed, 5 insertions, 4 deletions

diff --git a/src/fs-help.txt b/src/fs-help.txt
index 1f683667..cf8b65ed 100644
--- a/src/fs-help.txt
+++ b/src/fs-help.txt
@@ -23,17 +23,18 @@ os/, src/   the host filesystem; the editor's own sources
 $m below: $NINE_MOUNT/pardes/<pid|NAME> under 9ns --mntgen; $NINE_MOUNT under 9ns --unix; $PARDES_MOUNT in a Tty9p shell.
 
   cat $m/index                                 which panes exist
-  exec 3<>$m/look; echo /etc/hosts:3 >&3; cat <&3   open a file, see the pane it went to (a fresh open reads the last anyone's)
-  n=$(cat $m/pane/new)                         make a pane (each open makes one), take its serial
+  n=$(cat $m/pane/new)                         make a pane of your own (each open makes one), take its serial
+  exec 3<>$m/pane/$n/look; echo /etc/hosts:3 >&3; cat <&3   open a file through it, see the pane it went to
   printf 'text\n' >> $m/pane/$n/body           append to it (> replaces it all)
-  echo 'Msg hello' > $m/exec                   show text in the editor
+  echo 'Msg hello' > $m/pane/$n/exec           show text in the editor
   echo 'Edit ,x/foo/c/bar/' > $m/pane/$n/ctl   sam's Edit, one undo step; an x that matches nothing succeeds
   echo /re/ > $m/pane/$n/addr; printf new > $m/pane/$n/data   replace the next match
   exec 3<>$m/log; echo follow >&3; cat <&3     what happened lately, then wait for more
   exec 3<>$m/pane/$n/pty/run; echo make >&3; cat <&3   exit N, then the output
 
 Traps:
-  A refused write says only EINVAL or EIO; then (not after a success) the log's last err says why.
+  A refused write says only EINVAL or EIO; grep '^err' log | tail -1 says why (not the last line, maybe +Unsaved's new).
+  Root look and exec act at the active pane, which another client may own: use a pane's own look and exec.
   addr is the pane's and moves on: each /re/ searches from the last, a data write leaves it past the text.
   Through a mount, printf 'a\nb\n' arrives a line a write: send a block with one write, ending in a newline.
   Pane words (Save Undo Del) go to pane/<n>/ctl, settings and session words to /ctl.