Make \ref in doxygen comments a clickable link to the symbol

[spoorcc]

Feature Request

In Doxygen you can make a reference to a symbol using the \ref command. It would be great if the referenced symbol could become a clickable link so you can jump to the implementation.

[michelleangela]

This would require VS Code to provide an API that allows link to comments, unless there is already one available.

[spoorcc]

Something like this? https://vscode-api.js.org/interfaces/vscode.DocumentLinkProvider.html#provideDocumentLinks

[michelleangela]

Yes, the DocumentLinkProvider is probably what would be needed.

[KKghub]

I see that if we write link to the file with prefix file:/// in comment, VSCode shows it as clickable link. and it supports relative links as well. For example:

It would be nice if we do not need to prefix it with file:/// to make it clickable, maybe similar to how markdowns detect it?

[Test](./test.cpp)

[mrx23dot]

Why not generate doxygen html and clickaway in that?