Markdown 使用@file在Doxygen中标记

Markdown 使用@file在Doxygen中标记,markdown,doxygen,github-flavored-markdown,Markdown,Doxygen,Github Flavored Markdown,我试图用doxygen和markdown记录一些源代码模板,并使用受保护的代码块 ~~~cpp /// @file filename.h ~~~ 但是Doxygen似乎在处理@file命令,即使它的逐字代码导致了警告 warning: the name `filename.h' supplied as the second argument in the \file statement is not an input file 我做错了什么?你必须避开“@”符号。改用\@file。为什

我试图用doxygen和markdown记录一些源代码模板,并使用受保护的代码块

~~~cpp
/// @file    filename.h
~~~
但是Doxygen似乎在处理
@file
命令,即使它的逐字代码导致了警告

warning: the name `filename.h' supplied as the second argument
in the \file statement is not an input file

我做错了什么?

你必须避开“@”符号。改用
\@file

为什么要逃跑?防护代码块应被视为逐字代码块,这意味着doxygen将忽略其间的所有命令,并使用未解析的内容。此答案适用于文本示例,但不适用于
\@brief my-brief description
——doxygen不会正确使用它。我和@Aeon512在同一条船上