@deprecated

  @deprecate 标签可以应用于那些已经废弃的版本或声明一些相关信息的元素,除了页面之外,@deprecated 可应用于全局变量(global variable)、引用(include)、常量(constant)、函数(function)、定义(define)、类(class)、变量 (variable)、方法(method)。phpDocumentor 将直接显示 @deprecated 标签后面的文本串

  使用 @deprecated 标签,来告知用户那些不再被使用的元素。

@deprecated 应用示例:

<?php
/**
 * @deprecated deprecated since version 2.0
 */
funciton uselessfunction()
{
}

/**
 * alse legal
 * @deprecated
 */
class stupidclass
{
}
?>

参考:http://pear.php.net/package/PhpDocumentor/docs/1.4.3/phpDocumentor/tutorial_tags.deprecated.pkg.html