异常标签中的 Doxygen 列表呈现不正确

Question

符号主文档中的列表...

/**
 * - foo
 * - bar
 * - wah
 */

在 Doxygen 中作为要点很好地呈现：

exception 标签的 Doxygen documentation 包括：

[@exception 之后] 段落的文本没有特殊的内部结构。所有视觉增强命令都可以在段落内使用。每个异常描述都将从新行开始。 \exception 描述在遇到空行或其他分段命令时结束。

尽管“所有视觉增强命令都可以在段落内使用”，但似乎列表在exception标签内无法正确呈现，可能是由于对行尾的严格处理。

同一个列表，在 exception 标签内...

/**
 * @exception myError
 * - foo 
 * - bar 
 * - wah
 */

以奇怪的间隔呈现为项目符号：

Doxygen 有可能将列表中的每个元素解释为单独的“异常描述”，并因此用换行符分隔它们。 我怎样才能避免这种行为，使列表以与主文档中相同的方式呈现为项目符号？

我在 Ubuntu 18.04 上使用 Doxygen 1.8.13。 Here 是我的 doxygen 配置文件，它错误地呈现了以下 MWE：

/**
 * - foo 
 * - bar 
 * - wah
 * @exception myError
 * - foo 
 * - bar 
 * - wah
 */
void myFunc();

Answer 1

Doxygen 1.8.13 已经有点老了（2016 年 12 月），我当然建议更新到当前版本 1.9.1 但这不是问题的原因/。

提供的 Doxyfile 并不是最小的，并且包含许多与当前问题无关的项目特定内容。一个带有

的doxyfile

EXTRACT_ALL=YES
QUIET=YES

足够了。

当运行给定的输入时，我们得到：

问题是我们希望在哪里拥有单词Exceptions 和随后的列表项？ 目前第一组列表项直到第二个- wuh 之后才终止，Exceptions 被视为第一个wuh 列表项的一部分，第二个foo 被视为一级列表项，因此上面显示的输出。

一种解决方案（不是@exception 之后的项目之前的额外空间，使其成为二级列表）：

/**
 * - foo
 * - bar
 * - wah
 * @exception myError
 *   - foo
 *   - bar
 *   - wah
 */
void myFunc();

结果：

可能是想要的解决方案（注意@exception 之前的空行，它终止了第一个列表）：

/**
 * - foo
 * - bar
 * - wah
 *
 * @exception myError
 * - foo
 * - bar
 * - wah
 */
void myFunc();
~                

结果：

（我用 1.8.13 版本运行一切）