文档示例

下面还是我们的第一个 Java 程序，但是这次加上了文档注释：


//: c02:HelloDate.java
import java.util.*; 


/** The first Thinking in Java example program. 
 * Displays a string and today's date. 
 * @author Bruce Eckel
 * @author www.BruceEckel.com 
 * @version 2.0
*/
public class HelloDate { 
/** Sole entry point to class & application 
   * @param args array of string arguments 
   * @return No return value 
   * @exception exceptions No exceptions thrown 
  */
public static void main(String[] args) { 
    System.out.println("Hello, it's: "); 
    System.out.println(new Date());


  }
} ///:~


第一行采用了我自己独特的方法，是一行用一个“:”作为特殊记号的注释行，来说明此注
释行含有源文件名。该行包含了文件的路径信息（此时，c02 代表第 2 章），随后是文件名
6。最后一行也是一行注释， 这个“///:~”标志着源代码清单的结束。这样一来，就可以

将这些源代码自动从本书文本中提取出，再用编译器对其进行检查，然后执行。