c - Doxygen 对待 main.c 与其他文件的方式不同

Question

我的 main.c 中的 header 注释没有被 doxygen 处理，但是如果我将文件从 main.c 重命名为 mainn.c，它会工作得很好。

为什么 main.c 的处理方式与其他文件名不同？如何让 Doxygen 像其他 .c 文件一样管理 main.c？

或者，这里的最佳实践是什么？我在 Main.c 中的目的是在 header 文档中放置简短(也许不那么短)的产品描述和用例。

头文件的开头如下:

/**********************************************************//**
* @file    main.c
* @author  Somebody
* @brief   Main function and support functions.
* @details 

然后继续我想要记录的应用程序级别的内容。Doxygen 配置是安装时的默认配置，除了一些项目，例如针对 C 进行优化、包括调用图表等...

谢谢..

Answer 1

如果不看看你如何尝试记录它，就很难判断...但请确保 main.c 文件中有一行内容为

/*! file */

或

/** @file */

(默认情况下，Doxygen 不记录全局对象)