Home/ Questions/Q 7801199
In Process

The Archive Base Latest Questions

Editorial Team
  • 0
Asked: 2026-06-02T00:52:19+00:00

if I have a c header file with a doxygen comment: /*! * @file

  • 0

if I have a c header file with a doxygen comment: 

/*!
*    @file    MyHeaderFile.h
*    @brief   Brief header file description
*    @author  Me Myself
*    @date    2012.4.16
*/

This results in html like this:

enter image description here

This same syntax works fine in function comments:

enter image description here

Am I doing something wrong or is this all that is supported?

EDIT: normal function comment: 

/*!
*    @brief This function does things
*
*    @author Me Myself
*    @date   2012.4.16
*   
*    @returns    void
*/
void MyFunctionThing(void)
{
}
Share

Leave an answer

You must login to add an answer.

Need An Account,

1 Answer

  1. Editorial Team

    Although I could not really reproduce the problem given your example, this is most likely the result of Markdown support (introduced in version 1.8.0), in particular the code blocks feature.
    Options you can try to avoid/workaround this:

    • Set MARKDOWN_SUPPORT to NO in the config file
    • Indent the text in you comment block with less than 4 spaces (after the *).
    • 0