用phpDocumentor来生成文档

首先是安装
linux下
#pear upgrade PhpDocumentor
或者直接去http://sourceforge.net/projects/phpdocu/files/  下载包（要!翻@墙） ，然后再编译，
编译前确认你的php支持了zlib的话，可以直接
#pear install PhpDocumentor-1.4.4.tgz
#cd PhpDocumentor-1.4.4
#chmod 755 phpdoc
./phpdoc -h

使用很简单
#phpdoc -d /home/www/f404/ -t /home/www/f404/doc/ -ti 'f404doc' -dn 'f404man'
参数说明 -d 后面跟着的是项目所在文件夹
                  -t 后面跟着是你要把文档存在的文件夹
                  -ti   后面是设置项目标题的

                  -dn 后面 是定义默认的包名

如果中文乱码，直接在浏览器里面设置网页编码为utf-8就可以了。或者去生成的doc里面，把表头的iso-8859-1改成utf-8

需要你自己在php文件里面规范的文档参数

@author 作者信息
@const 由define定义的常量
@deprecate 不建议使用的API
@global 全局变量
@package 包
@param 参数
@return 返回
@see 参考，超链接
@link 类似@see.只包含对元素的引用，如@link Command::excute()
@since 引入时间
@static 静态变量
@var 每个类属性类型
@license 许可信息
@lar 每个类属性类型