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标签仅影响一行？

- Mihai Todor

Answer 1

我可以确认您的代码在1.5版本中有效，而在1.8版本中无效，因此似乎存在一个错误。以下是两种可能的解决方法：

• 尝试将todo项放置在列表的最后一个元素中，
• 如果您想要在列表中将todo项放在顶部（或任何不是最后一个元素的位置），则尝试在跟随todo项的每个列表项之间加入空行。

- Chris