summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorGabriel Schneider <[email protected]>2026-11-10 09:57:43 -0300
committerGabriel Schneider <[email protected]>2026-11-10 09:57:43 -0300
commita953f560f648e91dda8dd3a8dafe60a7f75739d0 (patch)
tree1ae6de86ede6b0e1464708c04478340609e4296e /docs
parent5033138d9e93e05dc961c0f7b93e46208d5df33d (diff)
downloadpardes-a953f560f648e91dda8dd3a8dafe60a7f75739d0.tar.gz
pardes-a953f560f648e91dda8dd3a8dafe60a7f75739d0.zip
history: each dump is the command that brings it back, `Restore <label>` on a line of its own, its date, size, pane count and names indented on the line under it, so the line is a whole command (a sweep of it, a click on its Restore, a look at it) and the details are read, not parsed; the builtins JSON, the reference and the changelog say so
Co-Authored-By: Claude Fable 5.1 <[email protected]> Claude-Session: https://claude.ai/code/session_016Y9MNAtZenFv4weoMD3cge
Diffstat (limited to 'docs')
-rw-r--r--docs/typ/builtins-gui.json2
-rw-r--r--docs/typ/builtins-tui.json2
-rw-r--r--docs/typ/reference.typ9
3 files changed, 7 insertions, 6 deletions
diff --git a/docs/typ/builtins-gui.json b/docs/typ/builtins-gui.json
index 7cb041c6..c7ff594f 100644
--- a/docs/typ/builtins-gui.json
+++ b/docs/typ/builtins-gui.json
@@ -45,7 +45,7 @@
{"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, `Restore <label>`, date, size, pane count and the panes' names; a click on a row's Restore (an exec, or a look at the row) is a Restore of its label."},
+ {"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, each as the command that brings it back, `Restore <label>` on a line of its own, its date, size, pane count and the panes' names indented under it; a click on the Restore (an exec, or a look at the line) is that Restore."},
{"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 b2812f58..feb1140f 100644
--- a/docs/typ/builtins-tui.json
+++ b/docs/typ/builtins-tui.json
@@ -41,7 +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, `Restore <label>`, date, size, pane count and the panes' names; a click on a row's Restore (an exec, or a look at the row) is a Restore of its label."},
+ {"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, each as the command that brings it back, `Restore <label>` on a line of its own, its date, size, pane count and the panes' names indented under it; a click on the Restore (an exec, or a look at the line) is that Restore."},
{"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/reference.typ b/docs/typ/reference.typ
index 04a207e0..030b7c6a 100644
--- a/docs/typ/reference.typ
+++ b/docs/typ/reference.typ
@@ -402,10 +402,11 @@ Writes take settings and session builtins (`scope = .session` in
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: `Restore <label>`, its date, size,
- pane count and what its panes showed, a word each; a click on a row's
- #word("Restore") (its exec, or a look at the row) is a #word("Restore") of
- that dump. `Dump export <path>` writes the dump to a file of its own
+ pane, the newest first, each as the command that brings it back,
+ `Restore <label>` on a line of its own, with its date, size, pane count
+ and what its panes showed, a word each, indented under it; a click on
+ that #word("Restore") (its exec, or a look at the line) is that
+ #word("Restore"). `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.