基本上,我正在尝试按照以下方式编写文档代码:
//Description of Step 1
DoStep1_1();
DoStep1_2();
...
//Description of Step 2
DoStep2_1();
DoStep2_2();
我希望这两个注释块变成 Doxygen 输出中的有序列表。我已经阅读了有关创建列表的文档,并且我知道我可以只使用 HTML 标签,但看起来在要生成的标签之间生成了额外的东西,这会导致两个项目之间出现空白。最终,我不想使用 HTML 标签;也就是说,我宁愿只使用
/*!
-# Description of Step 1
*/
DoStep1_1();
DoStep1_2();
...
/*!
-# Description of Step 2
*/
DoStep2_1();
DoStep2_2();
或类似的规定。这甚至可能吗?
编辑: 好的,所以我可能没有描述我得到的结果和我想要的结果。从上面的代码生成的 HTML 类似于:
步骤 1 说明
- Step2的说明
请注意,有 2 个段落标签是我不想要的,因为它们会导致不需要的空格。