summaryrefslogtreecommitdiff
path: root/docs/typ/reference.typ
diff options
context:
space:
mode:
Diffstat (limited to 'docs/typ/reference.typ')
-rw-r--r--docs/typ/reference.typ9
1 files changed, 3 insertions, 6 deletions
diff --git a/docs/typ/reference.typ b/docs/typ/reference.typ
index a0452e5b..c9e117e8 100644
--- a/docs/typ/reference.typ
+++ b/docs/typ/reference.typ
@@ -430,7 +430,7 @@ 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("Pager"))
+A setting that chooses among words (`on`/`off` switches, #word("Pet"))
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")).
@@ -440,11 +440,8 @@ word clicked in a tag does. The same lines go in the startup file
[#word("ThemeFile") `<path>`], [a `.zon` theme, relative to the config directory; reloads live when saved],
[#word("Verbose")], [on: a builtin announces its name on the message row],
[#word("MessageLinger")], [800 milliseconds, at most 60000: how long a message stays after the key or click that dismisses it],
- [#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("JumpScope") `file|all`], [`file`: #word("Back") and #word("Forward") keep to the focused pane's file, that pane's places first, then the file's in another pane, and go to another file only when the file has no place left that way; from a terminal or a pane with no file they step through every place; `all`: every place, in the order it was jumped to],
- [#word("TermImages") `real|petscii`], [`real`: a new terminal draws its program's kitty graphics (yazi's previews) as pixels where the shell can; #word("Petscii") flips one terminal; a tui under a terminal without kitty graphics draws them as glyph art either way],
[#word("Shell") `<name or path>`], [`$SHELL` when it is executable, else `/bin/sh`: the shell the next terminal and command pane run; a bare name is searched for in the usual bin directories, not `$PATH`; bare #word("Shell"): `$SHELL` if it is executable, else `/bin/sh`],
[#word("DumpDir") `<dir>`], [`$XDG_DATA_HOME/pardes`, else `~/.local/share/pardes`: the directory of the state file, `pardes.xitdb`, which keeps Recent and the dumps and which every session of the user shares (one that cannot be read as one is kept aside as `pardes.xitdb.broken` and a new one started); an absolute or `~` path to a directory that may be written (made if missing); a relative one, or one under a directory that may not be written, is refused; bare returns to the default],
[#word("TreeContext")], [off: sticky declaration headers in a source pane, in the tagline style (per pane, dumped)],
@@ -1091,7 +1088,7 @@ to its end before the write is answered, and one that finds nothing fails,
the directory, left clean, opening at its top, with no line numbers; a
`+Pager` already there keeps its page. The session parses the text with
ghostty-vt: SGR colours become the `+Pager`'s own display, never part of
-its body or any read (#word("PagerColor") `off` pages plain), mapped
+its body or any read, mapped
through the theme as a terminal's are until its #word("Filter") shows them
as sent; every other escape is dropped; a carriage return keeps a progress line's last state,
and CRLF becomes LF. Empty stdin shows nothing. Inside a pardes pane it returns at once; a text the session cannot
@@ -1101,7 +1098,7 @@ directory's. Outside a pardes pane it starts a new editor whose first pane
the text is. Stdin up to a file's limit (256 MiB) arrives whole; past that
it is cut, with a note saying so.
-With #word("Pager") `pardes`, a terminal's shell gets `PAGER`, `GIT_PAGER` and
+A terminal's shell gets `PAGER`, `GIT_PAGER` and
`SYSTEMD_PAGER` set to this pardes plus ` -` (the path quoted only when it
needs it), and `SYSTEMD_PAGERSECURE=0` (it has no shell escape), each only
where your environment does not set it. `man` pages through `MANPAGER`