php使用哪些工具生成文档
全部。我查看了php源代码,发现源代码注释使用了这种风格
/* {{{ proto resource pfsockopen(string hostname, int port [, int errno [, string errstr [, float timeout]]])
Open persistent Internet or Unix domain socket connection */
PHP_FUNCTION(pfsockopen)
{
php_fsockopen_stream(INTERNAL_FUNCTION_PARAM_PASSTHRU, 1);
}
/* }}} */
,我对此很感兴趣,有人可以告诉我吗?谢谢 。
all. I view the php source code ,and found it souce code comment use this style
/* {{{ proto resource pfsockopen(string hostname, int port [, int errno [, string errstr [, float timeout]]])
Open persistent Internet or Unix domain socket connection */
PHP_FUNCTION(pfsockopen)
{
php_fsockopen_stream(INTERNAL_FUNCTION_PARAM_PASSTHRU, 1);
}
/* }}} */
I am interesting about this, does somebody can tell me ? thx .
如果你对这篇内容有疑问,欢迎到本站社区发帖提问 参与讨论,获取更多帮助,或者扫码二维码加入 Web 技术交流群。
绑定邮箱获取回复消息
由于您还没有绑定你的真实邮箱,如果其他用户或者作者回复了您的评论,将不能在第一时间通知您!
发布评论
评论(1)
{{{ }}} 最有可能在 vim 中用作折叠标记(尽管其他编辑器也可能提供使用此类符号标记折叠的可能性。)。如果这些是让你想知道的。
编辑:
注释似乎不适合文档生成,因为它似乎相当非结构化/自由形式。如果它的 php 源代码是用 C 编写的(我猜在这里),它很可能会使用 doxygen 来生成文档,而 php 程序本身使用 phpdoc。也许这是 php 源代码的一些自定义/编辑版本?
{{{ }}} are most likely used as folding markers in vim(though maybe other editor also offer a possibility to mark folds with such symbols.). If these are what made you wonder.
Edit:
Comment does not seem to be suitable for documentation generation since it seems to be quite unstructured/free form. If its php source code and is written in C(i guess here) it most likely would be using doxygen for generating documents, while php programs themselves use phpdoc. Maybe this is some custom/edited version of php source?