Question

Given the following comment:

/// /////////////////////////////////////////////////////////////////////////////
/// @class  Foo
/// @brief  Description of Foo.
/// /////////////////////////////////////////////////////////////////////////////

Doxygen outputs:

Describes a screen region in pixels, relative to some other region. ////////////////////////////////////////////////////////////////////////////.

/////////////////////////////////////////////////////////////////////////////

How can I prevent it from including the forward slashes?

EDIT: I need the /// followed by a space because it’s the only way I know of to allow Visual Studio to highlight one type of comment (in this case documentation) in a different color to other comments (code comments, in my current project). This precludes me from simply removing the space on the first and last line of my comment.

Answer 1

Refer to the doxygen manual: http://www.doxygen.nl/manual/docblocks.html

If you remove the spaces between the first /// and the trailing slashes, it should work as you’re expecting.