许多语言都支持文档注释，以允许生成器(如javadoc或doxygen)通过解析相同的代码来生成代码文档。
Swift有类似的文档注释功能吗?
当前回答
Swift包含了"///"注释处理(尽管可能还不是全部)。
可以这样写:
/// Hey!
func bof(a: Int) {
}
然后选项-点击func名称和voilà:)
其他回答
Jazzy可以帮助生成漂亮的苹果风格的文档。 下面是一个示例应用程序，详细介绍了如何快速使用和配置。
https://github.com/SumitKr88/SwiftDocumentationUsingJazzy
也许关注一下AppleDoc或苹果自己的HeaderDoc是个好主意，它不太被认可。 我仍然可以在10.9 Mavericks终端中找到一些HeaderDoc提示(headerdoc2html)
我推荐阅读最新的“Xcode的新功能”*(不确定它是否仍处于保密协议之下) *链接指向Xcode 5.1版本，其中也包含有关HeaderDoc的信息。
在Xcode编辑器->结构->添加文档。
Swift包含了"///"注释处理(尽管可能还不是全部)。
可以这样写:
/// Hey!
func bof(a: Int) {
}
然后选项-点击func名称和voilà:)
从Xcode 5.0开始，支持Doxygen和HeaderDoc结构化注释。
源
