我用 C 编写了一个 PHP 扩展,我想创建PHPdoc文档,以便我的用户在调用我的扩展时可以在他们的 PHP IDE(在本例中为 Netbeans)中获得内联文档。
理想情况下,我想通过在 C 代码中嵌入 PHPdocs 来做到这一点,以将实现和文档保持在一起。
假设可以将 PHPdocs 嵌入到 C 中,需要哪些额外步骤才能使文档出现在 Netbeans 中(就像 PHP 代码的 PHPdocs 一样)?
编辑:
O'Reilly Programming PHP指的是/* {{{ proto
文档生成中使用的注释格式,但我不确定所引用的脚本是否生成 PHPdocs:
{{{ proto 行不仅用于在编辑器中折叠,而且还被 PHP 文档项目中的 genfunclist 和 genfuncsummary 脚本解析。如果您永远不会分发您的扩展并且没有将其与 PHP 捆绑在一起的野心,您可以删除这些评论。