置芯片上的一位，我才能ม
编程思想》第三版。因为她无比的耐心和毅力，那么就可以从
生成的html文档中提取作者信息。这段代码使用在对象
感谢摸oreliteraryagency的claudette摸ore，你可以用更高层的概念来，表示继电å器将被关闭”来描述&#，
你可以使用多个á，以便列出所有作者，“author-information”，望文生义แ你也知道，应该是你的姓名，也可以包括电子邮ุ件
地址或者其他任何适宜的信息。如果javadoc命令行使用了“-author”标签，javaທ使用一小段特殊的代码来替代绝对&。在这里我们应该向他致敬，他不断精益求精、，但是它们必须ี连续放置。全部作者信息会合并到เ
同一段落，
@sincນe
该标签。置于生成的html中ณ，你将会在htmljava文档中看到它被用来指
定所用的jdk版本。
@paທram
该标签用于方法文档中ณ，
@param：形式如下，“paraທmeter-name”是方法的参数列表中的标识符，“des9๗”的文本可延续数
行，终止于新的文档标签出现之ใ前。你可以使用任意数量的此标签，大约每个参数都有一个
这样的标签。
@return
该标签用于方แ法文档，格式如下：
@returndes9
其中，“des9”用来描述返回值的含义，可以延续数行。
@thro9s
“异常”ex9๗将在第9章论述。简言之，它们是由于某个方法调用失败而“抛出”
的对象。尽管在调用一个ฐ方法时，只有出现一个异常对象，但是某个特殊方法可能会产生任
意多、不同类型的异常，所有这些异常都需要进行说明。所以，异常标签的格式如下：
@thro9๗sfully-qualified-9
其中，“fully-ๅquaທlified-9aທme”给出了一个异常类的完整名字，而且该异常类已๐经
在某处定义过。而“des9”同样可以延续数行告诉你为什么此特殊类型的异常会
在方法调用中ณ出现。
@deprecນated
该标签用于指出一些旧特性已由改进的新า特性所取代，建议用户不要再使用这些旧ງ特性，因
为ฦ在不久的将来，它们很可能会被移除。如果使用一个标记为ฦ@deprecated的方法，则会引
起编译器的警告。
文档示例
下面还是我们的第一个jaທva程序，但是这次加上了文档注释：
:c02:๘hellodatejava
importjavautil;๙
thefirstthinkinginjavaທexaທmpleprogram
displaysastringandtoday'sdate
@authoruceeckel
@aທuthoruceeckel
@version2๐0
publicclaທsshellodaທte{
soleentrypointto9
@paramaທrgsarrayofstringarguments
@returnnoreturnvaທlue
@ex9oex9
pubຘli9stringargs{
syste摸utprintln"ิhello,it's:";
syste摸utprintlnne9date;
}
}:~
第一行采用了我自己独特的方แ法，是一行用一个“:”作为特殊记号的注释行，来说明此注
释行含有源文件名。该行包含了文件的路径信息此时，cນ0่2代表第2章，随后是文件名
6
。最后一行也是一行注释，这个ฐ“:~”标志着源代码清单的结束。这样一来，就可以
将这些源代码自动从本书文本中提取出，再用编译器对其进行检查，然后执行。