在两种情况下,我无法确定doxygen对\mainpage
部分的行为:
\mainpage
部分,那么它是否会使用任何其他页面,如果是,那么这是如何选择的?\mainpage
部分,该怎么办?答案 0 :(得分:9)
\mainpage
命令指定用于自定义索引页面的内容,因此如果您缺少一个,它只是一个带有正常Doxygen页眉和页脚的空白页面。
我认为对于拥有多个\mainpage
命令最安全的说法是,它是 undefined ,在经典意义上会产生不可预测的结果,具体取决于版本和平台。同样地,当我意外地创建了多个具有相同页面名称的\page
命令时,我得到了奇怪的结果。
进一步思考
由answering another Doxygen question提示,记住你可以让Doxygen遵守预处理程序指令,这样你就可以让#if条件保护多个mainpage指令并在同一代码库上运行不同的配置文件,其中配置文件定义一个几个旗帜值。
我已经使用此从不同角度生成文档方法来发布相同参考的Macintosh和Windows-oriented版本。