1
0
mirror of https://github.com/jbranchaud/til synced 2026-07-05 17:00:17 +00:00

Add Browse And Search Help Docs as a Unix TIL

This commit is contained in:
jbranchaud
2026-03-21 12:34:49 -05:00
parent c744117eff
commit c1cd40311f
2 changed files with 24 additions and 1 deletions
+22
View File
@@ -0,0 +1,22 @@
# Browse And Search Help Docs
There are a lot of tools that don't have dedicated `man` pages, but do have
lengthy output when you pass them the `--help` flag.
We can make those details easier to browse and searchable by piping them to
`less`.
```bash
uv run pytest --help | less
```
First, we see the top of the output inside `less` instead of bottom of the
output right above our next terminal prompt.
From `less`, we can use down and up arrows (or `j` and `k`) to navigate through
the details. We can also jump to a specific word or phrase by searching -- type
`/` and then the pattern we're trying to match. `n` and `N` to go to the next or
previous match, respectively.
See `man less` more more details. And if you like these improvements to viewing
tool usage details, you may also be interested in [a better man page viewer](https://www.visualmode.dev/a-better-man-page-viewer).