A write of an Edit block reaches Edit whole, on a pane's ctl, the root's and exec

Every write was split into lines, so a { group or an a/c/i text block written to ctl or exec became lines of their own: i/.../ and } ran as shell command panes that exited 127. An Edit line now takes the lines after it while its group is open or its text block waits for its . line (sam_edit.needsMore, asking sam's parser), on all three; the root ctl takes Edit at the active pane. s/re/text/N counts as sN/re/text/ does. The docs and the skill show a block written by heredoc or env printf, since bash's printf writes line by line, and take round 5's doc list: get refusing once, the (xN) on a repeated err, limit bounding only a forward search's end, line:col's clamping, and $NINE_MOUNT under 9ns --unix.

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

1 files changed, 10 insertions, 3 deletions

diff --git a/docs/fs.md b/docs/fs.md
index d60b4e73..9a77beee 100644
--- a/docs/fs.md
+++ b/docs/fs.md
@@ -61,6 +61,8 @@ private namespace:
 9ns --unix "$PARDES_9P" -- sh -c 'cat "$NINE_MOUNT/index"'
 ```
 
+(Under `9ns --unix`, `$NINE_MOUNT` is that session's root itself.)
+
 A `9ns --unix` mount lives in the private namespace of the command it runs,
 and nothing outside that command sees it. The mount everyone on the machine
 shares is the registry one, `9ns --mntgen` (default `/mnt/9p`): every running
@@ -360,14 +362,19 @@ they also accept, so copying one onto another is all that acme's `addr=dot`,
 address expression (`#0,#5`, `/pattern/`, `2+1`, and pardes's own `12:5`,
 below); `addr` selects what `data`
 and `xdata` read or replace, `dot` is the editor's own selection and moving it
-scrolls the pane into view, and `limit` bounds a search and reads empty until
-it is set. Truncating `dot` empties it, truncating `limit` lifts it, and
+scrolls the pane into view, and `limit` bounds only the end of a forward
+search, as acme's does, and reads empty until it is set. Truncating `dot` empties it, truncating `limit` lifts it, and
 truncating `addr` leaves it as it is (below).
 
 A rename everywhere, or any other sam edit, is one write to the pane's
 `ctl`: `Edit ,x/foo/c/bar/` runs acme's Edit (docs/tags.md) on the body as
 one undo step; a failure fails the write with acme's words and changes
-nothing.
+nothing. A write is one message a line, except that an `Edit` line takes
+the lines after it while its `{` group is open or its `a`, `c` or `i` text
+block waits for its `.` line, on a pane's `ctl`, the root's (at the active
+pane) and `exec` alike; an unclosed group is refused (``unmatched `{'``).
+bash's builtin `printf` writes a line at a time, so write a block with a
+heredoc or `env printf`.
 
 `line:col` is a pardes extension to sam's addresses, the spelling Look
 takes in `file:12:5`: `12:5` is the point at line 12, column 5, and it