[ImageJ-devel] mvn javadoc problem with java 8

[Curtis Rueden]

Hi Tobias,

> I get the following errors when running with java 8
> ...
>
> Works fine with java 7 and java 6.
>
> Is this a known problem?

Java 8's javadoc tool is much more stringent than previously, due to the
addition of doclint checks [1].

I am ambivalent about making it easy to disable the doclint, because I
think many of the new checks are valuable. However, some of the checks will
take a lot of work to bring our code up to snuff -- e.g., the fact that
@param, @return and @throws seem to be required now.

You can certainly disable it locally by passing "-Djavadoc.skip=true" to
Maven from the CLI.

Please do not disable javadoc in the properties, because then Jenkins will
fail to deploy the -javadoc artifact to the Maven repository.

Regards,
Curtis

[1] http://blog.joda.org/2014/02/turning-off-doclint-in-jdk-8-javadoc.html

On Wed, Feb 11, 2015 at 9:46 AM, Tobias Pietzsch <pietzsch at mpi-cbg.de>
wrote:

> Hi,
>
> when I try to build fiji project (specifically bigdataviewer-core) on the
> command line with
>
> mvn clean install
>
> I get the following errors when running with java 8
> ...
> [ERROR] Failed to execute goal
> org.apache.maven.plugins:maven-javadoc-plugin:2.9.1:jar (attach-javadocs)
> on project bigdataviewer-core: MavenReportException: Error while creating
> archive:
> [ERROR] Exit code: 1 - javadoc: warning - Error fetching URL:
> http://jenkins.imagej.net/view/Fiji/job/Saalfeld-MPICBG-Maven/javadoc/
> [ERROR]
> /Users/pietzsch/workspace/BigDataViewer/bigdataviewer-core/src/main/java/bdv/viewer/Source.java:57:
> error: reference not found
> [ERROR] * Get the transform from the {@link #getSource(long) source} at
> timepoint
> [ERROR] ^
> …
>
> Works fine with java 7 and java 6.
>
> Is this a known problem?
>
> I saw that I can disable javadoc-plugin by setting
>         <properties>
>                 <javadoc.skip>true</javadoc.skip>
>         </properties>
> in my pom. Is this the recommended workaround?
>
> best regards,
> Tobias
>
> _______________________________________________
> ImageJ-devel mailing list
> ImageJ-devel at imagej.net
> http://imagej.net/mailman/listinfo/imagej-devel
>
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://imagej.net/pipermail/imagej-devel/attachments/20150211/c09e6e60/attachment.html>