Read Unix man pages faster than a speeding bullet!
Clone or download
timfeirg and jez Remove 'setlocal number' (prefer ~/.vim/after/...) (#18)
It's probably best to remove this setting actually. I first made this plugin because I didn't really understand how Vim config worked. A better solution from the get-go would have been to move `setlocal number` from this plugin to `~/.vim/after/ftplugin/man.vim`.
Latest commit 0d79563 Jul 1, 2018
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
bin allow overriding editor name (#17) Jul 1, 2018
plugin Remove 'setlocal number' (prefer ~/.vim/after/...) (#18) Jul 1, 2018
.gitignore allow overriding editor name (#17) Jul 1, 2018
LICENSE Added LICENSE Dec 21, 2014
README.md Disambiguate an FAQ (#15) Jan 11, 2018

README.md

Vim SuperMan

Read Unix 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 plugin ($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.

Installation

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 .bashrc, .bash_profile, .zshrc, or whatever file you use to configure your shell:

export PATH="$PATH:$HOME/.vim/bundle/vim-superman/bin"

(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

compdef vman="man"

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.)

Usage

This predominantly a command line tool. To open the man page for vim:

$ vman vim

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.

vman 3 printf

FAQ

For more information, see the associated blog post.

Jake, why not just name the bash function man?

The actual man command supports many more features than the Vim plugin does (for a complete list, see man(1)). If you shadow the real man command, 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.

License

MIT License. See LICENSE.