如何记录函数的全局依赖关系？

我从第三方供应商（用于嵌入式平台）获得了一些使用全局变量（用于速度和空间优化）的 C 代码。我正在记录代码，转换为Doxygen格式。

如何在函数文档中添加函数需要的全局变量和函数的注释？

Doxygen有用于注释参数和返回值的特殊命令，如下所述：Doxygen 特殊命令 http://www.doxygen.nl/manual/commands.html。我没有看到任何全局变量的命令。

C 代码示例：

    extern unsigned char data_buffer[]; //!< Global variable.

    /*! Returns the next available data byte.
     *  \return Next data byte.
     */
    unsigned char Get_Byte(void)
    {
      static unsigned int index = 0;
      return data_buffer[index++]; //!< Uses global variable.   
    }

在上面的代码中，我想添加Doxygen注释，该函数依赖于全局变量data_buffer.

您只需添加注释即可达到该效果并使用\link http://www.doxygen.nl/commands.html#cmdlink指令将读者引导至全局变量的描述。