@file
我在.md
使用 Doxygen 1.8.5 处理的文件中混合使用降价和文件时遇到问题。
如果我使用:
# Release Notes
@file releases.md
Release notes
@tableofcontents
@section rel_page Release History
Blah blah blah
除了 HTML 中的页面标题(由第一#
行引起)之外,我什么也没有。为了完整起见,无论是否存在“releases.md”文件名,都会发生这种情况(根据手册,它是可选的)。
但是,如果我删除该@file
行...
# Release Notes
@tableofcontents
@section rel_page Release History
Blah blah blah
这一切都完美无缺。
我的语法是否错误,是否不支持 @file 作为 Doxygen 的降价支持的一部分,或者这是一个错误?
Doxygen 手册中的任何@file
部分或降价部分都没有关于任何约束的内容。
与我关于 markdown 和 groups的其他(风滚草)问题有一些相似之处。