Hi, I am sorry to report another issue. This is a long running one that has previously been unnoticed in releases.
Looking inside the binary distributions I believe that the intention is to provide documentation along with the binary jars. On a single module project such as lang this is provided as the javadoc directory. In our released multi-module projects (rng, numbers) this has been provided as the site directory. However this is not actually packaging the javadocs. It is packaging the site produced by the parent pom (i.e. it is not the recursive site with all the modules created by the mvn site:stage target). This includes all the project reports for the parent pom site. The menu has the usual link to the project modules. However there are no project modules included. Packaging the entire site report could be done by changing the archive descriptor to target the output of 'mvn site:stage' and not 'maven site'. But this is not what is required here. If we wish to include the docs in the binary distribution this should be the javadoc. For a multi-module project this requires an aggregator module to bring together the javadocs for all the release modules. I have put this together for RNG. An aggregator module is required rather than the parent pom as the module must not have the packaging output type 'pom'. It must be left as the default (jar) so the javadoc plugin will run. Following a build using: mvn -Duser.name=aherbert -Dgpg.skip -Dcommons.release.dryRun=true -Ptest-deploy -Prelease package site site:stage deploy The final directories of interest are: target/site 39M parent pom site. Contains the source xref and user guide. But no javadocs and no child modules. Links to child modules are broken (404 error) as the site is incomplete. docs-archive/target/apidocs 7.4M Contains the aggregated javadocs built by a dedicated module. target/staging 176M Contains the entire site. Includes the user manual, and all javadocs. target/staging/userguide 140K Contains only the userguide HTML. The images, css and javascript directories would have to be selectively included for this to function. I think we should just include the apidocs in the release binary distribution. However this can be changed to also include the user guide with a bit more work. Alex
