[
https://issues.apache.org/jira/browse/FLINK-5736?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=15865766#comment-15865766
]
Robert Metzger commented on FLINK-5736:
---------------------------------------
The problem was the following:
On the buildbot server (configuration is located here:
https://svn.apache.org/repos/infra/infrastructure/buildbot/aegis/buildmaster/master1/projects)
there is a script that generates the javadocs.
The script checks if the build server (the servers are apparently not
heterogeneous) has Java8 or not. If Java8 is present
{{-DadditionalJOption="-Xdoclint:none"}} is passed to the maven invocation.
The problem was that the java version check is not working, hence the flag was
not passed.
It seems that this doclint option does not only affect html errors (or wrong
links etc). It also affects other issues during the javadocs compilation. With
doclint, basically all javadoc errors turn into warnings.
As a short term fix, I'm now always passing the doclint option.
> Fix Javadocs / Scaladocs build (Feb 2017)
> -----------------------------------------
>
> Key: FLINK-5736
> URL: https://issues.apache.org/jira/browse/FLINK-5736
> Project: Flink
> Issue Type: Task
> Components: Build System, Documentation
> Reporter: Robert Metzger
> Assignee: Robert Metzger
>
> It looks like the scaladocs are not building properly.
> Expected URL:
> https://ci.apache.org/projects/flink/flink-docs-release-1.2/api/java/
> Buildbot output:
> https://ci.apache.org/builders/flink-docs-release-1.2/builds/15/steps/Java%20%26%20Scala%20docs/logs/stdio
> Command to reproduce issue on master: mvn clean javadoc:aggregate
> -Paggregate-scaladoc -DadditionalJOption="-Xdoclint:none" -Dheader="<a
> href="http://flink.apache.org/"; target="_top"><h1>Back to Flink
> Website</h1></a>"
--
This message was sent by Atlassian JIRA
(v6.3.15#6346)
