phpdoc - phpDocumentor 页面级文档字符串

Question

我们有一个页面级的文档块，如下所示：

/**
* Functions for the processing, displaying, and searching of listings
*
* @package ListingFunctions
*
*/

该文件的其余部分具有带有自己的文档块的功能。但是我和我的团队在生成的 HTML 输出中的任何地方都找不到此评论。我们需要打开一些配置或命令行的东西吗？

Answer 1

使用 phpDocumentor 1.x，“简短描述”部分应该是该给定文件网页上的主要描述标题。它不会出现在该文件中的那些函数上......只是出现在文件本身上。这是核心行为，无法通过运行时设置进行修改。