Allow docvim blocks to appear inside function bodies

For example, I just had a case where I had an option defined/used inside
a function:

  function s:foo()
    ""
    " @option g:SomeOption boolean 1
    "
    " This option does some thing.
    let l:dispatch=get(g:, 'SomeOption', 1)

    " [code that uses the option here...]
  endfunction

Note that @option is a bit different from @mapping and @command. The
latter generally will have one authoritative place where they are
defined and where their documentation can logically/obviously go. An
@option on the other hand, may be used in multiple places.

So it may make sense to either just document these elsewhere (like up in
the @plugin area), or get into the habit of making a centralized place
where option default values are defined, so that they can be documented
independently of their usage sites.

diff --git a/after/syntax/vim.vim b/after/syntax/vim.vim
index 896e779da5dcffa1434cea28de3daa7b1e08c4b0..c8996de866fac8f556f8cc089d3ed7304ccf9e01 100644 (file)
--- a/after/syntax/vim.vim
+++ b/after/syntax/vim.vim
@@ -149,7 +149,7 @@
 "
 " - Initial release.
 
-syntax region docvimBlock start='\v^\s*""' end='\v^\zs\ze\s*($|[^ \t"])'
+syntax region docvimBlock start='\v^\s*""' end='\v^\zs\ze\s*($|[^ \t"])' containedin=vimFuncBody
 syntax region docvimPre start='\v^\s*"\s+\zs```\s*$' end='\v^\s*"\s+```\s*$' containedin=docvimBlock contained keepend
 
 syntax match docvimAnnotation '\v\@command( .+)?' containedin=docvimBlock contained