在doxygen文档中,如何创建指向文件特定行的链接

wip*_*wip 7 doxygen line hyperlink

有几个doxygen的命令,其目的是创建的文档中的链接(@link,@ref).
我目前正在使用@ref命令创建一个自定义文件的链接,该文件是用doxygen(xml)不支持的语言编写的.
我想改变这个链接,使其指向文件中的精确行.
是否有doxygen命令允许这样做?

Chr*_*ris 6

我不确定\ref\link能做到这一点.但是,如果可以的话,采用这种方法的一个问题是,如果在不更改链接的情况下更改要链接的文件的内容,链接将变为无效.这是分离源代码和文档的问题之一.

而不是链接到另一个文件中的特定行,为什么不在文档中包含您感兴趣的文件的特定部分?你可以:

  • 包括整个文件\include(也有\includelineno),并在文本中引用它的相关部分(例如"下面代码中的函数xxx"),或者
  • 包括文件的片段,您需要在文档中使用它来引用它们\snippet.

编辑:此外,还可以使用\dontinclude命令其中,连同\line,\skip,\skipline,和\until命令允许包括特定文件的特定行/块.请参阅\dontinclude文档中的示例.