C# .NET注释中的lists注释中的有序列表

Question

我得到了一些C#文档注释，如下所示：

/// <para>
/// Pre-Conditions:
/// </para>
/// <para>
///     1. The sky must be clear.
/// </para>
/// <para>
///     2. It must be night time.
/// </para>
/// <para>
/// Post-Conditions:
/// </para>
/// <para>
///     1. A picture of the sky will be saved.
/// </para>
/// <para>
///     2. Some second thing will be true that I can't think of.
/// </para>
/// <para>
/// Invariants:
/// </para>
/// <para>
///     1. Existing pictures will not be changed.
/// </para>
void TakePictureOfStars();

我让每件事都有自己的段落，这样当我在Visual Studio中使用鼠标悬停工具提示时，它就会正确地显示出来。

我使用Doxygen生成评论，但我一直得到以下HTML：

<ol type="1">
    <li>The sky must be clear.</li>
</ol>
<ol type="1">
    <li>It must be night time.</li>
</ol>

它看起来像这样：

1. The sky must be clear.

1. It must be night time.

因此，这里有一个问题:如何让每个编号的项目在Visual Studio工具提示中显示在各自的行中，并在代码输出中获得有序列表？

Answer 1

将MARKDOWN_SUPPORT设置为NO将避免1.2.3标记被视为有序列表。

要保留空格，可以使用<pre>和</pre>

/// <para><pre>
/// Pre-Conditions:
/// </pre></para>
/// <para><pre>
///     1. The sky must be clear.
/// </pre></para>
/// <para><pre>
///     2. It must be night time.
///        a. half moon
///        b. full moon
/// </pre></para>