sourcegraph / scip-clang

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Consistently prefer doc comment at definition, not forward declaration

varungandhi-src opened this issue · comments

Right now, the handling for merging doc comments is not always correct. For example, sometimes we prefer the doc comment on the forward declaration over the doc comment for the definition.

image

For forward declarations, if we see that a doc comment for the definition is present, we should add an override documentation for the reference occurrence at the forward declaration.