在使用cocos2d进行游戏开发的过程中，难免要查阅cocos2d的API文档。搞清楚怎么使用某个类或者某个方法。幸运的是，cocos2d的作者已经在源码里面加入了文档凝视，我们仅仅须要使用文档生成工具解析源码生成文档就可以。
最经常使用的文档生成工具是Doxygen。
用Doxygen处理cocos2d文档有2种方式：
第1种方式：安装Doxygen软件，解析cocos2d源码。生成html格式的静态文档
第2种方式：利用cocos2d自带的Doxygen功能，将文档集成到Xcode中
以下我分别具体说明上述2种方式的实现步骤：
生成HTML文档
1.下载dmg格式的Doxygen软件http://www.stack.nl/~dimitri/doxygen/download.html#latestsrc
2.安装好Doxygen后，打开软件进行參数设置
3.点击Run doxygen開始生成文档
4.生成完成后。打开文档的生成位置（刚才设置的是cocos2d目录）。多了一个html目录，
5.打开html目录中的index.html文件，这个是文档的入口
6.这里能够查看全部的类
7.我们来看看CCSprite类
8.有继承结构图
9.有方法列表
10.点击某个方法，还能够看到方法的具体说明
到这里为止。html格式的文档就搞定了
将cocos2d的文档集成到Xcode中
说明：cocos2d版本号是1.0.1，Xcode版本号是4.5
前提：先安装上面的Doxygen软件到Applications(应用程序)文件夹下
1.打开cocos2d中的doxygen.config文件，设置成输出中文文档（事实上仅仅是部分keyword为中文，这个步骤能够省略）
2.双击打开cocos2d-ios.xcodeproj
3.设置cocos2d-documentation为target
4.编译这个target
提示：点击编译后，会自己主动运行一些脚本去生成文档。请耐心等待。编译过程中会产生非常多错误和警告，这个不影响文档的生成，能够忽略
5.看到Build succeed就代表文档生成完成，这时候请全然退出Xcode后再又一次打开Xcode。接着查看文档
6.能够看到cocos2d的文档已经集成到Xcode中了
7.事实上本质是将文档打包成一个.docset文件。然后生成到：/Users/apple/Library/Developer/Shaerd/Documentation/DocSets目录中(我的username叫apple)，Xcode会去这里载入全部的文档，只是仅仅会在打开Xcode时载入一次，这也是要全然重新启动Xcode才干查看新生成的cocos2d文档的原因
两种处理cocos2d文档的方式都介绍完了，个人更推荐採取第2种方式：集成到Xcode中，这也是开发中最常见的方式
原文地址：http://blog.csdn.net/q199109106q/article/details/8590609
感谢作者~！
本文转自mfrbuaa博客园博客，原文链接：http://www.cnblogs.com/mfrbuaa/p/5181862.html，如需转载请自行联系原作者
