Xcode:用'///'或'//!'评论的区别关于文档

Xcode: difference in commenting with '///' or '//!' regarding documentation

Xcode 中,如果您在前面添加以 /////! 开头的单行注释(/**/*! 对于多行的)到方法声明,它显示在 Quick Help 中(例如,方法名称上的 Option Click)。

这些有什么区别吗?有人可以指出苹果开发者网站上记录的位置吗?

Xcode HeaderDoc 支持记录在 Mac Developer Library - HeaderDoc Tags

该文档自 2013 年以来未更新,但确实显示了支持的注释语法:/*! 和支持的 @ 标签等。三个斜线 /// 只是另一个进行内联块文档的方法。

/////! 未记录在 HeaderDoc 标记页面上。这些可能是在 Xcode 5 中添加的。 changelog 状态:

Project documentation from framework API reference documentation and structured comments in your own source code are displayed in the quick help panel and in code completion popover views. Doxygen and HeaderDoc structured comments are supported formats.