Carsten Ziegeler wrote > Oliver Lietz wrote >> hi all, >> >> Javadoc became much stricter with doclint in Java 8 and releasing some >> (most?) >> of our modules with Java 8 will fail with Javadoc errors. >> >> Should Javadoc errors block a release? >> >> Should we enable Javadoc for regular builds? >> >> We can disable doclint for builds with Java 8 or fix the errors (+1) of >> course >> to get around. >> > > I think javadoc errors should block the release and we should fix them. > A release is still possible if you simply use java 7, so a simple > workaround exists. > > I guess it would make sense to enable javadoc building on our CI server, > however as we're not paying that much attention to what is happening > there anyway, I'm not sure if it helps. > > Fixing the javadoc for java 8 is not the nicest task in the world, but > you can usually do this fairly quickly. >
And this is also a good opportunity to see whether the javadoc generation for a module works as expected or not. As I just found out while fixing the javadocs for the eventing module: the package excludes where not handled correctly at all. Carsten -- Carsten Ziegeler Adobe Research Switzerland [email protected]
