果是当前类或模块的，那么你可以直接写函数、或者变量的名，如果是函数那么要在函数名后面加上括号（），变量名要加上$。需要注意的，这里所谓的变量名也应该是你用@var来说明过的，否则，phpdoc将无法找到相关的参照而报错。
如果你想引用其他类或者其他模块的函数或者是变量，那么，你可以在函数名、变量名前面加上类或模块的名字作为范围指示，中间用：：来分隔。

下面是一些例子：
@see $run_time,$idle_time,$begin_time,$end_time
@see getRuntime(), getIdletime(),getBegintime(),getEndtime()
@see TIME::$run_time, TIME::getBegintime()

@since label 使用范围： class, function, var, module, define, use
指明该api函数或者方法是从哪个版本开始引入的。

@static 使用范围：class, function, var
指明变量、类、函数是静态的。

@throws exception [, exception] 使用范围： function
指明此函数可能抛出的错误异常,极其发生的情况
如果你预料到在这个函数中有产生异常的条件，那么你可以使用@throws标记来说明这些异常是什么，什么情况下产生异常。比如，读取磁盘文件出错，无法连接数据库，网络连接超时或者是在一些情况下，你"故意"抛出的异常等等。

@todo 使用范围：class, function, module, use
指明应该改进或没有实现的地方

@var[iable] (object objecttype|type) [$varname] [description] 使用范围：var
定义说明变量/属性。
object objecttype|type 定义你的变量的类型，同@param一样
$varname 该变量的名字，你可以从其他地方使用@see来引用这个名字
description 对变量的描述

@version label 使用范围：class, function, module, use
定义版本信息.
你当然可以自己手工写这些版本信息，不过PEAR推荐你使用CVS的$Id标记来自动标示你的版本信息。形式如下：

@version $Id
这样，当你checkout的时候，CVS自动会扩展成： @version $Id: PhpdocParserCore.php,v 1.4 2001/02/18 14:45:27 uw Exp

5. 生成文档
5.1 安装PHPDOC
安装PHPDOC很简单,实际上因为它已经随同PHP 4.05一同发布了,所以如果你的PHP是4.05,那么在PEAR目录下面会发现PHPDOC这个模块.如果你没有发现,你可以从PHPDOC的CVS获得一份最新的源码.

5.2 运行PHPDOC
运行PHPDOC需要做一些准备工作,首先要调整你的PHP.INI的参数，

上一页  [1] [2] [3] [4] [5] [6] [7] [8] [9] [10]  ... 下一页  >> 

在google里搜索更多PEAR：使用PHPDoc轻松建立你的PEAR文档

	Web www.51ec.org

上一篇信息学院： PEAR:常用模块

下一篇信息学院： 在PHP世界中选择最合适的模板--比较PHPLIB Template和FastTemplate…