If I set JAVA_HOME to JDK 7 and use that as my path, `mvn javadoc:javadoc -pl pdfbox` runs with only a few warnings (see below). But if I run with JDK 8, there are many (lowercase) warning messages which result in [ERROR]s (as you can see by the previous email. The blog I cited in my first message ( http://blog.joda.org/2014/02/turning-off-doclint-in-jdk-8-javadoc.html) lists a bunch of things that are required by JDK 8's doclint. JDK 8 made *a lot* of changes to doclint.
[WARNING] Javadoc Warnings [WARNING] warning: [options] bootstrap class path not set in conjunction with -source 1.6 [WARNING] /Users/thad/jdevel/pdfbox-2.1.0-SNAPSHOT/pdfbox/src/main/java/org/apache/pdfbox/pdmodel/encryption/StandardProtectionPolicy.java:120: warning - @return tag has no arguments. [WARNING] /Users/thad/jdevel/pdfbox-2.1.0-SNAPSHOT/pdfbox/src/main/java/org/apache/pdfbox/pdmodel/font/PDType3CharProc.java:148: warning - @return tag has no arguments. [WARNING] /Users/thad/jdevel/pdfbox-2.1.0-SNAPSHOT/pdfbox/src/main/java/org/apache/pdfbox/pdmodel/interactive/form/PDNonTerminalField.java:172: warning - @inheritDoc used but getValue() does not override or implement any method. [WARNING] /Users/thad/jdevel/pdfbox-2.1.0-SNAPSHOT/pdfbox/src/main/java/org/apache/pdfbox/pdmodel/interactive/form/PDNonTerminalField.java:172: warning - @inheritDoc used but getValue() does not override or implement any method. [WARNING] /Users/thad/jdevel/pdfbox-2.1.0-SNAPSHOT/pdfbox/src/main/java/org/apache/pdfbox/pdmodel/interactive/form/PDNonTerminalField.java:172: warning - @inheritDoc used but getValue() does not override or implement any method. [WARNING] /Users/thad/jdevel/pdfbox-2.1.0-SNAPSHOT/pdfbox/src/main/java/org/apache/pdfbox/pdmodel/interactive/form/PDNonTerminalField.java:172: warning - @inheritDoc used but getValue() does not override or implement any method. [INFO] ------------------------------------------------------------------------ [INFO] BUILD SUCCESS [INFO] ------------------------------------------------------------------------ [INFO] Total time: 13.523 s [INFO] Finished at: 2016-06-29T16:11:42-04:00 [INFO] Final Memory: 15M/245M [INFO] ------------------------------------------------------------------------ On Wed, Jun 29, 2016 at 3:25 PM, Tilman Hausherr <[email protected]> wrote: > Hi, > > But all these are warnings. When I fixed the errors, the errors could be > found with "error:". Could you look if there are any, or if there's > something else that makes it fail? > > Tilman > > > Am 29.06.2016 um 20:09 schrieb Thad Humphries: > >> I ran `mvn javadoc:javadoc -pl [module_name]` on each module >> (svnversion 1750686) and still get failures on pdfbox and preflight (and >> warnings on everyone; see below). >> >> Thanks for looking. I've been though this with our API docs, and know that >> Java 8's javadoc is a pain in the butt. For internal stuff, >> "-Xdoclint:none" is my friend. >> >> $ mvn javadoc:javadoc -pl pdfbox >> [INFO] Scanning for projects... >> [INFO] >> >> [INFO] >> ------------------------------------------------------------------------ >> [INFO] Building Apache PDFBox 2.1.0-SNAPSHOT >> [INFO] >> ------------------------------------------------------------------------ >> [INFO] >> [INFO] >>> maven-javadoc-plugin:2.9.1:javadoc (default-cli) > >> generate-sources @ pdfbox >>> >> ... >> 100 warnings >> [INFO] >> ------------------------------------------------------------------------ >> [INFO] BUILD FAILURE >> [INFO] >> ------------------------------------------------------------------------ >> [INFO] Total time: 9.980 s >> [INFO] Finished at: 2016-06-29T13:59:08-04:00 >> [INFO] Final Memory: 18M/309M >> [INFO] >> ------------------------------------------------------------------------ >> [ERROR] Failed to execute goal >> org.apache.maven.plugins:maven-javadoc-plugin:2.9.1:javadoc (default-cli) >> on project pdfbox: An error has occurred in JavaDocs report generation: >> [ERROR] Exit code: 1 - >> >> /Users/thad/jdevel/pdfbox-2.1.0-SNAPSHOT/pdfbox/src/main/java/org/apache/pdfbox/contentstream/operator/OperatorProcessor.java:70: >> warning: no @return >> [ERROR] public abstract String getName(); >> [ERROR] ^ >> [ERROR] >> >> /Users/thad/jdevel/pdfbox-2.1.0-SNAPSHOT/pdfbox/src/main/java/org/apache/pdfbox/contentstream/PDAbstractContentStream.java:144: >> warning: no description for @param >> [ERROR] * @param fractionDigitsNumber >> [ERROR] ^ >> [ERROR] >> >> /Users/thad/jdevel/pdfbox-2.1.0-SNAPSHOT/pdfbox/src/main/java/org/apache/pdfbox/contentstream/PDAbstractContentStream.java:1336: >> warning: no description for @param >> [ERROR] * @param comment >> [ERROR] ^ >> [ERROR] >> >> /Users/thad/jdevel/pdfbox-2.1.0-SNAPSHOT/pdfbox/src/main/java/org/apache/pdfbox/contentstream/PDAbstractContentStream.java:1354: >> warning: no description for @param >> [ERROR] * @param data >> [ERROR] ^ >> [ERROR] >> >> /Users/thad/jdevel/pdfbox-2.1.0-SNAPSHOT/pdfbox/src/main/java/org/apache/pdfbox/contentstream/PDAbstractContentStream.java:1355: >> warning: no description for @throws >> [ERROR] * @throws java.io.IOException >> [ERROR] ^ >> ... >> (etc.) >> >> On Wed, Jun 29, 2016 at 1:27 PM, Tilman Hausherr <[email protected]> >> wrote: >> >> Should work now. Thanks for pointing this out. I haven't changed the pom, >>> I'll generate javadoc myself on a computer that has JDK8. >>> >>> Tilman >>> >>> Am 22.06.2016 um 21:58 schrieb Thad Humphries: >>> >>> When I tried to build the JavaDocs for PDFBox 2.1.0-SNAPSHOT (taken from >>>> SVN yesterday) with Java 8, `mvn javadoc:javadoc` failed with numerous >>>> errors. To correct this, I had to turn off the doclint by modifying >>>> parent/pom.xml as follows: >>>> >>>> $ svn diff parent/pom.xml >>>> Index: parent/pom.xml >>>> =================================================================== >>>> --- parent/pom.xml (revision 1749587) >>>> +++ parent/pom.xml (working copy) >>>> @@ -160,6 +160,7 @@ >>>> </links> >>>> <encoding>UTF-8</encoding> >>>> <notimestamp>true</notimestamp> >>>> + <additionalparam>-Xdoclint:none</additionalparam> >>>> </configuration> >>>> </plugin> >>>> <plugin> >>>> >>>> (Tip taken from >>>> http://blog.joda.org/2014/02/turning-off-doclint-in-jdk-8-javadoc.html) >>>> >>>> >>>> --------------------------------------------------------------------- >>> To unsubscribe, e-mail: [email protected] >>> For additional commands, e-mail: [email protected] >>> >>> >>> >> > > --------------------------------------------------------------------- > To unsubscribe, e-mail: [email protected] > For additional commands, e-mail: [email protected] > > -- "Hell hath no limits, nor is circumscrib'd In one self-place; but where we are is hell, And where hell is, there must we ever be" --Christopher Marlowe, *Doctor Faustus* (v. 121-24)
