如何使用phpdoc生成php文档...
时间:2010-08-11 来源:rcom10002
1. 下载phpdoc
官网地址(已经N久没更新了,不知道是不是不想干了):http://www.phpdoc.org/;下载地址:http://sourceforge.net/projects/phpdocu/files/
2. phpdoc -h
文件下载后解压,然后进入解压目录,编辑 phpdoc/phpdoc.bat 文件确保文件运行时可以找到 php 程序。然后运行 phpdoc -h 来查看帮助信息。
3. 生成文档
phpdoc -d "C:/Documents and Settings/Administrator/My Documents/Workspace/php eclipse/codeslab/questions" -t "C:/Documents and Settings/Administrator/My Documents/Workspace/php eclipse/codeslab/questions/doc" -j on -ti "Question Parser Component" -s on -dn questions -dc questions
4. 参数说明
-d -t 分别代表输入和输出目录,即源码目录与生成文档目录;-j 指的是 Java 兼容模式,默认是 off,关闭着的(实际使用中,最好指定,否则生成的文档简直没法看);-ti 标题;-s 生成代码,仅 php 4.3.0+ 版本有效,不需要生成源码可以忽略此项。-dn 和 -dc 是默认包名和类型名,如不指定则使用“default”字样,最好指定下,要不太难看了。
5. 截图