A Vim plugin to make it easier to use as $MANPAGER
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
after/syntax
ftdetect
ftplugin
LICENSE
README.md

README.md

vim-manpager

A plugin that makes it easier to use Vim is $MANPAGER.

It:

  1. Removes the backspaces added by man, and marks the removals is with 0x01 and 0x02 characters.
  2. It uses these markers to do syntax highlighting, and adds them to iskeyword so that *-searching for highlighted terms only match highlighted commands.
  3. Syntax highlighting for a few more types than the default syntax/man.vim (options, environment variables, man-highlighted manpages, section headings, etc.).
  4. Maps K and Enter to open referenced manpages.

After installing it, set MANPAGER=vim - in a suitable place for environment variables:

  1. ~/.pam_environment:

    MANPAGER='vim -'
  2. ~/.profile:

    MANPAGER='vim -'
    export MANPAGER

(And so on….)

Right now, it doesn't have any configurable settings.

Another possibility for MANPAGER is:

MANPAGER='env "MAN_PN=$MAN_PN" vim -'

Notes

MANWIDTH

If you have set number or similar settings which might take part of the display width, you might want to set MANWIDTH to a value less than COLUMNS. I use a wide terminal almost always, so I keep a fixed MANWIDTH:

MANWIDTH=80

Because of concealed characters, side-scrolling can be ugly.

Vim's default manpage settings

Vim has configuration and some syntax highlighting. It adds mappings for <c-]> and <c-t>, approximating tag navigation for manpages. I've left those alone, for now.