diff options
| author | Gabriel Schneider <[email protected]> | 2026-09-28 23:50:30 -0300 |
|---|---|---|
| committer | Gabriel Schneider <[email protected]> | 2026-10-01 00:12:15 -0300 |
| commit | b71a9051006f88052d240e521046428c4e1c5e15 (patch) | |
| tree | 5d59ccfb5dc9f43836b1713e8a949a7ad0b6e44c /docs | |
| parent | a6c4ab97de9f9624d4d4d37a4f63cae342e314fb (diff) | |
| download | pardes-b71a9051006f88052d240e521046428c4e1c5e15.tar.gz pardes-b71a9051006f88052d240e521046428c4e1c5e15.zip | |
Docs answer round 7's questions
The grip's two terminal cells (the mode, then * for unsaved text), a new
terminal's new N / then rename and the ls it runs at its first prompt, the
tag offsets an x record carries, Del k and Del j, each builtin's msg in the
log and its serial, and m=$NINE_MOUNT under 9ns --unix in the skill.
Co-Authored-By: Claude Opus 5.5 <[email protected]>
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/fs.md | 14 | ||||
| -rw-r--r-- | docs/tags.md | 5 |
2 files changed, 14 insertions, 5 deletions
@@ -161,7 +161,8 @@ takes (`Verbose on`, `WindowOpacity 70`, `PanelSlide off`, `DumpDir back changes nothing; a setting the frontend cannot show (`Lift`, `GripWidth` on a terminal) is refused as `Lift is GUI-only`; platform and startup facts are `/status`'s and the Config window's, not settings. A pane's `ctl` takes the builtins that act on -a pane (`Del`, `Save f`, `Collapse`, which folds that pane, `Undo` and +a pane (`Del`, or `Del k`/`Del j` to give its rows to the pane above or +below, `Save f`, `Collapse`, which folds that pane, `Undo` and `Redo`, which step its body through its edits, `Find pat`) beside acme's `get`, `lock` and `unlock`. The column words are pane words too, acting on the column that pane is in: `Delcol`, `DelAbove`, `DelBelow` @@ -529,7 +530,9 @@ entries carry no sizes, and neither does `/screen`, which has no length until an open renders its frame; stat the entry. `/log` is one ring (64 KiB) that records whether or not anyone reads it: -`new`, `del`, `rename` (a terminal's too, as its shell changes directory, +`new`, `del`, `rename` (a terminal's too, as its shell changes directory -- +a new terminal is `new N /` until its shell says where it is, then renamed; +it runs `ls` once at its first prompt, a greeting that shows the directory -- since a terminal is named by its directory), `exit <serial> <N>` before the `del` of a terminal whose shell exited by itself, `ask <serial> <what> <choices>` when a pane asks a question (answered by `answer` on its ctl), @@ -538,7 +541,9 @@ and `save <serial> <name>`, new log after its panes' `new`s, then `restored <old> <new>` for each pane, mapping the serial it had to the one it has now, and `msg <serial|-> <text>` for every line the editor says, repeats included (with `verbose` on, that -includes each builtin announcing itself as it runs), and `err <serial|-> +includes each builtin announcing itself as it runs, on purpose: the log says +which ran; its serial is the pane it ran at, `-` when the keyboard was on a +column or workspace tag), and `err <serial|-> <file>: <why>` for every write or truncation the tree refused or that failed -- through a mount a shell sees only the errno its kernel mapped the reply to, usually `Invalid argument`, and this is the reason (`err 3 addr: @@ -561,7 +566,8 @@ Control characters in a record become spaces, so a record is one line. (An `event` record is not: acme's `<origin><action><q0> <q1> <flag> <n> <text>\n`, whose text may hold newlines. The origin is `E` (a 9P write to body or tag), `F` (other files, the editor's own lines), `K` (the keyboard) or `M` (the mouse); the -action's case says where: `x`/`l` a click executed or looked at in the tag, +action's case says where: `x`/`l` a click executed or looked at in the tag +(its offsets count the tag's whole text, path included, as `tag` reads), `X`/`L` in the body, `I`/`D` text put in or taken out of the body, `i`/`d` of the tag. Read `n` bytes of the text, not up to a newline -- bytes here, where acme counts runes. Every offset and count pardes serves is in bytes, `#n` and `q0`/`q1` too; the event count diff --git a/docs/tags.md b/docs/tags.md index f622520f..885eb22f 100644 --- a/docs/tags.md +++ b/docs/tags.md @@ -190,7 +190,10 @@ the shared bold, underline, and strikethrough attributes, including diagnostic underlines and the optional `SyntaxBold` keyword weight. Unsaved text shows on the pane's grip button, as acme's modbutton does, -not in the tag: the tag names the file and nothing more. The `dirty` file +not in the tag: the tag names the file and nothing more. In a terminal the +grip is two cells: the second is `*` while the pane holds unsaved text, and +the first is the pane's mode: blank in normal mode, `^` in insert, `$` when +the keyboard goes to a terminal's program (tty mode). The `dirty` file and `index`'s flag say the same to a script. ## Empty columns |
