@author

  @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


付费阅读