完善api-doc，用eclipse生成javadoc的时候发生“编码 GBK 的不可映射字符 ”，其实是字符编码问题。
打开eclipse，project -> Generate javadoc 一项一项的选你要输出javadoc的项目，在VM设置中加入以下代码

-encoding utf-8 -charset utf-8

这次操作，输出的html代码不会发生“编码 GBK 的不可映射字符 ”问题，而且html字符编码都设为了UTF-8，问题彻底解决。
对应的ant target 如下


        +---------------------------------------------------+
        |  Building Doc File                                |
        +---------------------------------------------------+

更为彻底的办法就是修改eclipse.ini文件，在末尾加入如下两行内容：

-Dfile.encoding=UTF-8
-Dsun.jnu.encoding=UTF-8