phpDocumentor页面级文档字符串

Question

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

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

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

Answer 1

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