c - Doxygen addtogroup 问题与特殊函数 FUNC(..)

Question

我有嵌入式系统 C 代码，并且我使用 doxygen 使用 addtogroup 命令来记录。查看 html 输出时，特殊函数 FUNC(..) 之后的函数之一未出现在模块页面中。这是一个简短的示例代码。

    /*!
      \addtogroup Test
      \brief This is a TestModule
      \{
     */
    extern FUNC(void, IOHWAB_APPL_CODE) Init_Tester(void);

    void TimerOn(void)
    {
    }
    void ADC_On(void)
    {
    }

    /*! \} */ //end of addtogroup

在上面的示例中，doxygen 仅显示以下内容。

extern FUNC(void, IOHWAB_APPL_CODE)
void ADC_On(void)

如果我在 extern FUNC(..) 和 void TimerOn() 之间添加一个虚拟函数(即 void dummy())，则将显示除虚拟函数之外的所有函数。

extern FUNC(void, IOHWAB_APPL_CODE)
void TimerOn(void)
void ADC_On(void)

知道如何解决这个问题吗？

Answer 1

我测试了以下代码:

/*!
  \addtogroup   Test
  \brief        This is a TestModule
  \{
 */
extern FUNC(void, IOHWAB_APPL_CODE) Init_Tester(void)
{
}

void Timer(void){}

void TimerOn(void)
{
}

void ADC_On(void)
{
}

/*! \} */ //end of addtogroup

我得到的文档是这样的:

> Functions     
>FUNC (void, IOHWAB_APPL_CODE)   
>void Timer (void)   
>void TimerOn (void)   
>void ADC_On (void)

如果我将函数实现改为声明，文档中的函数就会消失。看起来 doxygen 只记录了函数的实现，并且错误地解析了 TimerOn 的 FUNC 实现。所以，错过了文档中的TimerOn函数。

我不确定，只是测试一下并猜测结果。希望这可以帮助您。