Doxygen如何避免“此行的多个标记”

时间:2012-09-25 09:12:16

标签: documentation doxygen

我有两个同名但在两个不同目录中的文件。

 graphic_test ---semLib.c
               |
               |
               -- vxWorksApi---semLib.c

我想用Doxygen构建一个Html。这是文件semLib.c的标题

 /**
 * @file    semLib.c
*/

我收到了这条消息

 Multiple markers at this line
        - the name `semLib.c' supplied as the second argument in the \file statement matches the following input files: /home/linuxdev/
         Linux_Development_Workspace/graphic_tests/graphic_test/semLib.c /home/linuxdev/Linux_Development_Workspace/graphic_tests/vxWorksApi/semLib.c
        - Line breakpoint: semLib.c [line: 2]

我该如何避免这种情况?

2 个答案:

答案 0 :(得分:1)

来自doxygen documentation for the \file command(强调我的):

  

\file

     

表示注释块包含名称为<name>的源文件或头文件的文档。 如果文件名不是唯一的,则文件名可能包含(部分)路径。

因此,请尝试在相应的文件中使用\file semLib.c\file vxWorksApi/semLib.c

答案 1 :(得分:0)

我遇到了同样的问题,并且上述更改仍无效: “所以尝试在相应的文件中使用\文件semLib.c和\ file vxWorksApi / semLib.c。”

我的情况不同,因为文件位于单独但并行的文件夹中,这对我有用: \ file xdir / semLib.c和\ file ydir / semLib.c在相应的文件中。

为了您的目的,请尝试为两者添加完整路径或部分路径: \ file adir / xdir / semLib.c和\ file adir / ydir / semLib.c在相应的文件中。