\includedoc 的 Doxygen 使用

Question

Doxygen documentation关于 \includedoc “这个命令的工作方式与 \include 相同，但它将包含文件的内容，就好像它在这个地方一样命令被调用。”

所以我设置了 EXAMPLE_PATH = includepages (Doxyfile) 并在 includepages 子文件夹中创建了一个名为 test.dox 的文件。

为确保用法正确，这是 test.dox 的内容:

/*!
 *  THIS IS A TEST
 */
 THIS IS AN OTHER TEST

这是我的做法 包括此页面:

 *  \include test.dox
 *
 *  \includedoc test.dox

这将导致:

如您所见，\include test.dox 按预期工作。给出文件 test.dox 的无 doxygen 部分(THIS IS AN OTHER TEST)。但是不是打印 THIS IS A TEST \includedoc test.dox 而是打印文件名？我不知道出了什么问题。

谢谢你的帮助
汤姆

系统信息(SuSE Leap 42.2)

# uname -a
Linux twa 4.4.74-18.20-default #1 SMP Fri Jun 30 19:01:19 UTC 2017 (b5079b8) x86_64 x86_64 x86_64 GNU/Linux
# doxygen --version
1.8.11
# dot -V
dot - graphviz version 2.38.0 (20140413.2041)

Answer 1

我终于成功使用了最新版本的Doxygen。

这是在 Linux 上使用 Doxygen 1.8.13 的快速路径:

wget http://ftp.stack.nl/pub/users/dimitri/doxygen-1.8.13.src.tar.gz
tar xvf doxygen-1.8.13.src.tar.gz 
cd doxygen-1.8.13/
cmake -G "Unix Makefiles"
make
sudo mkdir /opt/doxygen-1.8.13
cp bin/doxygen /opt/doxygen-1.8.13

现在您可以选择通过调用 doxygen 使用您的分发维护版本或通过调用 /opt/doxygen-1.8.13/doxygen 使用您自己的构建版本。