only the first usage will get @dict SomeDict and show up in the docs as SomeDict.Foo. The second usage will show up as x#Foo since it's not considered a dict function.
This can be worked around by placing all directives that should apply to all usages after an @all directive, or by making sure they come after each @usage directive, but it's unintuitive and can bury directives that you'd expect to see on the first line.
If vimdoc directives are above the first
@usageline in a doc comment block with multiple@usages, they only apply to the first@usage.For instance, given:
only the first usage will get
@dict SomeDictand show up in the docs asSomeDict.Foo. The second usage will show up asx#Foosince it's not considered a dict function.This can be worked around by placing all directives that should apply to all usages after an
@alldirective, or by making sure they come after each@usagedirective, but it's unintuitive and can bury directives that you'd expect to see on the first line.