Customizable Doxygen tags for Quick Info

[emaschas]

Type: Feature Request

Could you please implement @details and eventually also @note and @warning in quick info. If it cannot be a separate section, at least show the text after that of @brief.

Another suggestion : implement @n to force line break

Many thanks.

[michelleangela]

@emaschas

Just to clarify, is this a request to add those additional Doxygen tags to the simplified view of structured comments in the quick info tooltip? Otherwise, all Doxygen tags can be viewed by setting C_Cpp.simplifyStructuredComments to false.

[emaschas]

The request is to add one or two more tags that would be displayed in the quick info with the same aspect as the "simplified" option. Something like that

Maybe I should have done a separate issue for the other request concerning the implementation of @n to force line break (like
in HTML).

[emaschas]

I realize that my issue somehow similar to #7705

[github-actions[bot]]

This feature request is being closed due to insufficient upvotes. When enough upvotes are received, this issue will be eligible for our backlog.

[github-actions[bot]]

This feature request has received enough votes to be added to our backlog.

[TomasVaner]

@emaschas

Just to clarify, is this a request to add those additional Doxygen tags to the simplified view of structured comments in the quick info tooltip? Otherwise, all Doxygen tags can be viewed by setting C_Cpp.simplifyStructuredComments to false.

The problem is that with this setting being off comments become almost plain text, and tags are visible as tags with @ and all. So yeah, adding some tag being parsed would be great

Also, maybe add an option to parse known tags and just add the unknown ones as a non-simplified version?

[emaschas]

@emaschas Just to clarify, is this a request to add those additional Doxygen tags to the simplified view of structured comments in the quick info tooltip? Otherwise, all Doxygen tags can be viewed by setting C_Cpp.simplifyStructuredComments to false.

The problem is that with this setting being off comments become almost plain text, and tags are visible as tags with @ and all. So yeah, adding some tag being parsed would be great

Also, maybe add an option to parse known tags and just add the unknown ones as a non-simplified version?

The request was to add some of the Doxygen tags in order to enhance the quick info tooltip, not the full set. The use case is not for Doxygen implementation, but just the quick info. The implementation of @n to force line breaks would be really nice too.

[sean-mcmanus]

@bobbrow Can/should you update the Milestone/Project?

[bobbrow]

@sean-mcmanus we will when we start working on it.

[cjr163]

I need ...

[sean-mcmanus]

@cjr163 Could you clarify your screenshot/comment? What do you need?

[kisielk]

Since this was closed as a duplicate of #7705 I'd just like to add that I think even if the simplified display can be customized, @warning should be in the defaults

[michelleangela]

[sean-mcmanus]

The fix is available with 1.13.3 (pre-release): https://github.com/microsoft/vscode-cpptools/releases/tag/v1.13.3