1. iOS 注释
1.1. 生成文档工具比较
1.1.1. HeaderDoc
只支持 HTML 输出，Xcode 自带的文档生成工具
1.1.2. Doxygen
支持 HTML，PDF, LaTeX 还有很多其它格式，功能强大，适于生成html文档与pdf文档。
1.1.3. appledoc
基于 Doxygen，简单方便，适于生成apple风格的html文档，及直接集成到xcode帮助（docset）
1.2. appledoc
1.2.1. 安装
方法一：
$ brew install appledoc
方法二：
git clone git://github.com/tomaz/appledoc.git
cd appledoc
sudo sh install-appledoc.sh -b /usr/local/bin/ -t ~/Library/Application\ Support/appledoc
1.2.2. 使用
appledoc --output output/path/ --project-name "project name" --project-company "greedlab" --company-id "com.greedlab" --clean-output source/path/
然后打开 output/path/ 下的文件有提示 .docset 文件路径，用 Dash 打开 .docset 文件。
1.3. Xcode
Xcode 支持的注释
1.3.1. swift 和 play ground
Xcode 支持的 swift 和 play ground 注释
1.3.2. objective C
Xcode 支持的 object C 注释
支持的注释
///
/**
*/
/*!
*/
支持的 Tag
没标题的
/**
DES
@brief brief
@discussion discussion
@param param
@code
I am code
@endcode
@return Bool whether
*/
@brief简介。 代码自动补全是提示
有标题的
/**
DES
@author author
@copyright copyright
@version version
@remark remark
@date date
*/