A few days ago, I was blogging about features that are part of Maven and it's javadoc plugin but are not used. Today I figured that the javadoc plugin has more suprises in the sleeves. It includes features that don't seem to be described anywhere on the maven-javadoc-plugin site.

It seems to be possible to split the javadoc packages into multiple groups. The trick is to include the following code to the project's POM.

    <packageGroups>

        <packageGroup>

            <title>Goals access API</title>

            <packages>org.mevenide.goals.grabber,org.mevenide.goals.manager</packages>

         </packageGroup>

    </packageGroups>

I figured that when browsing Cargo's sources. The resulting generated javadoc can be seen here.

It's funny that Maven declares a XML schema for the maven project descriptor when one can actually put just about anything there. (Yes, you guessed right, packageGroup element is not mentioned in the doc). How many other elements are out there? And what functionality can they trigger?