Doxygen不会更新重复文件的注释

Question

我正在使用doxygen为某些.c和.h文件（仅文件级别注释）提供注释。有一些文件被复制（同名）并存在于不同的子文件夹中。所以，当我为这些文件提供注释时，doxygen不会在生成的html文件中更新它。

我读了下面的链接提供的doxygen命令描述，并试图提供这些文件的路径，使它们独一无二，但这也不起作用。

http://www.doxygen.nl/commands.html#cmdfile

我尝试到现在的选项如下。考虑Nm.h是具有多份文件：

1. /*! \file Nm.h * \brief Header file */ 2. /*! \file \sgdcc\checkdrive\test\Nm.h * \brief Header file */ 3. /*! \file sgdcc\checkdrive\test\Nm.h * \brief Header file */

评论没有得到一个单一的文件，甚至更新。我尝试提供短路径以及完整路径，但没有任何工作。

我compliling通过ClearCase和它使用的doxygen doxygen的版本是1.8.2

请帮我解决这个问题。

Answer 1

用“普通”斜杠替换路径中的反斜杠。例如：

/*! \file Nm.h 
    * \brief Header file 
    */ 

/*! \file /sgdcc/checkdrive/test/Nm.h 
    * \brief Header file 
    */ 

/*! \file sgdcc/checkdrive/test/Nm.h 
    * \brief Header file 
    */ 

您正在路径中使用反斜杠，它是指示命令跟随的控制字符。路径应始终包含正常的斜杠。