为本身包含 .tag 文件的库包含 .tag 文件会引发重复的锚点警告
Including a .tag file for a library which itself includes a .tag file can provoke duplicate anchor warnings
我有三个库——libA、libB 和 libC。
libA 有一个 .dox 文件,其中包含以下锚点:
\section First_Section First Section
\subsection First_Subsection First Subsection
libB 包含 libA 的标记文件,如下所示:
@TAGFILES = $(DOXY_OUTPUT)/../libA/libA.tag=../libA
libC包含libA和libB的tag文件,如下:
@TAGFILES = $(DOXY_OUTPUT)/../libA/libA.tag=../libA \
$(DOXY_OUTPUT)/../libB/libB.tag=../libB
但是,当我在 libC 上 运行 doxygen 以生成 libC 的文档时,我看到以下警告消息:
libB.tag:警告:找到重复的锚 First_Section
libB.tag:警告:找到重复的锚 First_Subsection
看来,因为 libB 使用 libA 的标记文件,当 libC 尝试使用 libB 的标记文件时,它实际上已经从 libA 获得了锚点,因此它认为它在 libB 中找到的与 libA 相关的锚点是重复的。
我正在使用 Doxygen 1.8.10。
以OP提供的例子为例。在 https://bugzilla.gnome.org/show_bug.cgi?id=793088 OP。 1.8.13版本没有问题。我的测试还显示 1.8.14 不再有警告。
解决方法:升级到新版本。
我有三个库——libA、libB 和 libC。
libA 有一个 .dox 文件,其中包含以下锚点:
\section First_Section First Section
\subsection First_Subsection First Subsection
libB 包含 libA 的标记文件,如下所示: @TAGFILES = $(DOXY_OUTPUT)/../libA/libA.tag=../libA
libC包含libA和libB的tag文件,如下:
@TAGFILES = $(DOXY_OUTPUT)/../libA/libA.tag=../libA \
$(DOXY_OUTPUT)/../libB/libB.tag=../libB
但是,当我在 libC 上 运行 doxygen 以生成 libC 的文档时,我看到以下警告消息:
libB.tag:警告:找到重复的锚 First_Section libB.tag:警告:找到重复的锚 First_Subsection
看来,因为 libB 使用 libA 的标记文件,当 libC 尝试使用 libB 的标记文件时,它实际上已经从 libA 获得了锚点,因此它认为它在 libB 中找到的与 libA 相关的锚点是重复的。
我正在使用 Doxygen 1.8.10。
以OP提供的例子为例。在 https://bugzilla.gnome.org/show_bug.cgi?id=793088 OP。 1.8.13版本没有问题。我的测试还显示 1.8.14 不再有警告。
解决方法:升级到新版本。