php使用哪些工具生成文档

发布于 2024-11-15 19:26:26 字数 376 浏览 1 评论 0原文

全部。我查看了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 技术交流群。

扫码二维码加入Web技术交流群

发布评论

需要 登录 才能够评论, 你可以免费 注册 一个本站的账号。

评论(1

佞臣 2024-11-22 19:26:26

{{{ }}} 最有可能在 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?

~没有更多了~
我们使用 Cookies 和其他技术来定制您的体验包括您的登录状态等。通过阅读我们的 隐私政策 了解更多相关信息。 单击 接受 或继续使用网站,即表示您同意使用 Cookies 和您的相关数据。
原文