Как указано в Справочнике по форматированию разметки , вы можете использовать символы *
, +
или -
в качестве префиксов для ключевых слов разметки. Например, взгляните на Parameter
:
![enter image description here](https://i.stack.imgur.com/1lQmt.png)
Теперь, когда я пытаюсь использовать *
, разметка не работает:
/**
* Parameter piece: A piece to validate.
* Parameter matchBlock: Called only if necessary.
*/
init(piece: MSPiece?, matchBlock: MatchBlock) { ... }
Приведенный выше код приводит к:
![enter image description here](https://i.stack.imgur.com/q9xJ3.png)
Но если мы поставим +
или -
вместо *
,
/**
+ Parameter piece: A piece to validate.
- Parameter matchBlock: Called only if necessary.
*/
init(piece: MSPiece?, matchBlock: MatchBlock) { ... }
Документация будет правильной:
![enter image description here](https://i.stack.imgur.com/aKxWt.png)
Почему не *
не работает? Было бы здорово использовать звездочку, потому что /** */
комментирует статистику и заканчивается звездочкой, и это будет действительно аккуратно.