Docstring function preview misrenders bullet list when Doxygen annotation is involved

[gnahtb]

Environment

• OS and Version: macOS Sonoma 14.0
• VS Code Version: 1.83.1
• C/C++ Extension Version: v1.17.5

Bug Summary and Steps to Reproduce

Bug Summary:

Paragraphs are treated as one line when there is Doxygen annotation in the function docstring.

Steps to reproduce:

Experiment with the code snippets in above images

Expected behavior:

In the second image, a bullet point list should appear instead of text being squashed into one line.

Configuration and Logs

Not applicable

Other Extensions

Not applicable

Additional context

No response

[browntarik]

This is by design, Doxygen comments are meant to enforce Doxygen formatting so anything outside of a tag will be formatted as one line with stripped whitespace. As of right now you cannot mix Doxygen and Markdown formatting in comments. If this is something you would like to see, please consider submitting a feature request.

[browntarik]

I have labeled this as a Feature Request for your convenience. Thank you!

[gnahtb]

Does the repo welcome contributors? I am happy to work on this.

[github-actions[bot]]

This feature request is being closed due to insufficient upvotes. Please leave a 👍-upvote or 👎-downvote reaction on the issue to help us prioritize it. 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.

[gabeseltzer]

To be clear, Doxygen does say it supports markdown lists