Doxygen @todo标签

Question

在最新版本的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前面的-，它会将它下面的项包含在一个框中。

这是一个bug吗？如何使@todo标记只影响一行？

Answer 1

我可以证实这一点:您的代码可以在1.5中工作，但不能在1.8中工作，所以它看起来像是一个bug。下面是两种可能的解决方法：

• 尝试将todo项作为列表中的最后一个元素，如果希望将todo项放在列表的顶部(或除最后一个元素之外的任何位置)，请尝试在todo项之后的每个列表项之间放置一个空行。