Doxygen comment tags aren't ended after a blank line

[sean-mcmanus]

Use code

/**
 * @brief Shuffle vector.
 * @return Nothing.
 * 
 * Details...
 */
void shuffle(std::vector<int> &v);

Hover over shuffle.

The "Details..." comment is incorrectly combined with the Nothing comment.

The issue repros with doxgyen comments in the gcc headers.

A bug on VS is filed at https://developercommunity.visualstudio.com/content/problem/1137513/doxygen-comment-tags-arent-ended-after-a-blank-lin.html

[michelleangela]

This might be a duplicate of #5741 which just got fixed for Visual Studio.

[sean-mcmanus]

It's not fixed...it might have been improved via add a whitespace though. They closed it as low pri.

[0Grit]

I'm not sure how this doesn't bother more people.

[Mode-77]

I'm not sure how this doesn't bother more people.

It is very frustrating.

[Mode-77]

The closest mechanism to a solution for this issue is to use the @details or \details marker after adding details to the supported tags in the settings. After you do this, the text will have its own section like the others. See #11842.

[tueda]

Seems to have been fixed.

• VS Code Version: 1.95.2
• C/C++ Extension Version: 1.22.11

[sean-mcmanus]

@tueda Yeah, I see it fixed too.