diff --git a/README.md b/README.md index 7d59325..775824c 100644 --- a/README.md +++ b/README.md @@ -10,7 +10,7 @@ pairing with smart people at Hashrocket. For a steady stream of TILs, [sign up for my newsletter](https://crafty-builder-6996.ck.page/e169c61186). -_1635 TILs and counting..._ +_1636 TILs and counting..._ See some of the other learning resources I work on: - [Ruby Operator Lookup](https://www.visualmode.dev/ruby-operators) @@ -1620,6 +1620,7 @@ If you've learned something here, support my efforts writing daily TILs by - [Load Env Vars In Bash Script](unix/load-env-vars-in-bash-script.md) - [Look Through All Files That Have Been Git Stashed](unix/look-through-all-files-that-have-been-git-stashed.md) - [Make Direnv Less Noisy](unix/make-direnv-less-noisy.md) +- [Make Neovim The Default Way To View Man Pages](unix/make-neovim-the-default-way-to-view-man-pages.md) - [Manually Pass Two Git Files To Delta](unix/manually-pass-two-git-files-to-delta.md) - [Map A Domain To localhost](unix/map-a-domain-to-localhost.md) - [Negative Look-Ahead Search With ripgrep](unix/negative-look-ahead-search-with-ripgrep.md) diff --git a/unix/make-neovim-the-default-way-to-view-man-pages.md b/unix/make-neovim-the-default-way-to-view-man-pages.md new file mode 100644 index 0000000..aed49ef --- /dev/null +++ b/unix/make-neovim-the-default-way-to-view-man-pages.md @@ -0,0 +1,26 @@ +# Make Neovim The Default Way To View Man Pages + +I was reading the help page for `:Man` which is the built-in plugin to Neovim +for viewing man pages within a Neovim session. In it, they mentioned that the +`MANPAGER` can be set to use Neovim instead of the default man page viewer. + +This can be done by setting `MANPAGER` like so: + +```bash +$ export MANPAGER='nvim +Man!' +``` + +After setting this, you can run something like `man git-restore` which will +open the man page for that command in a Neovim session using the Man page +plugin which can do things like follow links to other man pages (`K` or +`Ctrl=]`), quit by hitting `q`, as well as all the motions and search behavior +of Vim. + +For long-term use, this can be set in your shell config, e.g. `~/.zshrc`. For +one-off use, you can include it as an env var for a single call to `man`: + +```bash +MANPAGER='nvim +Man!' man git-restore +``` + +See `:h :Man` within a Neovim session for more details.