@category 标签用户将多个包(packages)组织归类。这里定义的分类可以被 XML:DocBook/peardoc2 转换器直接调用,且可以被其它转换器使用。其它使用 phpDocumentor 打包的转换器会忽略这个分类,但这一情况在将来的版本里可能会有所改变。
在命令行下,可以使用 -dc, --defaultcategoryname 选项动态地指定分类
@category 应用示例:
<?php
/**
* Page-Level DocBlock
* @package MyPackage
* @category mycategory
*/
/**
* @global array used for stuff
*/
function mine()
{
global $baz;
//...
}
?>
参考:http://pear.php.net/package/PhpDocumentor/docs/1.4.3/phpDocumentor/tutorial_tags.category.pkg.html