Doxygen嵌套的命名空间导致通过.tag文件引用的显示不正确

时间:2013-07-24 14:40:34

标签: namespaces nested doxygen

我正在使用Doxygen 1.8.4。我看到以下问题,这在我以前的Doxygen版本中没有发生 - 1.7.1.2

我创建了两个项目 - TestProject1和TestProject2


TestProject1

包含1个头文件XBO.h,如下所示:

/*! \brief XBO is boring   */
namespace XBO {

 /*! \brief XBONestedNS is also boring
    */
  namespace XBONestedNS {
}
}

通过doxygen运行此文件后,我在结果文档目录中获得了一个标记文件,如下所示:

<?xml version='1.0' encoding='UTF-8' standalone='yes' ?>
<tagfile>
  <compound kind="namespace">
    <name>XBO</name>
    <filename>namespaceXBO.html</filename>
    <namespace>XBO::XBONestedNS</namespace>
  </compound>
  <compound kind="namespace">
    <name>XBO::XBONestedNS</name>
    <filename>namespaceXBO_1_1XBONestedNS.html</filename>
  </compound>
  <compound kind="dir">
    <name>TestProject1</name>
    <path>/abc1/users/someuser/userbranch/project/src/library/TestProject1/</path>
    <filename>dir_a1513fb003dc8c1062e5770a29b83379.html</filename>
    <file>XBO.h</file>
  </compound>
</tagfile>

TestProject2

包含1个头文件,如下所示

YBO.h
/*! \brief YBO is boring */
namespace YBO {
}

在TestProject2的makefile.doxygen中,引用了TestProject1中的.tag文件,如下所示:

@TAGFILES          = $(DOXY_OUTPUT)/../TestProject1/TestProject1.tag=../TestProject1

创建TestProject2的doxygen文件时,命名空间XBO(来自TestProject1)错误地包含在TestProject2的命名空间列表中。

换句话说,当一个项目被另一个项目引用并且该项目包含一个嵌套的命名空间时,第一个项目的顶级命名空间(即其中嵌套命名空间的命名空间)显示在该文件的doxygen文档中。第二个项目。

0 个答案:

没有答案