有趣的 javadoc - Java - ArLi Weng's blog -

Package Description of java
根据 http://java.sun.com/j2se/javadoc/writingdoccomments/index.html 的指引
java package 的 Description 必须建立一个 package.html 文件
模板如 http://java.sun.com/j2se/javadoc/writingdoccomments/package-template

里面提到，body 体里的第一行，将做为 package 的主Description 显示在顶部
我尝试了好几次，发现在用javadoc 编译当locale 是zh-CN时，ja结果相当的有趣：

第一行的定义是从第一个字符直到以英文句号为结束，不认 \r、\n 或 <br> 这样的结束。
更有趣在于，如果在找到英文句号之前找到中文句号的话，将一样以它为结束点。
在j2se 1.6 javadoc 的 javax.swing.text.html.parser.Parser 发现如下描述，很明显的感觉到它在说谁（不良实现的 HTML 解析器）：

一个简单的 DTD 驱动的 HTML 解析器。该解析器从 InputStream 读取 HTML 文件，并在遇到标记和数据时调用各种方法（在子类中应重写这些方法）。

遗憾的是，存在许多不良实现的 HTML 解析器，结果导致许多不良格式的 HTML 文件。此解析器尝试解析大多数 HTML 文件。这意味着该实现有时偏离有利于 HTML 的 SGML 规范。