Closed lifepillar closed 8 years ago
This may be an issue specific to OSX, unfortunately.
DocumentParameters
tries to instantiate all classes in ELKI via the parameterization API to build a full parameter documentation. Specifically, it builds this documentation:
http://elki.dbs.ifi.lmu.de/releases/release0.7.1/doc/parameters-byclass.html
Now TreePopup
is little more than a Java Swing JPopupMenu
. But for some reason this does take over 1 second on your computer? My only guess is that OSX does something weird because of its nonstandard UI.
You could try to increase the timeout in DocumentParameters.java
from 1L, TimeUnit.SECONDS
to maybe 10 seconds to give it more time.
If you don't need that part of the documentation, a workaround is to disable the exec task from pom.xml. Just search for DocumentParameters
in the pom.xml
files.
I've tried both your suggestions, and in either case I get other errors:
[ERROR] Failed to execute goal org.apache.maven.plugins:maven-javadoc-plugin:2.10.1:jar (attach-javadocs) on project elki: MavenReportException: Error while creating archive:
[ERROR] Exit code: 1 - /Users/nicola/Downloads/elki-release0.7.1/elki/src/main/java/de/lmu/ifi/dbs/elki/algorithm/AbstractAlgorithm.java:47: error: unknown tag: apiviz.landmark
[ERROR] * @apiviz.landmark
[...]
If those are errors are related to the process of building docs, is it possible to build Elki without building the documentation?
There are Maven options to not build JavaDoc and/or not run tests.
But a missing JavaDoc tag should not be a fatal error, only a warning. But apparently, some versions of Java 8 fail with an error now - mine (Debian OpenJDK doesn't): http://blog.joda.org/2014/02/turning-off-doclint-in-jdk-8-javadoc.html
Try -Dmaven.javadoc.opts='-Xdoclint:none'
.
No way, same errors. Btw, don't you provide pre-built jars?
Only of release versions.
Please try building the latest master.
I've tried to add -Xdoclint:none
for Oracle Java 8, and the documentation generator now only supports the V3 parameterization, so it should no longer try to instatiate above cloass, so probably closing this issue.
I confirm that the current master builds on OS X. Thanks!
I have tried to build v0.7.1 on OS X using Java 1.8.0_74 and Maven 3.3.9, and got the error in the subject. What does it depend on?
Here is the trace: