hibernate/hibernate-ogm — pull request #150 by Sanne (2012-09-28 16:52:32+00:00)
Title: OGM-246 Distribution does not contain JavaDoc

I had to create a new module under documentation for javadocs; otherwise:
- they would overwrite each other's index
- links between each other types wouldn't work
- copy the resources in the distribution was a hell of bugs

Finally the build process uses the _maven-javadoc-plugin_ twice;
this means we end up with two different javadoc sets for the same project:
- one is a nicely aggregated & integrated view using our custom style
- one fragmented in different jars matching bundles for each Maven module so that IDE can do autodiscovery and download them automagically

The first set (the nice looking one) is what we get in the distro, and what we should upload to jboss.org servers; the other is uploaded automatically during a release to Nexus.

There seems to be an additional aggregation goal for the javadocs plugin, specifically designed for multi-module projects, but it's buggy and couldn't capture it's output for our assembly; a chat on IRC returned "stay away from it".

Finally, got to workaround a JDK bug triggering on unknown annotations.
Next time, Gradle :-)