Not All Doxygen Comment Blocks Supported

tristan-smith commented 1 month ago

Environment

OS and Version: Windows 10
VS Code Version: 1.88.1
C/C++ Extension Version: v1.20.5
If using SSH remote, specify OS of remote machine:

Bug Summary and Steps to Reproduce

Bug Summary: My work's coding style guide specifies this format of Doxygen comment (No.4 on this page: Doxygen Documentation):

/***************************************************************************//**
* Example Code Block
*
*******************************************************************************/

Note the two forward slashes in the first line.

The VSCode C/C++ Extension doesn't seem to pick this up as a Doxygen comment:

Example with slashes:

Example without slashes:

Steps to reproduce:

Create a comment block like the above example.
I also attached test.txt with the two examples. test.txt

Expected behavior: I would expect any code block format specified on the Doxygen documentation to render properly like the second screenshot above.

Let me know if I can provide any other info! Thanks for your time and help with this.

Configuration and Logs

{
    "configurations": [
        {
            "name": "Win32",
            "includePath": [
                "${workspaceFolder}/**"
            ],
            "compileCommands": "${workspaceFolder}/build/compile_commands.json",
            "defines": [
                "_DEBUG",
                "UNICODE",
                "_UNICODE"
            ],
            "cStandard": "c17",
            "cppStandard": "c++17",
            "configurationProvider": "ms-vscode.cmake-tools"
        }
    ],
    "version": 4
}