Swift是否支持文档生成?

许多语言都支持文档注释，以允许生成器(如javadoc或doxygen)通过解析相同的代码来生成代码文档。

Swift有类似的文档注释功能吗?

当前回答

从Xcode 5.0开始，支持Doxygen和HeaderDoc结构化注释。

源

其他回答

如果你只使用Swift，那么Jazzy值得一看。

https://github.com/realm/jazzy

我在Xcode二进制文件中发现了一些有趣的东西。以.swiftdoc结尾的文件。它肯定有文档，因为这些文件包含Swift UIKit / Foundation API的文档，不幸的是，它似乎是一种专有的文件格式，用于Xcode中的文档查看器。

Swift包含了"///"注释处理(尽管可能还不是全部)。

可以这样写:

/// Hey!
func bof(a: Int) {

}

然后选项-点击func名称和voilà:)

也许关注一下AppleDoc或苹果自己的HeaderDoc是个好主意，它不太被认可。我仍然可以在10.9 Mavericks终端中找到一些HeaderDoc提示(headerdoc2html)

我推荐阅读最新的“Xcode的新功能”*(不确定它是否仍处于保密协议之下) *链接指向Xcode 5.1版本，其中也包含有关HeaderDoc的信息。

从Xcode 5.0开始，支持Doxygen和HeaderDoc结构化注释。

源

推荐文章