doxygen - Doxygen 在主页内扩展环境变量

Question

我有一个mainpage.dox在配置文件中调用的文件：

USE_MDFILE_AS_MAINPAGE = ../mainpage.dox

在文档中，我提供了编译说明。我想将编译器选项列为-L/$(MKLROOT)/lib/intel64 -lmkl_rt，但是该$(MKLROOT)部分已扩展。有没有办法防止这种情况发生？

Answer 1

当我将以下内容放入 mainpage.md

1 Test with backticks `-L$(MKLROOT)/lib/intel64 -lmkl_rt`

2 Test without backticks -L\$(MKLROOT)/lib/intel64 -lmkl_rt 

3 Test with code <code>-L\$(MKLROOT)/lib/intel64 -lmkl_rt</code>
@verbatim
4 Test with verbatim -L$(MKLROOT)/lib/intel64 -lmkl_rt
@endverbatim

第$(MKLROOT)一个示例中的（错误地）扩展了。其他三个示例按预期工作（使用 doxygen 1.8.5）

请注意，USE_MDFILE_AS_MAINPAGE需要一个纯降价文件，而不是带有 /*! .. */ 注释块。

Answer 2

FWIW 在撰写本文时（1.8.15）的最新版本的 Doxygen 仍然以相同的方式运行，并且转义反斜杠仍然不起作用。我现在正在使用以下解决方法：

`-L$``$(MKLROOT)`

虽然丑陋，但它可以工作并且不需要在<code>任何地方添加标签。

我还在 Doxygen 中创建了一个问题，要求对此进行更改。