[
https://issues.apache.org/jira/browse/LENS-493?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=14486449#comment-14486449
]
Raju Bairishetti commented on LENS-493:
---------------------------------------
We can pass *-Dadditionalparam=-Xdoclint:none* property for generating the
javadoc without errors.
Right now, all the javadcos are generated while generating site. *mvn site
site:run -Dadditionalparam=-Xdoclint:none*
or we have to turn it off in javadoc plugin
{noformat}
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-javadoc-plugin</artifactId>
<version>${javadoc.plugin.version}</version>
<configuration>
<additionalparam>-Xdoclint:none</additionalparam>
</configuration>
...
</plugin>
{noformat}
> Errors while generating javadoc on java8
> ----------------------------------------
>
> Key: LENS-493
> URL: https://issues.apache.org/jira/browse/LENS-493
> Project: Apache Lens
> Issue Type: Sub-task
> Components: build
> Reporter: Raju Bairishetti
> Assignee: Raju Bairishetti
> Fix For: 2.1
>
>
> With JDK 8, we are unable to get Javadoc unless your tool meets the standards
> of doclint. Some of its rules are:
> {noformat}
> no self-closed HTML tags, such as <br /> or <a id="x" />
> no unclosed HTML tags, such as <ul> without matching </ul>
> no invalid HTML end tags, such as </br>
> no invalid HTML attributes, based on doclint's interpretation of W3C HTML 4.01
> no duplicate HTML id attribute
> no empty HTML href attribute
> no incorrectly nested headers, such as class documentation must have <h3>,
> not <h4>
> no invalid HTML tags, such as List<String> (where you forgot to escape using
> <)
> no broken @link references
> no broken @param references, they must match the actual parameter name
> no broken @throws references, the first word must be a class name
> {noformat}
> We don't get any output if it breaks any of the above rule. It throws errors.
> We can turn off doclint by configuring the following propery for javadoc
> plugin
> *<additionalparam>-Xdoclint:none</additionalparam>*
--
This message was sent by Atlassian JIRA
(v6.3.4#6332)
