PHPDoc的状态是什么？

Question

我之前从未关心过记录我的代码,但最近我开始研究一个开源项目并且需要出现.显然'选择的武器'是PHPDoc,但......

我真的找不到PHPDoc标准的单一规范.有一个维基百科条目列出了一些属性,并且有一个phpDocumentor项目,据说有一个更广泛的字典,但令我困惑的是PHPDoc的权威指南在哪里？有没有一个单一的标准,或者由所有那些众多的phpDocumentor仿冒品扩展PHPDoc"标准"(如果有的话)到他们认为合适的任何东西.

如果我们假设phpDocumentor是创建和维护PHPDoc标准的地方,事情看起来非常严峻,因为该项目的网站已经死了近4年了.更令我困惑的是,大约一个月前,phpDocumentor的Pear网站上突然出现了1.4.4版本.

我知道周围有很多聪明且知识渊博的伙伴,所以我想知道.与PHPDoc有什么关系.是否有一个权威机构创建标准？它有多可靠？有没有未来或我们正在处理一个僵尸,所有希望都失去了......

谢谢,伊沃

Answer 1

这个问题已经有点老了，但为了提供信息，我应该补充一下 DocBlox 已与 PhpDocumentor 合并。

\n\n

\n

宣布 phpDocumentor 2 \xe2\x80\x93 合并旧版 (phpDocumentor)\n 和新版 (DocBlox)。

\n\n

随着 phpDocumentor (2.0.0a1) 的第一个 alpha 版本的推出，新的 \n \xe2\x80\x9cResponsive\xe2\x80\x9d 默认模板采用了新的页面布局，以及原始 DocBlox 模板的\n 有用的布局改进\n 在旧的 phpDocumentor 模板上提供（仍然可用）\n（将随旧的 phpDocumentor 一起停用）。请访问http://demo.phpdoc.org/Responsive/index.html探索这个新模板\n 。

\n

\n\n

=> http://www.docblox-project.org/2012/03/docblox-is-unmasked-it-is-really-phpdocumentor-2/

\n\n

PHPDoc 又回到了正题。=)

\n