Documentation Doxygen@file在标记文件中工作吗？

我在使用Doxygen 1.8.5处理的

.md

文件中遇到了标记和

@file

混合的问题

如果我使用：

# Release Notes

@file releases.md
Release notes

@tableofcontents

@section rel_page Release History

Blah blah blah

我只得到HTML中的页面标题（由第一行

#

生成）。为完整起见，无论是否存在“releases.md”文件名，都会发生这种情况（根据手册，这是可选的）

但是，如果我删除

@文件

行

# Release Notes

@tableofcontents

@section rel_page Release History

Blah blah blah

这一切都很完美

我的语法有错误吗？@file不支持作为Doxygen降价支持的一部分，还是这是一个bug

Doxygen手册中的

@文件

或标记部分都没有关于任何约束的内容

---

与我的另一个（风滚草）有一些相似之处。

手册部分中列出的命令不适用于标记。使用

@file

可以获得如下效果：

Release notes {#releases}
=============

@tableofcontents

@section rel_page Release History

Blah blah blah

---

如果能把这些信息写进手册里就太好了。遗憾的是，它不起作用，降价和结构化的doxygen组合会非常有用——这就是我们最初选择doxygen执行任务的原因。如果您可以在bug tracker（）中为此提交一份bug报告，并提供一个您希望看到它起作用的示例，那么我将看看需要什么来支持它（如果发现太难，可在手册中添加注释）。