summaryrefslogtreecommitdiff
path: root/docs/fs.md
diff options
context:
space:
mode:
authorGabriel Schneider <[email protected]>2026-09-28 23:11:08 -0300
committerGabriel Schneider <[email protected]>2026-10-01 00:12:15 -0300
commit8b2a55f31169ede82e11a573ab655e72e7831fe7 (patch)
treed0e14b6abc79e7a6fd0d60af587fc47f331e8f64 /docs/fs.md
parent7e6e5e803c6ec2e203b094b2a64291840c5e6aed (diff)
downloadpardes-8b2a55f31169ede82e11a573ab655e72e7831fe7.tar.gz
pardes-8b2a55f31169ede82e11a573ab655e72e7831fe7.zip
A choice setting's refusal names what it takes, and /commands lists them
Bare Placement and BootShell flip, which is pardes's convention for a word that chooses (Crt does too), but nothing said so, and "bad value in control message" never said what would do. A refused value now says `takes acme, pardes` (every switch and choice setting), /commands lists each such setting's values in a fourth field, and config.md and fs.md say that bare steps to the next. Motion and ShaderAnimation stepped nowhere bare and now step like the rest. Co-Authored-By: Claude Opus 5.5 <[email protected]>
Diffstat (limited to 'docs/fs.md')
-rw-r--r--docs/fs.md11
1 files changed, 8 insertions, 3 deletions
diff --git a/docs/fs.md b/docs/fs.md
index 9052967e..1e09c412 100644
--- a/docs/fs.md
+++ b/docs/fs.md
@@ -104,7 +104,7 @@ Existing Plan9port/v9fs clients need a userspace bridge for QUIC.
/listeners the session's dial addresses
/focus the serial of the pane with the keyboard; write a serial to give it the keyboard
/ctl the settings, one a line as a write takes them; write a setting or a session builtin
-/commands every builtin: word, `arg` if it takes one, and `root` or `pane`, the ctl that takes it
+/commands every builtin: word, `arg` if it takes one, `root` or `pane` (the ctl that takes it), a setting's values
/pane/new open it to make a pane; the read answers that pane's serial
/pane/<n>/ name body tag ctl addr dot limit data xdata sel dirty mark scroll
errors event look exec, plus pty/{ctl,status,data} on terminals
@@ -193,8 +193,13 @@ performed what it asked for (a save written, a shell started). A click on
the same word, or the word written to `exec`, still opens its prompt.
`/commands` lists every builtin the registry holds, in registry order, one
-a line: its word, `arg` when it takes one, and `root` or `pane` for the ctl
-that takes it, e.g. `Newcol root`, `Save arg pane`, `Verbose arg root`. It is
+a line: its word, `arg` when it takes one, `root` or `pane` for the ctl
+that takes it, and for a setting that chooses among words those words,
+comma-joined, e.g. `Newcol root`, `Save arg pane`, `Verbose arg root on,off`,
+`Placement arg root acme,pardes`. Such a setting written bare steps to its
+next value, so a two-valued one flips (`Crt`, `Placement`, `BootShell`), as
+its word clicked in a tag does; a value it does not take is refused with
+`bad value in control message; takes ...` naming those it does. It is
generated from the registry, so it is always this build's own list.
`/focus` reads the serial of the pane with the keyboard, and a serial written