The docs take round 31: one +Pager per directory and how pardes - cleans its text, SYSTEMD_PAGER, a paged diff drawn as one, event reads in pieces, sel, write-back origins, +PdfSections rows, a PDF body by lines, bare :N looks and quoted bad values

Co-Authored-By: Claude Opus 5.5 <[email protected]>

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>