注意事项:
右键项目 -> Export -> Java -> JavaDoc -> 选定Public表示录入所有的源文件,其他的可想而知 按步骤走下去最后Finish时,一般是不会报什么错的。
而我实属特例啊! 原因在于搞的是坑爹的JEECMS二次开发,上几位大神级别的人物居然不注重源文件的编码! UTF-8/GBK 这尼玛的把我可害惨咯。
下面就我制作文档这一路遇到的问题说下:
1. 编码错误
E:eclipse-j2eeworkspacesporthomesrccnfacekeecmsactionfrontCMSAction.java:22: 编码 GBK 的不可映射字符
* 鍙�厤缃�紝鑷�姪鏁版嵁鍧楃�鐞?
^
2. 坑爹的错误
E:eclipse-j2eeworkspacesporthomesrccnfacekeecmsactionfrontCMSAction.java:1: 需要为 class、interface 或 enum 锘縫ackage cn.facekee.cms.action.front;
就这两个错误,在我这就是因为字符编码导致的。 建议:
1. 保证你的工程没有错误
2. 整个工程的源文件的字符编码都是一致的
3. 注意自己采用的注释 “规范” (标签使用错误会导致警告,而且降低文档的可读性)