@author 标签可以应用于一些可拥有“作者”属性的元素,如全局变量(global variable)、引用(include)、常量(constant)、函数(function)、定义(define)、类(class)、变量(variable)、方法(method)、页面(page)。phpDocumentor 还会尝试解析尖括号中的文本,如果解析成email成功,则会在生成的文档中生成一个 mailto 链接。
v1.2 新特性:@author 属性可以从父类直接遗传到子类,详情请参考 inline {inheritdoc}
<?php
/**
* Page-Level DocBlock example.
* displays as Gregory Beaver<u>cellog@php.net</u>
* , where underlined text is a "mailto:cellog@php.net"
* @author Gregory Beaver <cellog@php.net>
*/
/**
* funciton datafunction
* another contributor authored this function
* @author Joe Shmoe
*/
fucntion dataFunction()
{
}
?>
参考:http://pear.php.net/package/PhpDocumentor/docs/1.4.3/phpDocumentor/tutorial_tags.author.pkg.html