https://bz.apache.org/bugzilla/show_bug.cgi?id=63438

--- Comment #1 from Jaikiran Pai <jaiki...@apache.org> ---
I was able to reproduce this. The javadoc tool seems to error out and exit with
a non-zero exit code when it cannot resolve a "reference". You can, in fact,
find 26 "reference not found" errors which match with the final "26 errors"
summary message in that log you attached. These references are mostly of the
form @throws JSchException, @see and such. It's understandable why those
references aren't found.

However, I'm unsure why the javadoc tools errors out in such cases and thus
contradicting with what it says on it's documentation page[1] for Java 1.8 (the
version you are using):

"Reports warnings for bad references...

...

Messages may be either warnings or errors, depending on their severity
and the likelihood to cause an error if the generated documentation were
run through a validator. For example, bad references or missing Javadoc
comments do not cause the javadoc command to generate invalid HTML, so
these issues are reported as warnings."

I've asked for clarification about this on the openjdk javadoc-dev mailing list
and will decide how we can proceed with this one, once we get clarity on the
matter.

[1]
https://docs.oracle.com/javase/8/docs/technotes/tools/unix/javadoc.html#CHDCIBFC

-- 
You are receiving this mail because:
You are the assignee for the bug.

Reply via email to