But I did test with JDK8 and it worked, i.e. lots of warnings but no
errors. I did fix a lot of problems like the one mentioned by that website.
Do you have anything with "error:" (spelled exactly like that)?
Do you have any other settings that result in warnings being considered
to be [ERROR] ?
Could you post the full output? Maybe there's one single error I forgot
to fix.
Tilman
Am 29.06.2016 um 22:19 schrieb Thad Humphries:
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]
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
