Skip to content

Doxygen comments render incorrectly with @param[in] arg i1, #13745

Closed
Bug
Closed
Doxygen comments render incorrectly with @param[in] arg i1,#13745
Bug
Labels
Feature: Doc commentsAn issue related to code comments shown in hover, completion, and signature help.Language ServiceVisual StudioInherited from Visual StudiobugfixedCheck the Milestone for the release in which the fix is or will be available.
Milestone
1.27.0

Description

@sean-mcmanus
Sean McManus (sean-mcmanus)
opened on Jul 7, 2025

Hello Sean McManus (@sean-mcmanus).

I'm using v1.26.3 and unfortunately I'm observing this bug is still present.

For example with the following function:

/**
 * @brief Function description.
 * 
 * @param[in] arg Hello, world.
 */
void foobar(int arg);

Curiously, it only seems to be triggered when the argument description contains a comma.

Without comma (expected):
Image

With comma (unexpected):
Image

Originally posted by Delgan in #13682

Activity

  1. Sean McManus (sean-mcmanus)
    added
    bug
    Language Service
    Visual StudioInherited from Visual Studio
    Feature: Doc commentsAn issue related to code comments shown in hover, completion, and signature help.
    on Jul 7, 2025
  2. github-project-automation
    added this to cpptoolson Jul 7, 2025
  3. Sean McManus (sean-mcmanus)
    added the
    Bug
    issue type on Jul 7, 2025
  4. Sean McManus (sean-mcmanus)
    added this to the Tracking milestone on Jul 7, 2025

  5. sean-mcmanus commented on Jul 7, 2025

    @sean-mcmanus
    Sean McManus (sean-mcmanus)
    on Jul 7, 2025
    ContributorAuthor

    I filed a VS bug at https://developercommunity.visualstudio.com/t/C-Doxygen-comment-with-paramin-arg/10933346 .

  6. Sean McManus (sean-mcmanus)
    added
    fixedCheck the Milestone for the release in which the fix is or will be available.
    on Jul 11, 2025
  7. Sean McManus (sean-mcmanus)
    modified the milestones: Tracking, 1.27.0 on Jul 11, 2025
  8. Sean McManus (sean-mcmanus)
    moved this to Done in cpptoolson Jul 11, 2025
  9. Sean McManus (sean-mcmanus)
    closed this as completedon Aug 7, 2025
  10. github-actions
    locked and limited conversation to collaborators on Sep 22, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    Feature: Doc commentsAn issue related to code comments shown in hover, completion, and signature help.Language ServiceVisual StudioInherited from Visual StudiobugfixedCheck the Milestone for the release in which the fix is or will be available.

    Type

    Bug

    Projects

    • cpptools
      Status
      Done

    Milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions