@warning / \warning sections from doxygen comments are not displayed in simplified view

[kisielk]

Bug type: Language Service

Describe the bug

• OS and Version: macOS 11.4
• VS Code Version: 1.57.0
• C/C++ Extension Version: 1.5.0-insiders

Steps to reproduce

1. Document a function and use the @warning or \warning doxgen command.
2. Hover over the function name or any usage of the function to display the documentation popup.

Expected behavior
The popup should include the @warning paragraph but it does not.

Screenshots
Code example:

Result when hovering over ApplyIn:

[michelleangela]

@kisielk
You can set the setting C_Cpp.simplifyStructuredComments to false to display all Doxygen tags.

[kisielk]

Yes but that also removes all the nice formatting of the other parameters. Also something that's labelled "warning" is usually pretty important so should be shown in the simplified view.

[github-actions]

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

[Kaleb-JCI]

I agree that @warning is important and should be shown in the simplified view! I think this also applies to @attention.

For example, I'm working on an existing codebase, and I sometimes run across functions where the caller is responsible for freeing up memory allocated within the function. This is information that should be visible on hover (and since newlines don't stick around, the only way I can currently add this to a tooltip and still have it visually stand out [without telling people to adjust their default extension settings] is to add an @exception tag and mention it in there even though it's not throwing an exception).