如何使用doxywizard正确记录返回类型为struct的函数？

虽然我已经在我认为可能找到答案的任何地方查找了，但我还没有弄清楚如何正确地记录函数struct Entity*NewEntity，以便在doxywizard运行时它看起来是记录的

它一直在告诉我：警告：file entity.h的Member NewEntity函数没有文档记录

然而，守则是：

/***********************************************************************************************//*
* @fn   struct Entity* NewEntity()
*
* @brief    Initialises single entity.
* @return   null if it fails, else finds empty spot in entity manager to use to make a new entity
* @author   br66
* @date     3/30/2017
**************************************************************************************************/
struct Entity* NewEntity()
{
    int i;

    for (i = 0; i < 255; i++)
    {
        if (_entityM[i].m_active == 0)
        {
            // clear that space, just in case there's anything left over from its last use
            memset(&_entityM[i], 0, sizeof(struct Entity));

            _entityM[i].m_active = 1;

            // any entity defaults? stay tooooooned

            _entity_max_recorded++;

            return &_entityM[i];
        }
    }

    return NULL;
}

---

阅读文档时，它告诉我确保头文件已被记录，但它没有更改任何内容，我仍然收到警告。

您有两个注释块。/***…***/*@fn…*/

doxygen没有看到第二条评论

doxygen注释块应以额外的“*”/***@fn…*/”开头