问题标签 [docblocks]

For questions regarding programming in ECMAScript (JavaScript/JS) and its various dialects/implementations (excluding ActionScript). Note JavaScript is NOT the same as Java! Please include all relevant tags on your question; e.g., [node.js], [jquery], [json], [reactjs], [angular], [ember.js], [vue.js], [typescript], [svelte], etc.

0 投票
6 回答
3048 浏览

delphi - Delphi 和/或 FreePascal 代码最常见的文档块

我对 PHP dockblocks 非常熟悉,因为过去 15 年多来我一直在从事这项工作。

我想了解的是是否有像 Delphi 和/或 FreePascal 这样的标准。

根据我对大量代码的分析,我从未见过任何代码,但我可能大错特错。

0 投票
4 回答
9621 浏览

php - 是否有可用的 PHP DocBlock 解析器工具?

我想为一些项目建立一些规模较小但高度定制的文档站点。PhpDocumentor非常棒,但它很重。我考虑过尝试为此调整模板,但只花了几分钟研究它后,我决定这将是太多的工作。

理想情况下,我希望看到可以传递一堆文件并让它返回所有文件、类、属性和方法以及它们的元数据的东西,这样我就可以构建一些基于数据。

是否有任何仅限 DocBlock 解析器的项目可以帮助我完成这项任务,还是我被困在重新发明那个轮子上?

0 投票
4 回答
9264 浏览

annotations - 从 db 模式生成带注释的学说 2 实体

是否可以从现有的数据库模式生成带有相关 docblock 注释的 Doctrine 2 实体?

0 投票
1 回答
119 浏览

linux - adding phpdoc to new files

im looking for a way to add some docblocks to a new .php file, so i can have it add the description, package name, author , etc to a new file.

i have been searching for a couple days and I dont see any results on how to add just to 1 .php file, maybe a console command or another utility?

Some sort of generator

0 投票
1 回答
902 浏览

ide - 如何设置动态函数的@return 值?

说我有这个功能:

使用它,我可以做到:

等等。两者都是不同的模型,具有不同的类、不同的功能等。

但是,我的自动完成功能不起作用,因为它不知道load_model()函数的返回值是什么。

有没有办法做这样的事情?

这将告诉 IDE 返回值是用户模型类还是论坛模型类?

0 投票
4 回答
15889 浏览

php - 如何为方法和属性自定义 NetBeans PHP 自动 DocBlock?

创建/**<enter>用于生成 DocBlock 的方法后。它自动填充该函数的@paramand @return。例子:

如何自定义正在生成的块,以便它也填写@author并在之后结束/**<enter>

谢谢

0 投票
3 回答
9751 浏览

php - Doctrine 集合的 Docblocks

是否有一种标准方法可以在 Doctrine 项目的 docblock 注释中记录 Collection 中预期的实体类?就像是:

看起来 PHPDoc 现在是 docblock 注释的事实上的标准,但我找不到任何关于这个用例的提及。

0 投票
1 回答
588 浏览

dreamweaver - 是否可以将 DocBlocks 与 dreamweaver cs5 一起使用?

我喜欢用netbeans 记录php,但它似乎不适用于dreamweaver cs5。

0 投票
1 回答
884 浏览

javascript - 将 PHPDoc 注释与正则表达式匹配

我使用 Alex Gorbatchev 构建的 Javascript Syntax Highlighter

https://github.com/alexgorbatchev/SyntaxHighlighter/

我正在尝试添加对 PHPDoc 注释的支持,PHP 画笔当前匹配单行和多行注释,但在注释内部,当@author我想像其他语法编辑器一样将其包装在单独的类中时。

我正在尝试使用这个正则表达式

我在这里尝试测试它 http://regexpal.com/?flags=ims®ex=%22%5C%5Cs%40%5BA-Za-z%5D%2B%22&input=%0A%40author%0A

但我不知道它是否有效,有人可以帮助我或让我知道它是否正确匹配

0 投票
1 回答
433 浏览

php - 无法让 DocBlox 与 Netbeans 一起使用

我正在尝试让 Ne​​tbeans for Mac 与 DocBlox 集成以生成文档。我按照docblox 网站上的说明与 netbeans 集成,但是当我实际尝试生成文档时,我没有得到任何输出,并且以下内容出现在输出窗口中:

我已将目标目录 chmod 为 0777,但仍然没有乐趣。

有人知道这里出了什么问题吗?我正在运行通过 PEAR 安装的 OSX Lion、Netbeans 7.1RC2 和 DocBlox 0.17.2