summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorGabriel Schneider <[email protected]>2026-11-05 11:34:44 -0300
committerGabriel Schneider <[email protected]>2026-11-05 15:15:07 -0300
commit2bd4066a932ec8fc401e4b85e9f8441b17df3cfb (patch)
tree024f6180ed665fbe821e4a4a46e54551e6a0b31e /docs
parent7ec1181244c039db72986eec46f21a9d5ac2e171 (diff)
downloadpardes-2bd4066a932ec8fc401e4b85e9f8441b17df3cfb.tar.gz
pardes-2bd4066a932ec8fc401e4b85e9f8441b17df3cfb.zip
effects out, Lift and InactiveDim: the core's per-pane lift springs (Pardes.lifts, lift_serials, Region.lift, Chrome.lift_style) and the unfocused panes' recede (draw.zig's dim, its contrast memo and linear blend) go with the words, their settings and tests; the window loses its soft shadows (addSoft, the lift and rim casting, the shadow a sliding pane cast, the contrast ceilings, decor.frag's Gaussian path) and Chrome.sel_fg and sel_bg, which only the ceilings read; a pane closed mid-lift left its spring unsettled and continuous() true for ever, so a window could never go idle (monkey-gui failed `never settled` in the Lift combinations, and passes now); GUI golden 18-mid-transition changes, its sliding pane casting no shadow (the scene leaves with the transitions); root_ctl's out-of-range case is SearchRows', settings' GUI-only case GripWidth's, the window monkey loses its Lift axis
Co-Authored-By: Claude Opus 5.5 <[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.json1
-rw-r--r--docs/typ/reference.typ16
3 files changed, 7 insertions, 12 deletions
diff --git a/docs/typ/builtins-gui.json b/docs/typ/builtins-gui.json
index 16fd9f2b..f2eb46d3 100644
--- a/docs/typ/builtins-gui.json
+++ b/docs/typ/builtins-gui.json
@@ -45,7 +45,6 @@
{"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": "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."},
{"name": "Index", "leader": null, "also": [], "arg": false, "scope": "pane", "setting": false, "choices": null, "doc": "Run the file's language indexer at its project root, writing the index.scip the language words ask first."},
{"name": "Joincol", "leader": "SPC c j", "also": ["topbar"], "arg": false, "scope": "root", "setting": false, "choices": null, "doc": "Fold the active pane's column into the one on its right, keeping its panes."},
@@ -54,7 +53,6 @@
{"name": "Kill", "leader": null, "also": [], "arg": true, "scope": "root", "setting": false, "choices": null, "doc": "acme's Kill: stop the commands pardes started -- the lines it typed into a terminal, from an exec, a middle click or a pty/run, while their shell says they run (C mark to D)."},
{"name": "Last", "leader": "SPC j j", "also": [], "arg": false, "scope": "pane", "setting": false, "choices": null, "doc": "Go back to the last place jumped from in another pane."},
{"name": "Left", "leader": null, "also": [], "arg": false, "scope": "pane", "setting": false, "choices": null, "doc": "Move the keyboard to the pane, or column tag, to the left."},
- {"name": "Lift", "leader": null, "also": [], "arg": true, "scope": "root", "setting": true, "choices": "on, off, shadow, rim, auto", "doc": "How the focused pane stands off the page: off, shadow, rim or auto."},
{"name": "Ligatures", "leader": null, "also": [], "arg": true, "scope": "root", "setting": true, "choices": "on, off", "doc": "A font's programming ligatures draw across their cells, on or off."},
{"name": "LocationsConfig", "leader": null, "also": [], "arg": true, "scope": "root", "setting": false, "choices": null, "doc": "Set how location rows are drawn, or show how they are when bare."},
{"name": "Look", "leader": null, "also": ["enter", "right-click"], "arg": true, "scope": "pane", "setting": false, "choices": null, "doc": "Look at its argument: open the file or address it names, else find the word, as a right click does."},
diff --git a/docs/typ/builtins-tui.json b/docs/typ/builtins-tui.json
index 3de0e0cc..2947aa98 100644
--- a/docs/typ/builtins-tui.json
+++ b/docs/typ/builtins-tui.json
@@ -41,7 +41,6 @@
{"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": "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."},
{"name": "Index", "leader": null, "also": [], "arg": false, "scope": "pane", "setting": false, "choices": null, "doc": "Run the file's language indexer at its project root, writing the index.scip the language words ask first."},
{"name": "Joincol", "leader": "SPC c j", "also": ["topbar"], "arg": false, "scope": "root", "setting": false, "choices": null, "doc": "Fold the active pane's column into the one on its right, keeping its panes."},
diff --git a/docs/typ/reference.typ b/docs/typ/reference.typ
index 22d68c99..1544ddb6 100644
--- a/docs/typ/reference.typ
+++ b/docs/typ/reference.typ
@@ -368,7 +368,7 @@ task while the editor waits in its syscall.
Reading #file("/ctl") gives every setting, one a line, in the words a write
takes (#word("Theme") `orchard`, #word("Verbose") `on`, #word("DumpDir") `<dir>`,
#word("Shell") `/bin/bash`, ...), as #word("DumpConfig") does, and one the
-frontend lacks as a comment (`# Lift unsupported`), so writing back what it
+frontend lacks as a comment (`# GripWidth unsupported`), so writing back what it
reads changes nothing.
Writes take settings and session builtins (`scope = .session` in
`src/builtins.zig`), acting at the pane with the keyboard:
@@ -376,7 +376,7 @@ Writes take settings and session builtins (`scope = .session` in
- A setting written bare steps to its next value (a switch flips). A
value it does not take is `bad value in control message; ...` naming what it takes;
#file("/commands") lists them. A setting the frontend cannot show is
- refused (`Lift is GUI-only, invalid here`).
+ refused (`GripWidth is GUI-only, invalid here`).
- #word("Newcol") makes an empty column right of the keyboard's, halving
it. #word("Joincol") folds the keyboard's column into the one on its
right (its panes go below that column's), `Joincol: no column to the right`.
@@ -419,8 +419,8 @@ runs fails with the editor's words (`Mount: already mounted`, `Save /root/x: acc
== Settings <settings>
-A setting that chooses among words (`on`/`off` switches, #word("Lift"),
-#word("Motion")) steps to its next value when given bare, as its
+A setting that chooses among words (`on`/`off` switches, #word("Motion"))
+steps to its next value when given bare, as its
word clicked in a tag does. The same lines go in the startup file
(#doc("config")).
@@ -465,11 +465,9 @@ turning it off: #word("PanelSlide"), #word("PanelZoom"),
#word("PanelDissolve"), #word("PanelAscii"), #word("PanelVertical"),
#word("PanelEdges"), #word("PanelFall"), #word("PanelWave"),
#word("PanelCurtain"), #word("PanelScramble"), #word("PanelType"); all
-start off, and the web shell has none. The
-focused pane can stand off the page: #word("Lift") `shadow|rim|auto|off`,
-#word("InactiveDim") `<percent>`, #word("Motion") `off|crisp|smooth|bouncy|playful` (default
-`smooth`), #word("Parallax"), #word("CursorBlink"), #word("GripWidth") `<50-300>`. Most are
-the GUI's; #word("InactiveDim") works everywhere. No effect
+start off, and the web shell has none. #word("Motion")
+`off|crisp|smooth|bouncy|playful` (default `smooth`), #word("Parallax"),
+#word("CursorBlink"), #word("GripWidth") `<50-300>`, the GUI's. No effect
may lower the contrast of text, the selection or a focus indicator.
Resting the pointer on text for about 32 ms (`look_preview_delay_frames`,