diff options
| author | Gabriel Schneider <[email protected]> | 2026-11-09 23:15:39 -0300 |
|---|---|---|
| committer | Gabriel Schneider <[email protected]> | 2026-11-09 23:15:53 -0300 |
| commit | 0b4cfd4b416d03ef64ccd908dfee810c6a498569 (patch) | |
| tree | 83da4851e30b4dd0e788b66f0024d5b55eaee421 /docs/typ | |
| parent | 7e6fc8c9f62bc3dc08e24856cc647fa0adefb32c (diff) | |
| download | pardes-0b4cfd4b416d03ef64ccd908dfee810c6a498569.tar.gz pardes-0b4cfd4b416d03ef64ccd908dfee810c6a498569.zip | |
a session's end leaves a slim dump and History lists them, the tags gain Follow, History and the window's Fonts: every way out (Exit, the last pane's Del, the host's quit) runs Pardes.endSession, which puts a dump of the session in the state file under the usual label before quitting, slim by the dump's own means (dumpJoin's slim_terminals, and Store's slim-file swap now a Slim struct: no undo, a clean file's text read from its file again by revivePane, a terminal a size for a new shell), none for a session of shells alone; the dump's image carries the panes' names, which /dumps rows end with; the History builtin (SPC f h) lists the state file's dumps in a +History pane and a look at a row is a Restore of its label; the default tags: Follow after Collapse on text panes, History before Debug on the workspace row, Fonts after Themes in a window's view alone (tagline.topbarDefault picks the row per view; both rows are known defaults to the docs and tutor tests); the tty goldens re-recorded (the new words; a narrow pane's tag wraps to a second row, so its body rows shift), builtins JSON regenerated
Co-Authored-By: Claude Fable 5.1 <[email protected]>
Claude-Session: https://claude.ai/code/session_016Y9MNAtZenFv4weoMD3cge
Diffstat (limited to 'docs/typ')
| -rw-r--r-- | docs/typ/builtins-gui.json | 3 | ||||
| -rw-r--r-- | docs/typ/builtins-tui.json | 1 | ||||
| -rw-r--r-- | docs/typ/cheatsheet.typ | 5 | ||||
| -rw-r--r-- | docs/typ/guide.typ | 4 | ||||
| -rw-r--r-- | docs/typ/reference.typ | 10 |
5 files changed, 17 insertions, 6 deletions
diff --git a/docs/typ/builtins-gui.json b/docs/typ/builtins-gui.json index 09517de3..a8f682a6 100644 --- a/docs/typ/builtins-gui.json +++ b/docs/typ/builtins-gui.json @@ -39,12 +39,13 @@ {"name": "Find", "leader": "SPC f f", "also": ["topbar"], "arg": true, "scope": "pane", "setting": false, "choices": null, "doc": "List the files below this pane's directory whose names hold its argument, in a +Search."}, {"name": "Follow", "leader": "SPC c f", "also": [], "arg": false, "scope": "pane", "setting": false, "choices": null, "doc": "Emacs's follow-mode: one text across a chain of panes as consecutive pages, each going on where the one before ends, scrolled as one."}, {"name": "Font", "leader": null, "also": [], "arg": true, "scope": "root", "setting": true, "choices": null, "doc": "The body font, by name or path, and its size."}, - {"name": "Fonts", "leader": "SPC t f", "also": [], "arg": false, "scope": "root", "setting": false, "choices": null, "doc": "List the fonts in a pane, each a word to click."}, + {"name": "Fonts", "leader": "SPC t f", "also": ["topbar"], "arg": false, "scope": "root", "setting": false, "choices": null, "doc": "List the fonts in a pane, each a word to click."}, {"name": "Forward", "leader": "SPC j i", "also": ["C-i"], "arg": false, "scope": "root", "setting": false, "choices": null, "doc": "Ctrl-i: one step forward again, up to wherever Back started."}, {"name": "Get", "leader": null, "also": [], "arg": true, "scope": "pane", "setting": false, "choices": null, "doc": "acme's Get: the pane's file read again, its unsaved edits refused once as Del refuses them."}, {"name": "Grep", "leader": "SPC f g", "also": ["topbar"], "arg": true, "scope": "pane", "setting": false, "choices": null, "doc": "Find's sibling: Find matches file NAMES under this pane's directory, Grep matches the LINES of those files, on the disk engine's worker."}, {"name": "GripWidth", "leader": null, "also": [], "arg": true, "scope": "root", "setting": true, "choices": null, "doc": "The grip and scrollbar width, as a percent of the theme's rail."}, {"name": "Help", "leader": "SPC ?", "also": ["topbar"], "arg": false, "scope": "root", "setting": false, "choices": null, "doc": "Open the help: every key and every builtin."}, + {"name": "History", "leader": "SPC f h", "also": ["topbar"], "arg": false, "scope": "root", "setting": false, "choices": null, "doc": "List the state file's dumps, those Dump made and those every session's end left (dump.dumpExit), the newest first: a row each, its label, date, size, pane count and the panes' names; a look at a row is a Restore of its label."}, {"name": "Hover", "leader": "SPC l k", "also": [], "arg": false, "scope": "pane", "setting": false, "choices": null, "doc": "Ask the language server about the symbol under the cursor."}, {"name": "InactiveDim", "leader": null, "also": [], "arg": true, "scope": "root", "setting": true, "choices": null, "doc": "Fade the unfocused panes' text by a percentage, 0 through 100, 0 off."}, {"name": "Incl", "leader": null, "also": [], "arg": true, "scope": "root", "setting": false, "choices": null, "doc": "acme's Incl, for the session: `Incl dir ...` adds directories a look at a name found nowhere else is tried in (`stdio.h`, `<foo.h>`), bare lists them, `Incl -` empties the list."}, diff --git a/docs/typ/builtins-tui.json b/docs/typ/builtins-tui.json index edc401f6..c5533c63 100644 --- a/docs/typ/builtins-tui.json +++ b/docs/typ/builtins-tui.json @@ -41,6 +41,7 @@ {"name": "Get", "leader": null, "also": [], "arg": true, "scope": "pane", "setting": false, "choices": null, "doc": "acme's Get: the pane's file read again, its unsaved edits refused once as Del refuses them."}, {"name": "Grep", "leader": "SPC f g", "also": ["topbar"], "arg": true, "scope": "pane", "setting": false, "choices": null, "doc": "Find's sibling: Find matches file NAMES under this pane's directory, Grep matches the LINES of those files, on the disk engine's worker."}, {"name": "Help", "leader": "SPC ?", "also": ["topbar"], "arg": false, "scope": "root", "setting": false, "choices": null, "doc": "Open the help: every key and every builtin."}, + {"name": "History", "leader": "SPC f h", "also": ["topbar"], "arg": false, "scope": "root", "setting": false, "choices": null, "doc": "List the state file's dumps, those Dump made and those every session's end left (dump.dumpExit), the newest first: a row each, its label, date, size, pane count and the panes' names; a look at a row is a Restore of its label."}, {"name": "Hover", "leader": "SPC l k", "also": [], "arg": false, "scope": "pane", "setting": false, "choices": null, "doc": "Ask the language server about the symbol under the cursor."}, {"name": "InactiveDim", "leader": null, "also": [], "arg": true, "scope": "root", "setting": true, "choices": null, "doc": "Fade the unfocused panes' text by a percentage, 0 through 100, 0 off."}, {"name": "Incl", "leader": null, "also": [], "arg": true, "scope": "root", "setting": false, "choices": null, "doc": "acme's Incl, for the session: `Incl dir ...` adds directories a look at a name found nowhere else is tried in (`stdio.h`, `<foo.h>`), bare lists them, `Incl -` empties the list."}, diff --git a/docs/typ/cheatsheet.typ b/docs/typ/cheatsheet.typ index 25a9294f..5e373fac 100644 --- a/docs/typ/cheatsheet.typ +++ b/docs/typ/cheatsheet.typ @@ -24,9 +24,9 @@ Over a program that takes the mouse, Shift swaps: #btn("B1", shift: true) select One button: Alt/Option-click is #btn("B2"), Cmd/Super-click #btn("B3"), sweeps too (a terminal passes only Alt); Ctrl-click is a definition; a program that takes the mouse gets the plain click. == Tags -#tag("Newcol Joincol Find Grep Help Changelog Tutor Dump Themes Config Debug Exit") +#tag("Newcol Joincol Find Grep Help Changelog Tutor Dump Themes Fonts Config History Debug Exit") #tag("New Term Find Grep Joincol Delcol") -#tag("Save Term Collapse Del", path: "/home/me/notes.txt") +#tag("Save Term Collapse Follow Del", path: "/home/me/notes.txt") #tag("Term+bash Save Mode Filter Collapse Del", path: "/home/me/src") #tag("Term PdfSections PdfTint PdfFit Collapse Del", path: "[1/12] … manual.pdf") - #word("Del") over unsaved text refuses once; again discards. #word("Del") `j`: rows below. #key("SPC d") between two panes takes #key("k") (rows above) or #key("j") (below), asking only if you pause. @@ -87,6 +87,7 @@ Helix-style: motions *select*, then an edit acts on the selection. Mode box: bla key("SPC f f"), word("Find"), key("SPC f g"), word("Grep"), key("SPC f r"), word("Recent"), + key("SPC f h"), word("History"), key("SPC b b"), word("Panes"), key("SPC s s"), [declarations], key("SPC f c"), word("Config"), diff --git a/docs/typ/guide.typ b/docs/typ/guide.typ index 51f29fb8..41d59e53 100644 --- a/docs/typ/guide.typ +++ b/docs/typ/guide.typ @@ -92,9 +92,9 @@ the registers. #key("SPC y") and #key("SPC p") use the system clipboard. = Tags <tags> -#tag("Newcol Joincol Find Grep Help Changelog Tutor Dump Themes Config Debug Exit") +#tag("Newcol Joincol Find Grep Help Changelog Tutor Dump Themes Fonts Config History Debug Exit") #tag("New Term Find Grep Joincol Delcol") -#tag("Save Term Collapse Del", path: "/home/me/notes.txt") +#tag("Save Term Collapse Follow Del", path: "/home/me/notes.txt") A tag is text with undo. Type `make` into one and #word("Exec") it, or delete the words you never use. Any word runs from any tag: #word("Exit") diff --git a/docs/typ/reference.typ b/docs/typ/reference.typ index 48bdfdbe..e1c9e263 100644 --- a/docs/typ/reference.typ +++ b/docs/typ/reference.typ @@ -396,7 +396,15 @@ Writes take settings and session builtins (`scope = .session` in #word("Restore") `<label>` word naming it to the workspace tag (the last dump's, replacing an earlier one's). The state file keeps the newest 32 dumps, and a text unchanged since an earlier one once; #file("/dumps") - lists them. `Dump export <path>` writes the dump to a file of its own + lists them. A session's end (#word("Exit"), the last pane's #word("Del"), + its terminal or window gone) leaves a dump there too, slim: its panes + with their files, directories and places, not a clean file's text (its + file's, read again), an undo history or a terminal's screen (a new shell + starts in the directory); a session of shells alone leaves none. + #word("History") (`SPC f h`) lists the state file's dumps in a `+History` + pane, the newest first, a row each: its label, date, size, pane count and + what its panes showed, a word each; a look at a row is a + #word("Restore") of its label. `Dump export <path>` writes the dump to a file of its own instead (`~` the home directory; the tag's word then names the path), which `-l <path>` and #word("Restore") `<path>` read: the way to carry a session to another machine. |
