diff options
Diffstat (limited to 'docs/typ/setup.typ')
| -rw-r--r-- | docs/typ/setup.typ | 26 |
1 files changed, 14 insertions, 12 deletions
diff --git a/docs/typ/setup.typ b/docs/typ/setup.typ index 194156f8..60ea33cd 100644 --- a/docs/typ/setup.typ +++ b/docs/typ/setup.typ @@ -75,18 +75,20 @@ command line with Ctrl-O in fish instead, add `bind ctrl-o edit_command_buffer` = A pager <pager> -`pardes -` reads its standard input into a `+Pager` pane, escapes -stripped. Terminals get `PAGER` and `GIT_PAGER` set to it (this pardes's -own path, then `-`) by themselves unless your environment sets them, so -`git log` or `man` output arrives as a pane to search and click in, and -the terminal is back at once; command panes page through `cat`. `man` -reads `MANPAGER` before `PAGER`, and pardes never sets `MANPAGER`, so a -`MANPAGER` of yours sends man pages there. A `MANPAGER`, `PAGER` or -`GIT_PAGER` of your own always wins over pardes's. To keep your own pager, -either set `PAGER` in your environment, or put `Pager off` -in the startup file (or write it to the root ctl); it applies to terminals -started after it. Outside pardes, `PAGER='pardes -'` opens a new editor on -the text. +`pardes -` reads its standard input into the directory's one `+Pager` +pane, escapes stripped, and returns; the next paged text refills it. With +`Pager pardes` (the default) 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. So `git log`, `journalctl` or +`man` output arrives as a pane to search and click in, a diff (`git diff`, +`git show`, `git log -p`) drawn as one, and the terminal is back at once; +command panes page through `cat`. `man` pages through `MANPAGER` first, +then `PAGER`, and pardes never sets `MANPAGER`: your own `MANPAGER` wins, +as does any `PAGER`, `GIT_PAGER` or `SYSTEMD_PAGER` of yours. To keep your +own pager, set it in your environment, or put `Pager off` in the startup +file (or write it to the root ctl); it applies to terminals started after +it. Outside pardes, `PAGER='pardes -'` opens a new editor on the text. = yazi in a terminal pane <yazi> |