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在撰写本文时，最新版本的Doxygen（1.8.15）仍然具有相同的行为，并且转义反斜杠仍然无效。我现在正在使用以下解决方法：

`-L$``$(MKLROOT)`

虽然很丑陋，但却可以工作，不需要在各处添加<code>标签。

我还在Doxygen中创建了an issue，要求对此进行更改。