google/vimdoc — pull request #50 by dbarnett (2014-07-12 23:52:09+00:00)
Title: Disable implicit vimdoc blocks at start-of-file.

Disable the magic that treats the first comment block of any file as a potential vimdoc block, even if there's no explicit vimdoc leader. After this change, you must include an explicit vimdoc leader on every vimdoc block if you want vimdoc to use it.

This may cause users who forgot to add vimdoc leaders to have vimdoc comments mysteriously dropped or to see errors like
`NeglectedSections: Sections set(['usage', 'commands', 'intro', 'config']) not included in ordering` if blocks with global directives are dropped. I wanted to show warnings for newly-dropped blocks that would have previously been detected, but the code structure makes it difficult to warn in just the right instances.

Fixes #42.