vimdoc icon indicating copy to clipboard operation
vimdoc copied to clipboard

Handle 'exception' types better

Open Soares opened this issue 11 years ago • 2 comments

The code to check whether a function is an exception (in output.py HelpFile.WriteChunk) is hacky and brittle. We should generalize the mechanism. (The same hack is used in block.py Block.Close, and should be removed from there as well.)

Soares avatar Mar 20 '14 21:03 Soares

are the conventions for @exception documented anywhere? at least from the maktaba sources it looks like a function annotated with @exception has nothing else in its block, but i can't find any reference to it in the vimdoc sources (it's not even listed in the comments for possible keys in block.locals)

martindemello avatar Apr 06 '20 11:04 martindemello

I just ran into the same! I was hoping I could give it an explicit name to detect an s:Func the same way other directives like @dict work, but it didn't work and didn't give me any useful error message.

The documentation at least is an easy fix if you want to send a quick PR.

dbarnett avatar Apr 14 '20 15:04 dbarnett