1
0
mirror of https://github.com/jbranchaud/til synced 2026-07-02 23:58:25 +00:00
Files
til/unix/browse-and-search-help-docs.md
T
2026-03-21 12:34:49 -05:00

23 lines
895 B
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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).