summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorGabriel Schneider <[email protected]>2026-09-29 01:50:05 -0300
committerGabriel Schneider <[email protected]>2026-10-01 00:12:15 -0300
commitb29de1d4e78466a15f5d3dc0916410cba1445c5f (patch)
tree27c606018a7084a3636a974064d1205d64f31c86 /docs
parent5b11fc35b961eb03c8816bf957bbf8e27a22ae3e (diff)
downloadpardes-b29de1d4e78466a15f5d3dc0916410cba1445c5f.tar.gz
pardes-b29de1d4e78466a15f5d3dc0916410cba1445c5f.zip
The docs say the errno that fits, Joincol's order, the pane cap, the paste's second Enter, a follower across Restore, and why wc waits
Dogfood round 9's doc findings: ENOENT for a missing pane, file or dump is right, so the skill says EIO or an errno that fits; Joincol folds into the column on the right, the joined panes below its own; the skill gives the 64-pane cap; Python's second \r is needed only when the paste lacks a trailing newline; a log follower loses nothing within a session, but a Restore hangs it up; and a tag word gets no file argument, as in acme, so bare wc waits on stdin (pardes has no $%). Co-Authored-By: Claude Opus 5.5 <[email protected]>
Diffstat (limited to 'docs')
-rw-r--r--docs/fs.md13
-rw-r--r--docs/tags.md4
2 files changed, 13 insertions, 4 deletions
diff --git a/docs/fs.md b/docs/fs.md
index ad9c97ba..8aa9d6bf 100644
--- a/docs/fs.md
+++ b/docs/fs.md
@@ -137,7 +137,8 @@ gives each column's serial and its index left to right, and the log says
`newcol <serial>` and `delcol <serial>` as columns come and go, and after a
Restore `restoredcol <old> <new>` for each column as `restored` does for
panes. Joincol folds a column into the one on its right, which keeps its own
-serial and tag; the joined one's serial is gone (`delcol`). The root ctl
+serial and tag; the joined column's panes go below that column's own, in
+their order, and its serial is gone (`delcol`). The root ctl
takes no column word: its `Delcol` is refused, pointing at
`col/<serial>/ctl`.
@@ -357,8 +358,9 @@ is no gesture and is never sent: a script writes to the REPL pane's
`pty/data`, multi-line code as a bracketed paste (`\e[200~<code>\e[201~`,
then `\r` in a write of its own once the REPL has echoed the paste --
Python 3.13's REPL takes an Enter read with the paste as part of it, even a
-one-line one -- and a second `\r` when its last line is indented: one Enter
-leaves a block open, pasted or typed; a middle click does all of this
+one-line one -- and, only when the pasted code does not end in a newline
+and its last line is indented, a second `\r`: one Enter leaves such a block
+open; a middle click does all of this
itself, holding the Enter until the REPL answers the paste), since line by line a blank line ends a Python block and Python
3.14's REPL auto-indents each line typed into it. The REPL gets the text
wherever it is -- at a `pdb` or `input()` prompt too. Bindings are not dumped, so a Restore leaves none.
@@ -627,7 +629,10 @@ tag gives offsets into the whole tag as `tag` reads it, the path first.) An
open freezes the ring's text the way `/screen` freezes a frame: reads walk it
and end. Writing `follow` to that same open makes reads past it wait for the
next record, one per read; a follower the ring outran reads `lost N` first.
-Closing the open is the only way back, as with rio's `consctl`.
+Closing the open is the only way back, as with rio's `consctl`. A follower
+misses nothing within a session only: a Restore hangs its connection up
+(and a 9ns mount with it, which must be restarted), so it dials again and
+reads the new log from its `restore <path>`.
A read with nothing to give yet -- a following `log`, `event`, `pty/data`, a
`pty/run` before its answer -- is held, the way factotum holds its log's reads
diff --git a/docs/tags.md b/docs/tags.md
index bfca4f0e..b8322aa9 100644
--- a/docs/tags.md
+++ b/docs/tags.md
@@ -17,6 +17,10 @@ REPL, its id, `python-a`, beside the Tty word: a middle click or the execute
key on a `.py` body then types the text into it rather than running it, and
several bound ask which. The tag's own words, `Exec <text>` by name and a
command word @`cmd` still run as commands (docs/fs.md).
+A tag word runs as acme's does, in the pane's directory with no file named:
+`wc` alone waits on its stdin. pardes has no `$%` for the pane's file; name
+it (`wc notes.txt`), or select the name and middle-click `wc`, which takes a
+held selection as its argument.
Pane and column command text leave a small gap after their aligned drag grips.
GUI pane mode symbols are centered by their visible ink; changing the font or
its size refreshes the cached measurements.