Html 如何将多个备注组合成一个段落？

我对doxygen比较陌生，在我编写更多Java时更喜欢Javadocs，在我为IBM工作时更喜欢常规的字处理工具

我的注释风格是在整个代码库中包含大量的运行说明，以便代码的目的非常明确。我更愿意重新编写该文本，以便将其用于我正在制作的API的外部文档

当我使用\remark标记时，我在HTML输出中将每个\remark作为单独的段落结束。那不是我想要的样子。我也不希望有一个可能包含6或8个代码块的巨型注释

---

我的问题是-我如何告诉doxygen将多个\remark部分合并到一个段落中，只有在我需要的时候才开始一个新段落？

我不确定我是否完全理解这个问题，但如果问题是：如何在一个备注标记中使用多个段落，您可以使用parblock和endparblock命令：

/**
 *  \file utils.h
 *  \brief TODO complete the documentation of utils.h
 *
 * \remark  Lorem ipsum dolor sit amet, ex everti iracundia laboramus vel, in tota sensibus posidonium eam. His ei expetenda splendide, has eu iusto delicatissimi. Mei dolor deseruisse et. Viris graeco necessitatibus an est, quod reque vulputate sea cu, an has simul nihil numquam. Modo animal assentior pri ut, te mea duis prima, esse sonet ut vim. Duo in duis legere molestie.
 *
 * Ea mel prima atomorum liberavisse, ei odio voluptua dissentiet vix. Vix an ornatus suscipit perfecto. Ut propriae omnesque cum, usu ferri commune tacimates te, erant definitionem vim id. Vix cu copiosae imperdiet. Vis fierent nominati patrioque et, eam menandri vituperatoribus ei, ea has veritus volutpat neglegentur. Ius cu posse novum utroque.
 *
 * Ad per nobis periculis, legere cetero duo ut. In vis nihil admodum suscipit, per alia consequat expetendis ad, ex erant vocibus adversarium mel. Vix ut modus gloriatur, falli vitae eu eam, te per dicat persius. Vis nostrud maiorum et, sea ut etiam perfecto. Cum ut quod legimus convenire, iriure fabellas gloriatur qui ex.
 *
 * \remark
 *
 * \remark \parblock
 *
 * Lorem ipsum dolor sit amet, ex everti iracundia laboramus vel, in tota sensibus posidonium eam. His ei expetenda splendide, has eu iusto delicatissimi. Mei dolor deseruisse et. Viris graeco necessitatibus an est, quod reque vulputate sea cu, an has simul nihil numquam. Modo animal assentior pri ut, te mea duis prima, esse sonet ut vim. Duo in duis legere molestie.
 *
 * Ea mel prima atomorum liberavisse, ei odio voluptua dissentiet vix. Vix an ornatus suscipit perfecto. Ut propriae omnesque cum, usu ferri commune tacimates te, erant definitionem vim id. Vix cu copiosae imperdiet. Vis fierent nominati patrioque et, eam menandri vituperatoribus ei, ea has veritus volutpat neglegentur. Ius cu posse novum utroque.
 *
 * Ad per nobis periculis, legere cetero duo ut. In vis nihil admodum suscipit, per alia consequat expetendis ad, ex erant vocibus adversarium mel. Vix ut modus gloriatur, falli vitae eu eam, te per dicat persius. Vis nostrud maiorum et, sea ut etiam perfecto. Cum ut quod legimus convenire, iriure fabellas gloriatur qui ex.
 *
 * \endparblock
 *
 * \remark
 *  third remark
 */

以下是HTML输出：。 您始终可以通过以下链接检查parblock文档。

---

如果您仍然对HTML输出不满意，我建议您添加一个自定义CSS文件，指定备注规则。您可以通过HTML_EXTRA_样式表添加其他CSS文件：有一个名为section remark的CSS类，应该允许您自定义外观；更多关于这个的信息。我希望我能帮到你。

我在寻找相反的方法-将多个非连续的\remark标记组合到一个段落中。我将查看\parblock，看看它是否能满足我的需要。不。简短的回答似乎是没有办法创建一个文本转移，它将从多个注释块收集文本，然后将其作为单个段落发送。我知道这很旧，但我在尝试在\test命令中使用\copydoc时遇到了同样的问题，但是使用\copydoc会自动启动一个新段落，就像\remark一样，甚至从\parblock内部开始