Formatting Doxygen@todo标签

Formatting Doxygen@todo标签,formatting,doxygen,todo,Formatting,Doxygen,Todo,在最新版本的doxygen(1.8)的列表中,当我在@todo命令下面有其他格式化数据时,我遇到了一个奇怪的问题。考虑下面的例子: /** @page build_instructions Build Instructions - Library1 - @todo Detail build process - get source - build release/debug version for x64 - build release/debug versio

在最新版本的doxygen(1.8)的列表中,当我在
@todo
命令下面有其他格式化数据时,我遇到了一个奇怪的问题。考虑下面的例子:

/**
@page build_instructions Build Instructions
- Library1
    - @todo Detail build process

    - get source
    - build release/debug version for x64
    - build release/debug version for x86
*/
如果运行它,您会注意到
@todo
标记在最后两个列表项(在“get source”之后)添加了额外的缩进。如果删除
@todo
标记,则缩进看起来正常。此外,如果我删除
@todo
前面的
-
,它会将下面的项目包含在一个框中


这是虫子吗?如何使
@todo
标记只影响一行?

我可以确认这一点:您的代码在1.5中工作,而不是在1.8中,因此它看起来像一个bug。以下是两种可能的解决办法:

  • 尝试将
    todo
    项作为列表中的最后一个元素

  • 如果要将
    todo
    项放在列表的顶部(或最后一个元素以外的任何位置),请尝试在
    todo
    项后面的每个列表项之间放置一个空行