man.vim: convert ftplugin to actual plugin.

- do not create leader maps
- :norm! instead of :norm
- :keepjumps during layout
- use blackhole reg to avoid polluting unnamed reg
- format buffer name as "man://foo(2)"
- simulate behavior of `man`
    - buffer-local mapping of q to quit
    - open in new tab instead of new window
    - set 'nolist'
    - set tabstop=8

1 files changed, 134 insertions, 0 deletions

diff --git a/runtime/autoload/man.vim b/runtime/autoload/man.vim
new file mode 100644
index 0000000000..885d77b645
--- /dev/null
+++ b/runtime/autoload/man.vim
@@ -0,0 +1,134 @@
+let s:man_tag_depth = 0
+let s:man_sect_arg = ''
+let s:man_find_arg = '-w'
+
+try
+  if !has('win32') && $OSTYPE !~? 'cygwin\|linux' && system('uname -s') =~? 'SunOS' && system('uname -r') =~? '^5'
+    let s:man_sect_arg = '-s'
+    let s:man_find_arg = '-l'
+  endif
+catch /E145:/
+  " Ignore the error in restricted mode
+endtry
+
+function man#pre_get_page(cnt)
+  if a:cnt == 0
+    let old_isk = &iskeyword
+    if &ft == 'man'
+      setlocal iskeyword+=(,)
+    endif
+    let str = expand('<cword>')
+    let &l:iskeyword = old_isk
+    let page = substitute(str, '(*\(\k\+\).*', '\1', '')
+    let sect = substitute(str, '\(\k\+\)(\([^()]*\)).*', '\2', '')
+    if match(sect, '^[0-9 ]\+$') == -1
+      let sect = ''
+    endif
+    if sect == page
+      let sect = ''
+    endif
+  else
+    let sect = a:cnt
+    let page = expand('<cword>')
+  endif
+  call man#get_page(sect, page)
+endfunction
+
+function man#get_page(...)
+  if a:0 >= 2
+    let sect = a:1
+    let page = a:2
+  elseif a:0 >= 1
+    let sect = ''
+    let page = a:1
+  else
+    return
+  endif
+
+  " To support:	    nmap K :Man <cword>
+  if page == '<cword>'
+    let page = expand('<cword>')
+  endif
+
+  if sect != '' && s:FindPage(sect, page) == 0
+    let sect = ''
+  endif
+  if s:FindPage(sect, page) == 0
+    echo "\nNo manual entry for '".page."'"
+    return
+  endif
+  exec 'let s:man_tag_buf_'.s:man_tag_depth.' = '.bufnr('%')
+  exec 'let s:man_tag_lin_'.s:man_tag_depth.' = '.line('.')
+  exec 'let s:man_tag_col_'.s:man_tag_depth.' = '.col('.')
+  let s:man_tag_depth = s:man_tag_depth + 1
+
+  " Use an existing "man" window if it exists, otherwise open a new one.
+  if &filetype != 'man'
+    let thiswin = winnr()
+    exe "norm! \<C-W>b"
+    if winnr() > 1
+      exe "norm! " . thiswin . "\<C-W>w"
+      while 1
+        if &filetype == 'man'
+          break
+        endif
+        exe "norm! \<C-W>w"
+        if thiswin == winnr()
+          break
+        endif
+      endwhile
+    endif
+    if &filetype != 'man'
+      tabnew
+      " window-local options
+      setlocal foldcolumn=0 nonumber nolist norelativenumber nofoldenable
+    endif
+  endif
+  silent exec 'edit man://'.page.(empty(sect)?'':'('.sect.')')
+
+  setlocal modifiable
+  silent keepjumps norm! 1G"_dG
+  let $MANWIDTH = winwidth(0)
+  silent exec 'r!/usr/bin/man '.s:GetCmdArg(sect, page).' | col -b'
+  " Remove blank lines from top and bottom.
+  while getline(1) =~ '^\s*$'
+    silent keepjumps norm! gg"_dd
+  endwhile
+  while getline('$') =~ '^\s*$'
+    silent keepjumps norm! G"_dd
+  endwhile
+  setlocal filetype=man
+endfunction
+
+function man#pop_page()
+  if s:man_tag_depth > 0
+    let s:man_tag_depth = s:man_tag_depth - 1
+    exec "let s:man_tag_buf=s:man_tag_buf_".s:man_tag_depth
+    exec "let s:man_tag_lin=s:man_tag_lin_".s:man_tag_depth
+    exec "let s:man_tag_col=s:man_tag_col_".s:man_tag_depth
+    exec s:man_tag_buf."b"
+    exec s:man_tag_lin
+    exec "norm! ".s:man_tag_col."|"
+    exec "unlet s:man_tag_buf_".s:man_tag_depth
+    exec "unlet s:man_tag_lin_".s:man_tag_depth
+    exec "unlet s:man_tag_col_".s:man_tag_depth
+    unlet s:man_tag_buf s:man_tag_lin s:man_tag_col
+  endif
+endfunction
+
+function s:GetCmdArg(sect, page)
+  if a:sect == ''
+    return a:page
+  endif
+  return s:man_sect_arg.' '.a:sect.' '.a:page
+endfunction
+
+function s:FindPage(sect, page)
+  let where = system('/usr/bin/man '.s:man_find_arg.' '.s:GetCmdArg(a:sect, a:page))
+  if where !~ "^/"
+    if matchstr(where, " [^ ]*$") !~ "^ /"
+      return 0
+    endif
+  endif
+  return 1
+endfunction