summaryrefslogtreecommitdiff
path: root/docs/typ/reference.typ
diff options
context:
space:
mode:
authorGabriel Schneider <[email protected]>2026-10-21 21:30:24 -0300
committerGabriel Schneider <[email protected]>2026-10-22 10:03:15 -0300
commit4e89db185fa4e3bfe4358d2da3b76fad0cc7e547 (patch)
tree7fe3609df076281e15a70520fb5bb8fb9714ca78 /docs/typ/reference.typ
parent02841e214442c7a602877883425757b0dab3f924 (diff)
downloadpardes-4e89db185fa4e3bfe4358d2da3b76fad0cc7e547.tar.gz
pardes-4e89db185fa4e3bfe4358d2da3b76fad0cc7e547.zip
Esc in a raw terminal is pardes's; Shift-Esc goes to the program (ProgramEsc)
Diffstat (limited to 'docs/typ/reference.typ')
-rw-r--r--docs/typ/reference.typ3
1 files changed, 2 insertions, 1 deletions
diff --git a/docs/typ/reference.typ b/docs/typ/reference.typ
index 05176951..455d2645 100644
--- a/docs/typ/reference.typ
+++ b/docs/typ/reference.typ
@@ -415,6 +415,7 @@ word clicked in a tag does. The same lines go in the startup file
[#word("MessageAnimation")], [on: messages ease in and dissolve],
[#word("MessageLinger"), #word("MessageFall"), #word("MessageDissolve")], [800, 180, 150 milliseconds, at most 60000],
[#word("PagerColor")], [on: the next paged text keeps its colours],
+ [#word("ProgramEsc")], [off: in a raw terminal #key("Esc") goes back a pane and #key("Shift-Esc") is the program's Esc; on swaps them, and #key("Esc") goes back only at an empty shell prompt],
[#word("Pager") `pardes|off`], [`pardes`: what a terminal's commands page through, `pardes -`; `off` leaves `PAGER`, `GIT_PAGER` and `SYSTEMD_PAGER` as the environment has them (#doc("fs", section: "pardes-stdin")). It applies to terminals started after it],
[#word("Placement") `acme|pardes`], [`acme`: where new panes go (#doc("fs", section: "placement"))],
[#word("BootShell") `keep|replace`], [`keep`; `replace` closes the untouched lone shell a dragged document lands beside],
@@ -969,7 +970,7 @@ it was.
= On screen <on-screen>
-- *Esc at a prompt.* pardes knows a shell prompt with nothing typed on it
+- *Esc at a prompt* (with #word("ProgramEsc") on). pardes knows a shell prompt with nothing typed on it
from the OSC 133 marks it injects into bash and fish (marks a shell sends
itself do not count); for other shells, from no program holding the
terminal, typed text or not.