man pages faster than a speeding bullet!
Unix man pages by default open with the
less pager. Getting them to open with
Vim can be a little bit of a pain, but in recent versions of Vim there's a
$VIMRUNTIME/ftplugin/man.vim) that makes this easy.
This is a simple Vim plugin and sh function that makes replacing
man from the
command line a cinch.
Use your favorite plugin manager. If you don't have one, I'd recommend Vundle, though you should probably also take a look at Pathogen, as it's more common.
# if your ~/.vim folder isn't under source control: git clone https://github.com/jez/vim-superman ~/.vim/bundle/vim-superman # if your ~/.vim folder is under source control: git submodule add https://github.com/jez/vim-superman ~/.vim/bundle/vim-superman
Then, add the following to your
whatever file you use to configure your shell:
(Note: you'll have to change this location if you installed Vim SuperMan somewhere else.)
Close and reopen your terminal and you're set! You can even add
to your ~/.zshrc or
complete -o default -o nospace -F _man vman
to your ~/.bashrc to get tab completion. (Thanks to texasflood for the Bash completion snippet.)
This predominantly a command line tool. To open the man page for
$ vman vim
It's that simple. The underlying
:Man command supports specifying a specific
section, so you could also do something like
$ vman 3 printf
To see the man page for the C
printf() library call.
For more information, see the associated blog post.
Jake, why not just name the bash function
man command supports many more features than the Vim plugin does
(for a complete list, see
man(1)). If you shadow the real
things start to break, for example
apropos, which uses
man under the hood.
When I install
vim-superman it looks nothing like this!
There are a couple other plugins of mine featured prominently here, including Solarized Dark for the color scheme and Vim Airline for the statusbar. If you're curious about my whole setup, be sure to check out my dotfiles repository.
MIT License. See LICENSE.