annotate runtime/ftplugin/man.vim @ 4023:b5103b7d9e12 v7.3.766

updated for version 7.3.766 Problem: ":help cpo-*" jumps to the wrong place. Solution: Make it equivalent to ":help cpo-star".
author Bram Moolenaar <bram@vim.org>
date Thu, 17 Jan 2013 14:09:44 +0100
parents 94601b379f38
children 050893d44c33
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1 " Vim filetype plugin file
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
2 " Language: man
2034
7bc41231fbc7 Update runtime files.
Bram Moolenaar <bram@zimbu.org>
parents: 1623
diff changeset
3 " Maintainer: SungHyun Nam <goweol@gmail.com>
3410
94601b379f38 Updated runtime files. Add Dutch translations.
Bram Moolenaar <bram@vim.org>
parents: 3082
diff changeset
4 " Last Change: 2012 Mar 6
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
5
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6 " To make the ":Man" command available before editing a manual page, source
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
7 " this script from your startup vimrc file.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
8
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9 " If 'filetype' isn't "man", we must have been called to only define ":Man".
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
10 if &filetype == "man"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12 " Only do this when not done yet for this buffer
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13 if exists("b:did_ftplugin")
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14 finish
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
15 endif
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
16 let b:did_ftplugin = 1
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
17
2662
916c90b37ea9 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2034
diff changeset
18 " Ensure Vim is not recursively invoked (man-db does this)
916c90b37ea9 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2034
diff changeset
19 " when doing ctrl-[ on a man page reference.
3082
3502a7f991fc Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2662
diff changeset
20 if exists("$MANPAGER")
3502a7f991fc Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2662
diff changeset
21 let $MANPAGER = ""
3502a7f991fc Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2662
diff changeset
22 endif
2662
916c90b37ea9 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2034
diff changeset
23
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
24 " allow dot and dash in manual page name.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
25 setlocal iskeyword+=\.,-
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
26
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
27 " Add mappings, unless the user didn't want this.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
28 if !exists("no_plugin_maps") && !exists("no_man_maps")
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
29 if !hasmapto('<Plug>ManBS')
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
30 nmap <buffer> <LocalLeader>h <Plug>ManBS
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
31 endif
816
4a79d6d376f0 updated for version 7.0c02
vimboss
parents: 7
diff changeset
32 nnoremap <buffer> <Plug>ManBS :%s/.\b//g<CR>:setl nomod<CR>''
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
33
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
34 nnoremap <buffer> <c-]> :call <SID>PreGetPage(v:count)<CR>
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
35 nnoremap <buffer> <c-t> :call <SID>PopPage()<CR>
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
36 endif
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
37
3410
94601b379f38 Updated runtime files. Add Dutch translations.
Bram Moolenaar <bram@vim.org>
parents: 3082
diff changeset
38 let b:undo_ftplugin = "setlocal iskeyword<"
94601b379f38 Updated runtime files. Add Dutch translations.
Bram Moolenaar <bram@vim.org>
parents: 3082
diff changeset
39
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
40 endif
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
41
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
42 if exists(":Man") != 2
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
43 com -nargs=+ Man call s:GetPage(<f-args>)
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
44 nmap <Leader>K :call <SID>PreGetPage(0)<CR>
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
45 endif
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
46
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
47 " Define functions only once.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
48 if !exists("s:man_tag_depth")
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
49
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
50 let s:man_tag_depth = 0
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
51
1623
53938adac247 updated for version 7.2a
vimboss
parents: 1125
diff changeset
52 let s:man_sect_arg = ""
53938adac247 updated for version 7.2a
vimboss
parents: 1125
diff changeset
53 let s:man_find_arg = "-w"
53938adac247 updated for version 7.2a
vimboss
parents: 1125
diff changeset
54 try
53938adac247 updated for version 7.2a
vimboss
parents: 1125
diff changeset
55 if !has("win32") && $OSTYPE !~ 'cygwin\|linux' && system('uname -s') =~ "SunOS" && system('uname -r') =~ "^5"
53938adac247 updated for version 7.2a
vimboss
parents: 1125
diff changeset
56 let s:man_sect_arg = "-s"
53938adac247 updated for version 7.2a
vimboss
parents: 1125
diff changeset
57 let s:man_find_arg = "-l"
53938adac247 updated for version 7.2a
vimboss
parents: 1125
diff changeset
58 endif
53938adac247 updated for version 7.2a
vimboss
parents: 1125
diff changeset
59 catch /E145:/
53938adac247 updated for version 7.2a
vimboss
parents: 1125
diff changeset
60 " Ignore the error in restricted mode
53938adac247 updated for version 7.2a
vimboss
parents: 1125
diff changeset
61 endtry
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
62
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
63 func <SID>PreGetPage(cnt)
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
64 if a:cnt == 0
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
65 let old_isk = &iskeyword
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
66 setl iskeyword+=(,)
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
67 let str = expand("<cword>")
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
68 let &l:iskeyword = old_isk
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
69 let page = substitute(str, '(*\(\k\+\).*', '\1', '')
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
70 let sect = substitute(str, '\(\k\+\)(\([^()]*\)).*', '\2', '')
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
71 if match(sect, '^[0-9 ]\+$') == -1
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
72 let sect = ""
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
73 endif
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
74 if sect == page
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
75 let sect = ""
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
76 endif
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
77 else
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
78 let sect = a:cnt
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
79 let page = expand("<cword>")
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
80 endif
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
81 call s:GetPage(sect, page)
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
82 endfunc
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
83
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
84 func <SID>GetCmdArg(sect, page)
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
85 if a:sect == ''
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
86 return a:page
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
87 endif
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
88 return s:man_sect_arg.' '.a:sect.' '.a:page
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
89 endfunc
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
90
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
91 func <SID>FindPage(sect, page)
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
92 let where = system("/usr/bin/man ".s:man_find_arg.' '.s:GetCmdArg(a:sect, a:page))
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
93 if where !~ "^/"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
94 if matchstr(where, " [^ ]*$") !~ "^ /"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
95 return 0
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
96 endif
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
97 endif
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
98 return 1
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
99 endfunc
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
100
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
101 func <SID>GetPage(...)
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
102 if a:0 >= 2
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
103 let sect = a:1
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
104 let page = a:2
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
105 elseif a:0 >= 1
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
106 let sect = ""
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
107 let page = a:1
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
108 else
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
109 return
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
110 endif
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
111
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
112 " To support: nmap K :Man <cword>
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
113 if page == '<cword>'
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
114 let page = expand('<cword>')
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
115 endif
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
116
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
117 if sect != "" && s:FindPage(sect, page) == 0
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
118 let sect = ""
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
119 endif
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
120 if s:FindPage(sect, page) == 0
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
121 echo "\nCannot find a '".page."'."
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
122 return
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
123 endif
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
124 exec "let s:man_tag_buf_".s:man_tag_depth." = ".bufnr("%")
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
125 exec "let s:man_tag_lin_".s:man_tag_depth." = ".line(".")
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
126 exec "let s:man_tag_col_".s:man_tag_depth." = ".col(".")
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
127 let s:man_tag_depth = s:man_tag_depth + 1
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
128
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
129 " Use an existing "man" window if it exists, otherwise open a new one.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
130 if &filetype != "man"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
131 let thiswin = winnr()
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
132 exe "norm! \<C-W>b"
1125
96cd8222a819 updated for version 7.1a
vimboss
parents: 816
diff changeset
133 if winnr() > 1
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
134 exe "norm! " . thiswin . "\<C-W>w"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
135 while 1
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
136 if &filetype == "man"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
137 break
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
138 endif
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
139 exe "norm! \<C-W>w"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
140 if thiswin == winnr()
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
141 break
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
142 endif
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
143 endwhile
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
144 endif
1125
96cd8222a819 updated for version 7.1a
vimboss
parents: 816
diff changeset
145 if &filetype != "man"
96cd8222a819 updated for version 7.1a
vimboss
parents: 816
diff changeset
146 new
96cd8222a819 updated for version 7.1a
vimboss
parents: 816
diff changeset
147 setl nonu fdc=0
96cd8222a819 updated for version 7.1a
vimboss
parents: 816
diff changeset
148 endif
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
149 endif
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
150 silent exec "edit $HOME/".page.".".sect."~"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
151 " Avoid warning for editing the dummy file twice
816
4a79d6d376f0 updated for version 7.0c02
vimboss
parents: 7
diff changeset
152 setl buftype=nofile noswapfile
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
153
816
4a79d6d376f0 updated for version 7.0c02
vimboss
parents: 7
diff changeset
154 setl ma
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
155 silent exec "norm 1GdG"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
156 let $MANWIDTH = winwidth(0)
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
157 silent exec "r!/usr/bin/man ".s:GetCmdArg(sect, page)." | col -b"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
158 " Remove blank lines from top and bottom.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
159 while getline(1) =~ '^\s*$'
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
160 silent norm ggdd
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
161 endwhile
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
162 while getline('$') =~ '^\s*$'
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
163 silent norm Gdd
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
164 endwhile
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
165 1
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
166 setl ft=man nomod
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
167 setl bufhidden=hide
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
168 setl nobuflisted
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
169 endfunc
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
170
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
171 func <SID>PopPage()
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
172 if s:man_tag_depth > 0
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
173 let s:man_tag_depth = s:man_tag_depth - 1
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
174 exec "let s:man_tag_buf=s:man_tag_buf_".s:man_tag_depth
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
175 exec "let s:man_tag_lin=s:man_tag_lin_".s:man_tag_depth
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
176 exec "let s:man_tag_col=s:man_tag_col_".s:man_tag_depth
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
177 exec s:man_tag_buf."b"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
178 exec s:man_tag_lin
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
179 exec "norm ".s:man_tag_col."|"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
180 exec "unlet s:man_tag_buf_".s:man_tag_depth
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
181 exec "unlet s:man_tag_lin_".s:man_tag_depth
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
182 exec "unlet s:man_tag_col_".s:man_tag_depth
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
183 unlet s:man_tag_buf s:man_tag_lin s:man_tag_col
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
184 endif
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
185 endfunc
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
186
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
187 endif
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
188
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
189 " vim: set sw=2: