c++ - Doxygen:C++ 项目中的多个\mainpage block

Question

在两种情况下，我无法确定 doxygen 关于 \mainpage 部分的行为:

1. 如果您未指定 \mainpage 部分，它会使用任何其他页面吗？如果是，如何选择？
2. 如果两个文件都指定了 \mainpage 部分怎么办？

Answer 1

\mainpage 命令指定用于自定义索引页的内容，因此如果您缺少它，它只是一个带有普通 Doxygen 页眉和页脚的空白页。

我认为关于拥有多个 \mainpage 命令最安全的说法是它是 undefined 经典意义上的根据版本和平台产生不可预测的结果。同样，当我不小心创建了多个具有相同页面名称的 \page 命令时，我得到了奇怪的结果。

进一步思考

由 answering another Doxygen question 提示，请记住，您可以让 Doxygen 遵守预处理器指令，这样您就可以让 #if 条件语句保护多个主页指令，并在同一代码库上运行不同的配置文件，其中配置文件定义了几个标志值之一。

我已经使用这种从不同角度生成文档的方法来发布Macintosh和 Windows-oriented同一引用文献的不同版本。