When building project locally everything worked fine while on CruiseControl we got this error:
java.util.MissingResourceException: Can't find resource for bundle com.sun.tools.docletsFirst surprise was why everything works fine locally but fails on the build server. But answer we found quickly. On build server project was build with mvn clean site but locally we are mainly using mvn clean package. After using mvn site locally we got the same error. And then we started with investigation. After hours of investigation we found solution and the problem is described with this Jira issue.
.formats.html.resources.standard, key doclet.malformed_html_link_tag
Shortly, with some build versions of Java 5, generation of javadoc will fail if there is <a somewhere in java doc.
So when writing java doc avoid <a characters sequence.