git-svn-id: https://vimsuite.svn.sourceforge.net/svnroot/vimsuite/trunk@192 eb2d0018-73a3-4aeb-bfe9-1def61c9ec69
918 lines
34 KiB
VimL
918 lines
34 KiB
VimL
" tcomment.vim
|
||
" @Author: Tom Link (mailto:micathom AT gmail com?subject=[vim])
|
||
" @Website: http://www.vim.org/account/profile.php?user_id=4037
|
||
" @License: GPL (see http://www.gnu.org/licenses/gpl.txt)
|
||
" @Created: 2007-09-17.
|
||
" @Last Change: 2010-09-29.
|
||
" @Revision: 0.0.249
|
||
|
||
" call tlog#Log('Load: '. expand('<sfile>')) " vimtlib-sfile
|
||
|
||
|
||
" If true, comment blank lines too
|
||
if !exists("g:tcommentBlankLines")
|
||
let g:tcommentBlankLines = 1
|
||
endif
|
||
|
||
" Guess the file type based on syntax names always or for some fileformat only
|
||
if !exists("g:tcommentGuessFileType")
|
||
let g:tcommentGuessFileType = 0
|
||
endif
|
||
" In php documents, the php part is usually marked as phpRegion. We thus
|
||
" assume that the buffers default comment style isn't php but html
|
||
if !exists("g:tcommentGuessFileType_dsl")
|
||
let g:tcommentGuessFileType_dsl = 'xml'
|
||
endif
|
||
if !exists("g:tcommentGuessFileType_php")
|
||
let g:tcommentGuessFileType_php = 'html'
|
||
endif
|
||
if !exists("g:tcommentGuessFileType_html")
|
||
let g:tcommentGuessFileType_html = 1
|
||
endif
|
||
if !exists("g:tcommentGuessFileType_tskeleton")
|
||
let g:tcommentGuessFileType_tskeleton = 1
|
||
endif
|
||
if !exists("g:tcommentGuessFileType_vim")
|
||
let g:tcommentGuessFileType_vim = 1
|
||
endif
|
||
|
||
if !exists("g:tcommentIgnoreTypes_php")
|
||
let g:tcommentIgnoreTypes_php = 'sql'
|
||
endif
|
||
|
||
if !exists('g:tcommentSyntaxMap') "{{{2
|
||
let g:tcommentSyntaxMap = {
|
||
\ 'vimMzSchemeRegion': 'scheme',
|
||
\ 'vimPerlRegion': 'perl',
|
||
\ 'vimPythonRegion': 'python',
|
||
\ 'vimRubyRegion': 'ruby',
|
||
\ 'vimTclRegion': 'tcl',
|
||
\ }
|
||
endif
|
||
|
||
" If you don't define these variables, TComment will use &commentstring
|
||
" instead. We override the default values here in order to have a blank after
|
||
" the comment marker. Block comments work only if we explicitly define the
|
||
" markup.
|
||
" The format for block comments is similar to normal commentstrings with the
|
||
" exception that the format strings for blocks can contain a second line that
|
||
" defines how "middle lines" (see :h format-comments) should be displayed.
|
||
|
||
" I personally find this style rather irritating but here is an alternative
|
||
" definition that does this left-handed bar thing
|
||
if !exists("g:tcommentBlockC")
|
||
let g:tcommentBlockC = {
|
||
\ 'commentstring': '/*%s */',
|
||
\ 'middle': ' * ',
|
||
\ 'rxbeg': '\*\+',
|
||
\ 'rxend': '\*\+',
|
||
\ 'rxmid': '\*\+',
|
||
\ }
|
||
endif
|
||
if !exists("g:tcommentBlockC2")
|
||
let g:tcommentBlockC2 = {
|
||
\ 'commentstring': '/**%s */',
|
||
\ 'middle': ' * ',
|
||
\ 'rxbeg': '\*\+',
|
||
\ 'rxend': '\*\+',
|
||
\ 'rxmid': '\*\+',
|
||
\ }
|
||
endif
|
||
if !exists("g:tcommentInlineC")
|
||
let g:tcommentInlineC = "/* %s */"
|
||
endif
|
||
|
||
if !exists("g:tcommentBlockXML")
|
||
let g:tcommentBlockXML = "<!--%s-->\n "
|
||
endif
|
||
if !exists("g:tcommentInlineXML")
|
||
let g:tcommentInlineXML = "<!-- %s -->"
|
||
endif
|
||
|
||
let s:typesDirty = 1
|
||
|
||
let s:definitions = {}
|
||
|
||
" Currently this function just sets a variable
|
||
function! tcomment#DefineType(name, commentdef)
|
||
if !has_key(s:definitions, a:name)
|
||
if type(a:commentdef) == 4
|
||
let cdef = copy(a:commentdef)
|
||
else
|
||
let cdef = a:0 >= 1 ? a:1 : {}
|
||
let cdef.commentstring = a:commentdef
|
||
endif
|
||
let s:definitions[a:name] = cdef
|
||
endif
|
||
let s:typesDirty = 1
|
||
endf
|
||
|
||
" Return 1 if a comment type is defined.
|
||
function! tcomment#TypeExists(name)
|
||
return has_key(s:definitions, a:name)
|
||
endf
|
||
|
||
call tcomment#DefineType('aap', '# %s' )
|
||
call tcomment#DefineType('ada', '-- %s' )
|
||
call tcomment#DefineType('apache', '# %s' )
|
||
call tcomment#DefineType('autoit', '; %s' )
|
||
call tcomment#DefineType('asm', '; %s' )
|
||
call tcomment#DefineType('awk', '# %s' )
|
||
call tcomment#DefineType('catalog', '-- %s --' )
|
||
call tcomment#DefineType('catalog_block', "--%s--\n " )
|
||
call tcomment#DefineType('cpp', '// %s' )
|
||
call tcomment#DefineType('cpp_inline', g:tcommentInlineC )
|
||
call tcomment#DefineType('cpp_block', g:tcommentBlockC )
|
||
call tcomment#DefineType('css', '/* %s */' )
|
||
call tcomment#DefineType('css_inline', g:tcommentInlineC )
|
||
call tcomment#DefineType('css_block', g:tcommentBlockC )
|
||
call tcomment#DefineType('c', '/* %s */' )
|
||
call tcomment#DefineType('c_inline', g:tcommentInlineC )
|
||
call tcomment#DefineType('c_block', g:tcommentBlockC )
|
||
call tcomment#DefineType('cfg', '# %s' )
|
||
call tcomment#DefineType('conf', '# %s' )
|
||
call tcomment#DefineType('crontab', '# %s' )
|
||
call tcomment#DefineType('cs', '// %s' )
|
||
call tcomment#DefineType('cs_inline', g:tcommentInlineC )
|
||
call tcomment#DefineType('cs_block', g:tcommentBlockC )
|
||
call tcomment#DefineType('desktop', '# %s' )
|
||
call tcomment#DefineType('docbk', '<!-- %s -->' )
|
||
call tcomment#DefineType('docbk_inline', g:tcommentInlineXML)
|
||
call tcomment#DefineType('docbk_block', g:tcommentBlockXML )
|
||
call tcomment#DefineType('dosbatch', 'rem %s' )
|
||
call tcomment#DefineType('dosini', '; %s' )
|
||
call tcomment#DefineType('dsl', '; %s' )
|
||
call tcomment#DefineType('dylan', '// %s' )
|
||
call tcomment#DefineType('eiffel', '-- %s' )
|
||
call tcomment#DefineType('erlang', '%%%% %s' )
|
||
call tcomment#DefineType('eruby', '<%%# %s' )
|
||
call tcomment#DefineType('gitcommit', '# %s' )
|
||
call tcomment#DefineType('gtkrc', '# %s' )
|
||
call tcomment#DefineType('groovy', '// %s' )
|
||
call tcomment#DefineType('groovy_inline', g:tcommentInlineC )
|
||
call tcomment#DefineType('groovy_block', g:tcommentBlockC )
|
||
call tcomment#DefineType('groovy_doc_block', g:tcommentBlockC2 )
|
||
call tcomment#DefineType('haskell', '-- %s' )
|
||
call tcomment#DefineType('haskell_block', "{-%s-}\n " )
|
||
call tcomment#DefineType('haskell_inline', '{- %s -}' )
|
||
call tcomment#DefineType('html', '<!-- %s -->' )
|
||
call tcomment#DefineType('html_inline', g:tcommentInlineXML)
|
||
call tcomment#DefineType('html_block', g:tcommentBlockXML )
|
||
call tcomment#DefineType('io', '// %s' )
|
||
call tcomment#DefineType('javaScript', '// %s' )
|
||
call tcomment#DefineType('javaScript_inline', g:tcommentInlineC )
|
||
call tcomment#DefineType('javaScript_block', g:tcommentBlockC )
|
||
call tcomment#DefineType('javascript', '// %s' )
|
||
call tcomment#DefineType('javascript_inline', g:tcommentInlineC )
|
||
call tcomment#DefineType('javascript_block', g:tcommentBlockC )
|
||
call tcomment#DefineType('java', '/* %s */' )
|
||
call tcomment#DefineType('java_inline', g:tcommentInlineC )
|
||
call tcomment#DefineType('java_block', g:tcommentBlockC )
|
||
call tcomment#DefineType('java_doc_block', g:tcommentBlockC2 )
|
||
call tcomment#DefineType('jproperties', '# %s' )
|
||
call tcomment#DefineType('lisp', '; %s' )
|
||
call tcomment#DefineType('lynx', '# %s' )
|
||
call tcomment#DefineType('m4', 'dnl %s' )
|
||
call tcomment#DefineType('mail', '> %s' )
|
||
call tcomment#DefineType('msidl', '// %s' )
|
||
call tcomment#DefineType('msidl_block', g:tcommentBlockC )
|
||
call tcomment#DefineType('nroff', '.\\" %s' )
|
||
call tcomment#DefineType('nsis', '# %s' )
|
||
call tcomment#DefineType('objc', '/* %s */' )
|
||
call tcomment#DefineType('objc_inline', g:tcommentInlineC )
|
||
call tcomment#DefineType('objc_block', g:tcommentBlockC )
|
||
call tcomment#DefineType('ocaml', '(* %s *)' )
|
||
call tcomment#DefineType('ocaml_inline', '(* %s *)' )
|
||
call tcomment#DefineType('ocaml_block', "(*%s*)\n " )
|
||
call tcomment#DefineType('pascal', '(* %s *)' )
|
||
call tcomment#DefineType('pascal_inline', '(* %s *)' )
|
||
call tcomment#DefineType('pascal_block', "(*%s*)\n " )
|
||
call tcomment#DefineType('perl', '# %s' )
|
||
call tcomment#DefineType('perl_block', "=cut%s=cut" )
|
||
call tcomment#DefineType('php', '// %s' )
|
||
call tcomment#DefineType('php_inline', g:tcommentInlineC )
|
||
call tcomment#DefineType('php_block', g:tcommentBlockC )
|
||
call tcomment#DefineType('php_2_block', g:tcommentBlockC2 )
|
||
call tcomment#DefineType('po', '# %s' )
|
||
call tcomment#DefineType('prolog', '%% %s' )
|
||
call tcomment#DefineType('rc', '// %s' )
|
||
call tcomment#DefineType('readline', '# %s' )
|
||
call tcomment#DefineType('ruby', '# %s' )
|
||
call tcomment#DefineType('ruby_3', '### %s' )
|
||
call tcomment#DefineType('ruby_block', "=begin rdoc%s=end")
|
||
call tcomment#DefineType('ruby_nodoc_block', "=begin%s=end" )
|
||
call tcomment#DefineType('r', '# %s' )
|
||
call tcomment#DefineType('sbs', "' %s" )
|
||
call tcomment#DefineType('scheme', '; %s' )
|
||
call tcomment#DefineType('sed', '# %s' )
|
||
call tcomment#DefineType('sgml', '<!-- %s -->' )
|
||
call tcomment#DefineType('sgml_inline', g:tcommentInlineXML)
|
||
call tcomment#DefineType('sgml_block', g:tcommentBlockXML )
|
||
call tcomment#DefineType('sh', '# %s' )
|
||
call tcomment#DefineType('sql', '-- %s' )
|
||
call tcomment#DefineType('spec', '# %s' )
|
||
call tcomment#DefineType('sps', '* %s.' )
|
||
call tcomment#DefineType('sps_block', "* %s." )
|
||
call tcomment#DefineType('spss', '* %s.' )
|
||
call tcomment#DefineType('spss_block', "* %s." )
|
||
call tcomment#DefineType('tcl', '# %s' )
|
||
call tcomment#DefineType('tex', '%% %s' )
|
||
call tcomment#DefineType('tpl', '<!-- %s -->' )
|
||
call tcomment#DefineType('viki', '%% %s' )
|
||
call tcomment#DefineType('viki_3', '%%%%%% %s' )
|
||
call tcomment#DefineType('viki_inline', '{cmt: %s}' )
|
||
call tcomment#DefineType('vim', '" %s' )
|
||
call tcomment#DefineType('vim_3', '""" %s' )
|
||
call tcomment#DefineType('websec', '# %s' )
|
||
call tcomment#DefineType('x86conf', '# %s' )
|
||
call tcomment#DefineType('xml', '<!-- %s -->' )
|
||
call tcomment#DefineType('xml_inline', g:tcommentInlineXML)
|
||
call tcomment#DefineType('xml_block', g:tcommentBlockXML )
|
||
call tcomment#DefineType('xs', '// %s' )
|
||
call tcomment#DefineType('xs_block', g:tcommentBlockC )
|
||
call tcomment#DefineType('xslt', '<!-- %s -->' )
|
||
call tcomment#DefineType('xslt_inline', g:tcommentInlineXML)
|
||
call tcomment#DefineType('xslt_block', g:tcommentBlockXML )
|
||
call tcomment#DefineType('yaml', '# %s' )
|
||
|
||
|
||
function! s:DefaultValue(option)
|
||
exec 'let '. a:option .' = &'. a:option
|
||
exec 'set '. a:option .'&'
|
||
exec 'let default = &'. a:option
|
||
exec 'let &'. a:option .' = '. a:option
|
||
return default
|
||
endf
|
||
|
||
let s:defaultComments = s:DefaultValue('comments')
|
||
let s:defaultCommentString = s:DefaultValue('commentstring')
|
||
let s:nullCommentString = '%s'
|
||
|
||
" tcomment#Comment(line1, line2, ?commentMode, ?commentAnyway, ?args...)
|
||
" args... are either:
|
||
" 1. a list of key=value pairs where known keys are:
|
||
" as=STRING ... Use a specific comment definition
|
||
" col=N ... Start the comment at column N (in block mode; must
|
||
" be smaller than |indent()|)
|
||
" mode=STRING ... See the notes below on the "commentMode" argument
|
||
" begin=STRING ... Comment prefix
|
||
" end=STRING ... Comment postfix
|
||
" middle=STRING ... Middle line comments in block mode
|
||
" rxbeg=N ... Regexp to find the substring of "begin" that
|
||
" should be multipied by "count"
|
||
" rxend=N ... The above for "end"
|
||
" rxmid=N ... The above for "middle"
|
||
" 2. 1-2 values for: ?commentPrefix, ?commentPostfix
|
||
" 3. a dictionary (internal use only)
|
||
"
|
||
" commentMode:
|
||
" G ... guess the value of commentMode
|
||
" B ... block (use extra lines for the comment markers)
|
||
" i ... maybe inline, guess
|
||
" I ... inline
|
||
" R ... right (comment the line right of the cursor)
|
||
" v ... visual
|
||
" o ... operator
|
||
" By default, each line in range will be commented by adding the comment
|
||
" prefix and postfix.
|
||
function! tcomment#Comment(beg, end, ...)
|
||
let commentMode = a:0 >= 1 ? a:1 : 'G'
|
||
let commentAnyway = a:0 >= 2 ? (a:2 == '!') : 0
|
||
" TLogVAR a:beg, a:end, a:1, commentMode, commentAnyway
|
||
" save the cursor position
|
||
let pos = getpos('.')
|
||
let s:pos_end = getpos("'>")
|
||
if commentMode =~# 'i'
|
||
let commentMode = substitute(commentMode, '\Ci', line("'<") == line("'>") ? 'I' : 'G', 'g')
|
||
endif
|
||
let [cstart, cend] = s:GetStartEnd(commentMode)
|
||
" TLogVAR commentMode, cstart, cend
|
||
" get the correct commentstring
|
||
if a:0 >= 3 && type(a:3) == 4
|
||
let cdef = a:3
|
||
else
|
||
let cdef = s:GetCommentDefinition(a:beg, a:end, commentMode)
|
||
let ax = 3
|
||
if a:0 >= 3 && a:3 != '' && stridx(a:3, '=') == -1
|
||
let ax = 4
|
||
let cdef.begin = a:3
|
||
if a:0 >= 4 && a:4 != '' && stridx(a:4, '=') == -1
|
||
let ax = 5
|
||
let cdef.end = a:4
|
||
endif
|
||
endif
|
||
if a:0 >= ax
|
||
call extend(cdef, s:ParseArgs(a:beg, a:end, commentMode, a:000[ax - 1 : -1]))
|
||
endif
|
||
if !empty(get(cdef, 'begin', '')) || !empty(get(cdef, 'end', ''))
|
||
let cdef.commentstring = s:EncodeCommentPart(get(cdef, 'begin', ''))
|
||
\ . '%s'
|
||
\ . s:EncodeCommentPart(get(cdef, 'end', ''))
|
||
endif
|
||
let commentMode = cdef.mode
|
||
endif
|
||
if !empty(filter(['count', 'cbeg', 'cend', 'cmid'], 'has_key(cdef, v:val)'))
|
||
call s:RepeatCommentstring(cdef)
|
||
endif
|
||
" echom "DBG" string(cdef) string(a:000)
|
||
let cms0 = s:BlockGetCommentString(cdef)
|
||
let cms0 = escape(cms0, '\')
|
||
" make whitespace optional; this conflicts with comments that require some
|
||
" whitespace
|
||
let cmtCheck = substitute(cms0, '\([ ]\)', '\1\\?', 'g')
|
||
" turn commentstring into a search pattern
|
||
let cmtCheck = s:SPrintF(cmtCheck, '\(\_.\{-}\)')
|
||
" set commentMode and indentStr
|
||
let [indentStr, uncomment] = s:CommentDef(a:beg, a:end, cmtCheck, commentMode, cstart, cend)
|
||
" TLogVAR indentStr, uncomment
|
||
let col = get(cdef, 'col', -1)
|
||
if col >= 0
|
||
let col -= 1
|
||
let indent = len(indentStr)
|
||
if col > indent
|
||
let cms0 = repeat(' ', col - indent) . cms0
|
||
else
|
||
let indentStr = repeat(' ', col)
|
||
endif
|
||
endif
|
||
if commentAnyway
|
||
let uncomment = 0
|
||
endif
|
||
" go
|
||
if commentMode =~# 'B'
|
||
" We want a comment block
|
||
call s:CommentBlock(a:beg, a:end, uncomment, cmtCheck, cdef, indentStr)
|
||
else
|
||
" call s:CommentLines(a:beg, a:end, cstart, cend, uncomment, cmtCheck, cms0, indentStr)
|
||
" We want commented lines
|
||
" final search pattern for uncommenting
|
||
let cmtCheck = escape('\V\^\(\s\{-}\)'. cmtCheck .'\$', '"/\')
|
||
" final pattern for commenting
|
||
let cmtReplace = escape(cms0, '"/')
|
||
silent exec a:beg .','. a:end .'s/\V'.
|
||
\ s:StartRx(cstart) . indentStr .'\zs\(\.\{-}\)'. s:EndRx(cend) .'/'.
|
||
\ '\=s:ProcessedLine('. uncomment .', submatch(0), "'. cmtCheck .'", "'. cmtReplace .'")/ge'
|
||
endif
|
||
" reposition cursor
|
||
" TLogVAR commentMode
|
||
if commentMode =~ '>'
|
||
call setpos('.', s:pos_end)
|
||
else
|
||
" TLogVAR pos
|
||
call setpos('.', pos)
|
||
endif
|
||
endf
|
||
|
||
|
||
function! s:GetStartEnd(commentMode) "{{{3
|
||
let commentMode = a:commentMode
|
||
if commentMode =~# 'R' || commentMode =~# 'I'
|
||
let cstart = col("'<")
|
||
if cstart == 0
|
||
let cstart = col('.')
|
||
endif
|
||
if commentMode =~# 'R'
|
||
let commentMode = substitute(commentMode, '\CR', 'G', 'g')
|
||
let cend = 0
|
||
else
|
||
let cend = col("'>")
|
||
if commentMode =~# 'o'
|
||
let cend += 1
|
||
endif
|
||
endif
|
||
else
|
||
let cstart = 0
|
||
let cend = 0
|
||
endif
|
||
return [cstart, cend]
|
||
endf
|
||
|
||
|
||
function! s:RepeatCommentstring(cdef) "{{{3
|
||
" TLogVAR a:cdef
|
||
let cms = s:BlockGetCommentString(a:cdef)
|
||
let mid = s:BlockGetMiddleString(a:cdef)
|
||
let cms_fbeg = match(cms, '\s*%\@<!%s')
|
||
let cms_fend = matchend(cms, '%\@<!%s\s*')
|
||
let rxbeg = get(a:cdef, 'rxbeg', '^.*$')
|
||
let rxend = get(a:cdef, 'rxend', '^.*$')
|
||
let rpbeg = repeat('&', get(a:cdef, 'cbeg', get(a:cdef, 'count', 1)))
|
||
let rpend = repeat('&', get(a:cdef, 'cend', get(a:cdef, 'count', 1)))
|
||
let a:cdef.commentstring = substitute(cms[0 : cms_fbeg - 1], rxbeg, rpbeg, '')
|
||
\. cms[cms_fbeg : cms_fend - 1]
|
||
\. substitute(cms[cms_fend : -1], rxend, rpend, '')
|
||
" TLogVAR cms, a:cdef.commentstring
|
||
if !empty(mid)
|
||
let rxmid = get(a:cdef, 'rxmid', '^.*$')
|
||
let rpmid = repeat('&', get(a:cdef, 'cmid', get(a:cdef, 'count', 1)))
|
||
let a:cdef.middle = substitute(mid, rxmid, rpmid, '')
|
||
" TLogVAR mid, a:cdef.middle
|
||
endif
|
||
return a:cdef
|
||
endf
|
||
|
||
|
||
function! s:ParseArgs(beg, end, commentMode, arglist) "{{{3
|
||
let args = {}
|
||
for arg in a:arglist
|
||
let key = matchstr(arg, '^[^=]\+')
|
||
let value = matchstr(arg, '=\zs.*$')
|
||
if key == 'as'
|
||
call extend(args, s:GetCommentDefinitionForType(a:beg, a:end, a:commentMode, value))
|
||
else
|
||
let args[key] = value
|
||
endif
|
||
endfor
|
||
return args
|
||
endf
|
||
|
||
|
||
function! tcomment#Operator(type, ...) "{{{3
|
||
let commentMode = a:0 >= 1 ? a:1 : ''
|
||
let bang = a:0 >= 2 ? a:2 : ''
|
||
if !exists('w:tcommentPos')
|
||
let w:tcommentPos = getpos(".")
|
||
endif
|
||
let sel_save = &selection
|
||
let &selection = "inclusive"
|
||
let reg_save = @@
|
||
" let pos = getpos('.')
|
||
" TLogVAR a:type
|
||
try
|
||
if a:type == 'line'
|
||
silent exe "normal! '[V']"
|
||
let commentMode1 = 'G'
|
||
elseif a:type == 'block'
|
||
silent exe "normal! `[\<C-V>`]"
|
||
let commentMode1 = 'I'
|
||
else
|
||
silent exe "normal! `[v`]"
|
||
let commentMode1 = 'i'
|
||
endif
|
||
if empty(commentMode)
|
||
let commentMode = commentMode1
|
||
endif
|
||
let beg = line("'[")
|
||
let end = line("']")
|
||
norm!
|
||
let commentMode .= g:tcommentOpModeExtra
|
||
call tcomment#Comment(beg, end, commentMode.'o', bang)
|
||
finally
|
||
let &selection = sel_save
|
||
let @@ = reg_save
|
||
if g:tcommentOpModeExtra !~ '>'
|
||
" TLogVAR pos
|
||
" call setpos('.', pos)
|
||
call setpos('.', w:tcommentPos)
|
||
unlet! w:tcommentPos
|
||
endif
|
||
endtry
|
||
endf
|
||
|
||
|
||
function! tcomment#OperatorLine(type) "{{{3
|
||
call tcomment#Operator(a:type, 'G')
|
||
endf
|
||
|
||
|
||
function! tcomment#OperatorAnyway(type) "{{{3
|
||
call tcomment#Operator(a:type, '', '!')
|
||
endf
|
||
|
||
|
||
function! tcomment#OperatorLineAnyway(type) "{{{3
|
||
call tcomment#Operator(a:type, 'G', '!')
|
||
endf
|
||
|
||
|
||
" :display: tcomment#CommentAs(beg, end, commentAnyway, filetype, ?args...)
|
||
" Where args is either:
|
||
" 1. A count NUMBER
|
||
" 2. An args list (see the notes on the "args" argument of
|
||
" |tcomment#Comment()|)
|
||
" comment text as if it were of a specific filetype
|
||
function! tcomment#CommentAs(beg, end, commentAnyway, filetype, ...)
|
||
if a:filetype =~ '_block$'
|
||
let commentMode = 'B'
|
||
let ft = substitute(a:filetype, '_block$', '', '')
|
||
elseif a:filetype =~ '_inline$'
|
||
let commentMode = 'I'
|
||
let ft = substitute(a:filetype, '_inline$', '', '')
|
||
else
|
||
let commentMode = 'G'
|
||
let ft = a:filetype
|
||
endif
|
||
if a:0 >= 1
|
||
if type(a:1) == 0
|
||
let cdef = {'count': a:0 >= 1 ? a:1 : 1}
|
||
else
|
||
let cdef = s:ParseArgs(a:beg, a:end, commentMode, a:000)
|
||
endif
|
||
else
|
||
let cdef = {}
|
||
endif
|
||
" echom "DBG" string(cdef)
|
||
call extend(cdef, s:GetCommentDefinitionForType(a:beg, a:end, commentMode, ft))
|
||
keepjumps call tcomment#Comment(a:beg, a:end, commentMode, a:commentAnyway, cdef)
|
||
endf
|
||
|
||
|
||
" collect all known comment types
|
||
function! tcomment#CollectFileTypes()
|
||
if s:typesDirty
|
||
let s:types = keys(s:definitions)
|
||
let s:typesRx = '\V\^\('. join(s:types, '\|') .'\)\(\u\.\*\)\?\$'
|
||
let s:typesDirty = 0
|
||
endif
|
||
endf
|
||
|
||
call tcomment#CollectFileTypes()
|
||
|
||
|
||
" return a list of filetypes for which a tcomment_{&ft} is defined
|
||
function! tcomment#Complete(ArgLead, CmdLine, CursorPos) "{{{3
|
||
call tcomment#CollectFileTypes()
|
||
let completions = copy(s:types)
|
||
if index(completions, &filetype) != -1
|
||
" TLogVAR &filetype
|
||
call insert(completions, &filetype)
|
||
endif
|
||
if !empty(a:ArgLead)
|
||
call filter(completions, 'v:val =~ ''\V\^''.a:ArgLead')
|
||
endif
|
||
let completions += tcomment#CompleteArgs(a:ArgLead, a:CmdLine, a:CursorPos)
|
||
return completions
|
||
endf
|
||
|
||
|
||
function! tcomment#CompleteArgs(ArgLead, CmdLine, CursorPos) "{{{3
|
||
let completions = ['as=', 'col=', 'count=', 'mode=', 'begin=', 'end=']
|
||
if !empty(a:ArgLead)
|
||
if a:ArgLead =~ '^as='
|
||
call tcomment#CollectFileTypes()
|
||
let completions += map(copy(s:types), '"as=". v:val')
|
||
endif
|
||
call filter(completions, 'v:val =~ ''\V\^''.a:ArgLead')
|
||
endif
|
||
return completions
|
||
endf
|
||
|
||
|
||
function! s:EncodeCommentPart(string)
|
||
return substitute(a:string, '%', '%%', 'g')
|
||
endf
|
||
|
||
|
||
function! s:GetCommentDefinitionForType(beg, end, commentMode, filetype) "{{{3
|
||
let cdef = s:GetCommentDefinition(a:beg, a:end, a:commentMode, a:filetype)
|
||
let cms = cdef.commentstring
|
||
let commentMode = cdef.mode
|
||
let pre = substitute(cms, '%s.*$', '', '')
|
||
let pre = substitute(pre, '%%', '%', 'g')
|
||
let post = substitute(cms, '^.\{-}%s', '', '')
|
||
let post = substitute(post, '%%', '%', 'g')
|
||
let cdef.begin = pre
|
||
let cdef.end = post
|
||
return cdef
|
||
endf
|
||
|
||
|
||
" s:GetCommentDefinition(beg, end, commentMode, ?filetype="")
|
||
function! s:GetCommentDefinition(beg, end, commentMode, ...)
|
||
let ft = a:0 >= 1 ? a:1 : ''
|
||
if ft != ''
|
||
let cdef = s:GetCustomCommentString(ft, a:commentMode)
|
||
else
|
||
let cdef = {'mode': a:commentMode}
|
||
endif
|
||
let cms = get(cdef, 'commentstring', '')
|
||
if empty(cms)
|
||
if exists('b:commentstring')
|
||
let cms = b:commentstring
|
||
return s:GetCustomCommentString(&filetype, a:commentMode, cms)
|
||
elseif exists('b:commentStart') && b:commentStart != ''
|
||
let cms = s:EncodeCommentPart(b:commentStart) .' %s'
|
||
if exists('b:commentEnd') && b:commentEnd != ''
|
||
let cms = cms .' '. s:EncodeCommentPart(b:commentEnd)
|
||
endif
|
||
return s:GetCustomCommentString(&filetype, a:commentMode, cms)
|
||
elseif g:tcommentGuessFileType || (exists('g:tcommentGuessFileType_'. &filetype)
|
||
\ && g:tcommentGuessFileType_{&filetype} =~ '[^0]')
|
||
if g:tcommentGuessFileType_{&filetype} == 1
|
||
let altFiletype = ''
|
||
else
|
||
let altFiletype = g:tcommentGuessFileType_{&filetype}
|
||
endif
|
||
return s:GuessFileType(a:beg, a:end, a:commentMode, &filetype, altFiletype)
|
||
else
|
||
return s:GetCustomCommentString(&filetype, a:commentMode, s:GuessCurrentCommentString(a:commentMode))
|
||
endif
|
||
let cdef.commentstring = cms
|
||
endif
|
||
return cdef
|
||
endf
|
||
|
||
" s:SPrintF(formatstring, ?values ...)
|
||
" => string
|
||
function! s:SPrintF(string, ...)
|
||
let n = 1
|
||
let r = ''
|
||
let s = a:string
|
||
while 1
|
||
let i = match(s, '%\(.\)')
|
||
if i >= 0
|
||
let x = s[i + 1]
|
||
let r = r . strpart(s, 0, i)
|
||
let s = strpart(s, i + 2)
|
||
if x == '%'
|
||
let r = r.'%'
|
||
else
|
||
if a:0 >= n
|
||
let v = a:{n}
|
||
let n = n + 1
|
||
else
|
||
echoerr 'Malformed format string (too many arguments required): '. a:string
|
||
endif
|
||
if x ==# 's'
|
||
let r = r.v
|
||
elseif x ==# 'S'
|
||
let r = r.'"'.v.'"'
|
||
else
|
||
echoerr 'Malformed format string: '. a:string
|
||
endif
|
||
endif
|
||
else
|
||
return r.s
|
||
endif
|
||
endwh
|
||
endf
|
||
|
||
function! s:StartRx(pos)
|
||
if a:pos == 0
|
||
return '\^'
|
||
else
|
||
return '\%'. a:pos .'c'
|
||
endif
|
||
endf
|
||
|
||
function! s:EndRx(pos)
|
||
if a:pos == 0
|
||
return '\$'
|
||
else
|
||
return '\%'. a:pos .'c'
|
||
endif
|
||
endf
|
||
|
||
function! s:GetIndentString(line, start)
|
||
let start = a:start > 0 ? a:start - 1 : 0
|
||
return substitute(strpart(getline(a:line), start), '\V\^\s\*\zs\.\*\$', '', '')
|
||
endf
|
||
|
||
function! s:CommentDef(beg, end, checkRx, commentMode, cstart, cend)
|
||
let mdrx = '\V'. s:StartRx(a:cstart) .'\s\*'. a:checkRx .'\s\*'. s:EndRx(0)
|
||
let line = getline(a:beg)
|
||
if a:cstart != 0 && a:cend != 0
|
||
let line = strpart(line, 0, a:cend - 1)
|
||
endif
|
||
let uncomment = (line =~ mdrx)
|
||
let indentStr = s:GetIndentString(a:beg, a:cstart)
|
||
let il = indent(a:beg)
|
||
let n = a:beg + 1
|
||
while n <= a:end
|
||
if getline(n) =~ '\S'
|
||
let jl = indent(n)
|
||
if jl < il
|
||
let indentStr = s:GetIndentString(n, a:cstart)
|
||
let il = jl
|
||
endif
|
||
if a:commentMode =~# 'G'
|
||
if !(getline(n) =~ mdrx)
|
||
let uncomment = 0
|
||
endif
|
||
endif
|
||
endif
|
||
let n = n + 1
|
||
endwh
|
||
if a:commentMode =~# 'B'
|
||
let t = @t
|
||
try
|
||
silent exec 'norm! '. a:beg.'G1|v'.a:end.'G$"ty'
|
||
let uncomment = (@t =~ mdrx)
|
||
finally
|
||
let @t = t
|
||
endtry
|
||
endif
|
||
return [indentStr, uncomment]
|
||
endf
|
||
|
||
function! s:ProcessedLine(uncomment, match, checkRx, replace)
|
||
" TLogVAR a:uncomment, a:match, a:checkRx, a:replace
|
||
if !(a:match =~ '\S' || g:tcommentBlankLines)
|
||
return a:match
|
||
endif
|
||
let ml = len(a:match)
|
||
if a:uncomment
|
||
let rv = substitute(a:match, a:checkRx, '\1\2', '')
|
||
else
|
||
let rv = s:SPrintF(a:replace, a:match)
|
||
endif
|
||
" TLogVAR rv
|
||
" let md = len(rv) - ml
|
||
let s:pos_end = getpos('.')
|
||
let s:pos_end[2] += len(rv)
|
||
" TLogVAR pe, md, a:match
|
||
if v:version > 702 || (v:version == 702 && has('patch407'))
|
||
let rv = escape(rv, '
|
||
')
|
||
else
|
||
let rv = escape(rv, '\
|
||
')
|
||
endif
|
||
let rv = substitute(rv, '\n', '\\\n', 'g')
|
||
return rv
|
||
endf
|
||
|
||
function! s:CommentLines(beg, end, cstart, cend, uncomment, cmtCheck, cms0, indentStr) "{{{3
|
||
" We want commented lines
|
||
" final search pattern for uncommenting
|
||
let cmtCheck = escape('\V\^\(\s\{-}\)'. a:cmtCheck .'\$', '"/\')
|
||
" final pattern for commenting
|
||
let cmtReplace = escape(a:cms0, '"/')
|
||
silent exec a:beg .','. a:end .'s/\V'.
|
||
\ s:StartRx(a:cstart) . a:indentStr .'\zs\(\.\{-}\)'. s:EndRx(a:cend) .'/'.
|
||
\ '\=s:ProcessedLine('. a:uncomment .', submatch(0), "'. a:cmtCheck .'", "'. cmtReplace .'")/ge'
|
||
endf
|
||
|
||
function! s:CommentBlock(beg, end, uncomment, checkRx, cdef, indentStr)
|
||
let t = @t
|
||
try
|
||
silent exec 'norm! '. a:beg.'G1|v'.a:end.'G$"td'
|
||
let ms = s:BlockGetMiddleString(a:cdef)
|
||
let mx = escape(ms, '\')
|
||
if a:uncomment
|
||
let @t = substitute(@t, '\V\^\s\*'. a:checkRx .'\$', '\1', '')
|
||
if ms != ''
|
||
let @t = substitute(@t, '\V\n'. a:indentStr . mx, '\n'. a:indentStr, 'g')
|
||
endif
|
||
let @t = substitute(@t, '^\n', '', '')
|
||
let @t = substitute(@t, '\n\s*$', '', '')
|
||
else
|
||
let cs = s:BlockGetCommentString(a:cdef)
|
||
let cs = a:indentStr . substitute(cs, '%s', '%s'. a:indentStr, '')
|
||
if ms != ''
|
||
let ms = a:indentStr . ms
|
||
let mx = a:indentStr . mx
|
||
let @t = substitute(@t, '^'. a:indentStr, '', 'g')
|
||
let @t = ms . substitute(@t, '\n'. a:indentStr, '\n'. mx, 'g')
|
||
endif
|
||
let @t = s:SPrintF(cs, "\n". @t ."\n")
|
||
endif
|
||
silent norm! "tP
|
||
finally
|
||
let @t = t
|
||
endtry
|
||
endf
|
||
|
||
" inspired by Meikel Brandmeyer's EnhancedCommentify.vim
|
||
" this requires that a syntax names are prefixed by the filetype name
|
||
" s:GuessFileType(beg, end, commentMode, filetype, ?fallbackFiletype)
|
||
function! s:GuessFileType(beg, end, commentMode, filetype, ...)
|
||
if a:0 >= 1 && a:1 != ''
|
||
let cdef = s:GetCustomCommentString(a:1, a:commentMode)
|
||
if empty(get(cdef, 'commentstring', ''))
|
||
let cdef.commentstring = s:GuessCurrentCommentString(a:commentMode)
|
||
endif
|
||
else
|
||
let cdef = {'commentstring': s:GuessCurrentCommentString(0), 'mode': s:CommentMode(a:commentMode, 'G')}
|
||
endif
|
||
let n = a:beg
|
||
" TLogVAR n, a:beg, a:end
|
||
while n <= a:end
|
||
let m = indent(n) + 1
|
||
let le = len(getline(n))
|
||
" TLogVAR m, le
|
||
while m < le
|
||
let syntaxName = synIDattr(synID(n, m, 1), 'name')
|
||
" TLogVAR syntaxName, n, m
|
||
let ftypeMap = get(g:tcommentSyntaxMap, syntaxName)
|
||
if !empty(ftypeMap)
|
||
" TLogVAR ftypeMap
|
||
return s:GetCustomCommentString(ftypeMap, a:commentMode, cdef.commentstring)
|
||
elseif syntaxName =~ s:typesRx
|
||
let ft = substitute(syntaxName, s:typesRx, '\1', '')
|
||
" TLogVAR ft
|
||
if exists('g:tcommentIgnoreTypes_'. a:filetype) && g:tcommentIgnoreTypes_{a:filetype} =~ '\<'.ft.'\>'
|
||
let m += 1
|
||
else
|
||
return s:GetCustomCommentString(ft, a:commentMode, cdef.commentstring)
|
||
endif
|
||
elseif syntaxName == '' || syntaxName == 'None' || syntaxName =~ '^\u\+$' || syntaxName =~ '^\u\U*$'
|
||
let m += 1
|
||
else
|
||
break
|
||
endif
|
||
endwh
|
||
let n += 1
|
||
endwh
|
||
return cdef
|
||
endf
|
||
|
||
function! s:CommentMode(commentMode, newmode) "{{{3
|
||
return substitute(a:commentMode, '\w\+', a:newmode, 'g')
|
||
endf
|
||
|
||
function! s:GuessCurrentCommentString(commentMode)
|
||
let valid_cms = (stridx(&commentstring, '%s') != -1)
|
||
if &commentstring != s:defaultCommentString && valid_cms
|
||
" The &commentstring appears to have been set and to be valid
|
||
return &commentstring
|
||
endif
|
||
if &comments != s:defaultComments
|
||
" the commentstring is the default one, so we assume that it wasn't
|
||
" explicitly set; we then try to reconstruct &cms from &comments
|
||
let cms = s:ConstructFromComments(a:commentMode)
|
||
if cms != s:nullCommentString
|
||
return cms
|
||
endif
|
||
endif
|
||
if valid_cms
|
||
" Before &commentstring appeared not to be set. As we don't know
|
||
" better we return it anyway if it is valid
|
||
return &commentstring
|
||
else
|
||
" &commentstring is invalid. So we return the identity string.
|
||
return s:nullCommentString
|
||
endif
|
||
endf
|
||
|
||
function! s:ConstructFromComments(commentMode)
|
||
exec s:ExtractCommentsPart('')
|
||
if a:commentMode =~# 'G' && line != ''
|
||
return line .' %s'
|
||
endif
|
||
exec s:ExtractCommentsPart('s')
|
||
if s != ''
|
||
exec s:ExtractCommentsPart('e')
|
||
return s.' %s '.e
|
||
endif
|
||
if line != ''
|
||
return line .' %s'
|
||
else
|
||
return s:nullCommentString
|
||
endif
|
||
endf
|
||
|
||
function! s:ExtractCommentsPart(key)
|
||
" let key = a:key != "" ? a:key .'[^:]*' : ""
|
||
let key = a:key . '[bnflrxO0-9-]*'
|
||
let val = substitute(&comments, '^\(.\{-},\)\{-}'. key .':\([^,]\+\).*$', '\2', '')
|
||
if val == &comments
|
||
let val = ''
|
||
else
|
||
let val = substitute(val, '%', '%%', 'g')
|
||
endif
|
||
let var = a:key == '' ? 'line' : a:key
|
||
return 'let '. var .'="'. escape(val, '"') .'"'
|
||
endf
|
||
|
||
" s:GetCustomCommentString(ft, commentMode, ?default="")
|
||
function! s:GetCustomCommentString(ft, commentMode, ...)
|
||
let commentMode = a:commentMode
|
||
let customComment = tcomment#TypeExists(a:ft)
|
||
if commentMode =~# 'B' && tcomment#TypeExists(a:ft .'_block')
|
||
let def = s:definitions[a:ft .'_block']
|
||
elseif commentMode =~? 'I' && tcomment#TypeExists(a:ft .'_inline')
|
||
let def = s:definitions[a:ft .'_inline']
|
||
elseif customComment
|
||
let def = s:definitions[a:ft]
|
||
let commentMode = s:CommentMode(commentMode, 'G')
|
||
elseif a:0 >= 1
|
||
let def = {'commentstring': a:1}
|
||
let commentMode = s:CommentMode(commentMode, 'G')
|
||
else
|
||
let def = {}
|
||
let commentMode = s:CommentMode(commentMode, 'G')
|
||
endif
|
||
let cdef = copy(def)
|
||
let cdef.mode = commentMode
|
||
return cdef
|
||
endf
|
||
|
||
function! s:BlockGetCommentString(cdef)
|
||
if has_key(a:cdef, 'middle')
|
||
return a:cdef.commentstring
|
||
else
|
||
return matchstr(a:cdef.commentstring, '^.\{-}\ze\(\n\|$\)')
|
||
endif
|
||
endf
|
||
|
||
function! s:BlockGetMiddleString(cdef)
|
||
if has_key(a:cdef, 'middle')
|
||
return a:cdef.middle
|
||
else
|
||
return matchstr(a:cdef.commentstring, '\n\zs.*')
|
||
endif
|
||
endf
|
||
|
||
|
||
redraw
|
||
|