注释生成文档工具——appledoc 与xcode自带的官方headerDoc比较后，选appledoc。

一开始尝试了官方的文档工具headerDoc，发现竟然不能直接 option+commad+／注释生成想要的文档内容，它的格式比较奇葩，需要将 /** 修改为 /*!  ； 而且必须在 每个 .h文件的 @interface前面，为每个类 多加一个 /*!  @class 类名 @abstract 详情          */ 否则，你在html网页上你看不到那个类名，也就找不到那个点击入口了。

>>阅读原文<<