Hello. We're in the process of trying to get the maven-javadoc-plugin to work correctly when generating documentation for modules. I have a simple test case here that fails:
https://github.com/io7m/maven-javadoc-bug-20171118 See the README.txt for the full build log and error messages. I think, at a basic level, we want to do this: javadoc \ -verbose \ -sourcepath "a/src/main/java:b/src/main/java:c/src/main/java" \ --module com.io7m.bugs.a,com.io7m.bugs.b,com.io7m.bugs.c But this of course fails with: javadoc: error - cannot use source path for multiple modules com.io7m.bugs.a, com.io7m.bugs.b, com.io7m.bugs.c 1 error I note that there's --module-source-path option, so I'd expect the following to work: javadoc \ -verbose \ --module-source-path \ "a/src/main/java:b/src/main/java:c/src/main/java" \ --module com.io7m.bugs.a,com.io7m.bugs.b,com.io7m.bugs.c Unfortunately, this fails with: javadoc: error - module com.io7m.bugs.a not found. 1 error I can't get any more information out of the javadoc tool than that, so I'm not sure exactly what's wrong. It's been suggested to me that the problem might be that the --module-source-path expects each entry in the path to be a directory containing a directory named after the respective module, but that's obviously not going to happen in a project with sources laid out in the Maven convention (unless we start inserting symlinks everywhere). What's the least painful way that we can update the javadoc plugin so that it can generate JavaDoc for a given set of modules? -- Mark Raynsford | http://www.io7m.com
pgpCQBWvyPCXo.pgp
Description: OpenPGP digital signature
