On 19/11/2019 21:34, JamO Luhrsen wrote:

+Thanh and integration-dev

I don't really know the javadocs process that's being used, but some
google searching
turned up some things that make it seem like it is some problem with
maven javadoc plugin
and/or java versions or some combo of those things.

here's the relevant error from the console log:



*02:07:47* Command line was: /usr/lib/jvm/java-11-openjdk/bin/javadoc
@options @packages

Hoping someone else knows something...

This is a rehash of a problem previously reported in Genius, see
https://git.opendaylight.org/gerrit/c/genius/+/85431.

Overall, I would like to projects move away from javadoc jobs by
creating a dedicated docs artifact --
https://github.com/opendaylight/controller/blob/master/docs/pom.xml,
which results in
https://www.javadoc.io/doc/org.opendaylight.controller/controller-docs/latest/index.html)

That has a couple of benefits:
- everything is validated in a single job (verify)
- top-level aggregator does not need to be published to Nexus
- javadoc can be properly structured
(https://github.com/opendaylight/controller/blob/master/docs/pom.xml#L302)

Bye,
Robert