为什么星号在 Xcode 快速帮助标记中不起作用？

Question

作为Markup Formatting Reference states, you can use *,+ or - characters as prefixes for markup keywords. For example, take a look at Parameter:

现在，当我尝试使用 * 时，标记不起作用：

/**
 * Parameter piece: A piece to validate.
 * Parameter matchBlock: Called only if necessary.
 */
init(piece: MSPiece?, matchBlock: MatchBlock) { ... }

以上代码导致：

但是如果我们用 + 或 - 代替 *,

/**
 + Parameter piece: A piece to validate.
 - Parameter matchBlock: Called only if necessary.
 */
init(piece: MSPiece?, matchBlock: MatchBlock) { ... }

文档将是正确的：

为什么 * 不起作用？使用星号实际上很酷，因为 /** */ 评论统计信息以星号结尾，而且它真的很整洁。

Answer 1

这是一个错误，已在 Xcode 10.0 中修复。