formatting - 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 标记向最后两个列表项(“获取源代码”之后)添加了额外的缩进。如果您删除 @todo 标记，那么缩进看起来没问题。此外，如果我删除 @todo 前面的 -，它会将其下方的项目包含在一个框中。

这是一个错误吗？如何让 @todo 标签只影响一行？

Answer 1

我可以确认这一点:您的代码在 1.5 中有效，但在 1.8 中无效，所以它看起来像是一个错误。以下是两种可能的解决方法:

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

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