" With these, you can type "K" when you are over a perl term
" in your code, and it will look it up with "perldoc -f $term"
" what I would like to happen is this: perldoc -f term || perldoc term
" So, it tries to look up the keyword as a perl function 
" and then it tries to look it up as a module name if that fails 
au BufRead,BufNewFile *.pm setlocal keywordprg=perldoc\ -f
au BufRead,BufNewFile *.pl setlocal keywordprg=perldoc\ -f
au BufRead,BufNewFile *.cgi setlocal keywordprg=perldoc\ -f

" You'll have to check for the location of efm_perl.pl on your system
" With this, you can use ":mak", and will run your script through
" 'perl -cw' and allow you to easily edit the results
set makeprg=/usr/local/share/vim/vim61/tools/efm_perl.pl\ -c\ %\ $*
set errorformat=%f:%l:%m
[download]

You may also be interested in My Life with Text Editors

-mark