Xcode 文档注释语法

【问题标题】：Xcode documentation comment syntaxXcode 文档注释语法
【发布时间】：2015-02-02 07:25:00
【问题描述】：

我想知道是否有人可以解释 Xcode 中以下两种注释语法之间的区别/是否有任何区别。

/**
 * comments
 */

/*!
 * comments
 */

似乎两者都允许 Xcode 将您的 cmets 显示为文档，但我不确定两者之间是否有区别。

【问题讨论】：

【解决方案1】：

它们在功能上是等效的。 /*! 是HeaderDoc 风格的开瓶器，/** 是JavaDoc 风格的开瓶器，doxygen 常用。 Xcode 5 支持 HeaderDoc 和 doxygen/JavaDoc 格式。

【讨论】：

【解决方案2】：

两者在功能上是等效的。

区别：

Doxygen 风格
如果您使用headerdoc2html 命令，基于/** 的cmets 将不会出现在文档文件中，它将跳过这些cmets（请参阅HeaderDoc not generating HTML Documentation）

【讨论】：