diff options
| author | Kaz Kylheku <kaz@kylheku.com> | 2025-01-22 20:19:59 -0800 |
|---|---|---|
| committer | Kaz Kylheku <kaz@kylheku.com> | 2025-01-22 20:19:59 -0800 |
| commit | 17ceb21ae7b8b3e7f82d2d4a1c959c34688f50c6 (patch) | |
| tree | deb108d2d59305c06ee55435a1761de4777ce14b | |
| parent | 9b9d97f08687652b597456e8ed36b9bda6780c51 (diff) | |
| download | mnpgr-master.tar.gz mnpgr-master.tar.bz2 mnpgr-master.zip | |
| -rw-r--r-- | README.md | 24 |
1 files changed, 24 insertions, 0 deletions
@@ -74,4 +74,28 @@ The question is specifically about saving the last position. If Vim alone is used as a pager without a shim script between it and `man`, it will not save the last position. +## Troubleshooting +### I see terminal escape sequences in the output! + +This is an issue in some installations of the `man` program from +`man-db`, whereby it is not setting the environment variable +`GROFF_NO_SGR=1` to prevent GNU `groff` from emitting terminal +escapes. Try exporting that environment variable; if the problem goes +away, that is it. + +### I see an error `@page(@section) ... failed to match` + +You are on some Unix system like MacOS; `mnpgr` currently only +works with the `man` program from `man-db` commonly installed +on may GNU/Linux systems, namely +[this one]( https://gitlab.com/man-db/man-db). + +Sorry! + +That implementation of `man` establishes a `MAN_PN` environment +variable whose value we are depending on to get name of the +man page and section number. + +A patch to make `mngpr` work with other `man` implementations +would be welcome. |