您知道有一种工具可以轻松地为 JavaScript 和 PHP 代码创建文档吗?
在类似于下图的代码中接受注释的东西:
/**********************************************************
This function does something special...
param1: ...
param2:
RETURNED VALUES:
...
**********************************************************/
function something(...)
{
...
并将这些转换为 HTML 文件(可能在左侧带有框架集菜单)。 不需要上面显示的相同语法,这只是一个解释我在说什么的例子。
只想要一个工具,所以一旦我学会了编写文档的语法,我就可以对 PHP 和 JavaScript 使用相同的文档语法。
如果该工具是二进制 (.exe) 或 Java 代码,无需安装 PERL 或 PYTHON,那就太好了。