[jira] [Updated] (LENS-493) Errors while generating javadoc on java8

["Raju Bairishetti (JIRA)" <ji...@apache.org>]

     [ https://issues.apache.org/jira/browse/LENS-493?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Raju Bairishetti updated LENS-493:
----------------------------------
    Attachment: LENS-493.patch

**mvn site site:run**
 Before patch:
{noformat}
[INFO] Generating "JavaDocs" report             --- maven-javadoc-plugin:2.9.1:aggregate
[INFO] 
100 errors
100 warnings
[INFO]                                                                         
[INFO] ------------------------------------------------------------------------
[INFO] Skipping Lens
[INFO] This project has been banned from the build due to previous failures.
[INFO] ------------------------------------------------------------------------
[INFO] ------------------------------------------------------------------------
[INFO] Reactor Summary:
[INFO] 
[INFO] Lens Checkstyle Rules .............................. SUCCESS [  1.969 s]
[INFO] Lens ............................................... FAILURE [ 43.456 s]
[INFO] Lens API ........................................... SKIPPED
[INFO] Lens API for server and extensions ................. SKIPPED
[INFO] Lens Cube .......................................... SKIPPED
[INFO] Lens DB storage .................................... SKIPPED
[INFO] Lens Query Library ................................. SKIPPED
[INFO] Lens Hive Driver ................................... SKIPPED
[INFO] Lens Driver for JDBC ............................... SKIPPED
[INFO] Lens Server ........................................ SKIPPED
[INFO] Lens client ........................................ SKIPPED
[INFO] Lens CLI ........................................... SKIPPED
[INFO] Lens Examples ...................................... SKIPPED
[INFO] Lens Distribution .................................. SKIPPED
[INFO] Lens ML Lib ........................................ SKIPPED
[INFO] Lens ML Ext Distribution ........................... SKIPPED
[INFO] Lens Regression .................................... SKIPPED
[INFO] ------------------------------------------------------------------------
[INFO] BUILD FAILURE
[INFO] ------------------------------------------------------------------------
{noformat}

After patch:

{noformat}
[INFO] ------------------------------------------------------------------------
[INFO] Reactor Summary:
[INFO] 
[INFO] Lens Checkstyle Rules .............................. SUCCESS [  8.099 s]
[INFO] Lens ............................................... SUCCESS [03:20 min]
[INFO] Lens API ........................................... SUCCESS [ 21.510 s]
[INFO] Lens API for server and extensions ................. SUCCESS [ 14.133 s]
[INFO] Lens Cube .......................................... SUCCESS [  6.038 s]
[INFO] Lens DB storage .................................... SUCCESS [  5.572 s]
[INFO] Lens Query Library ................................. SUCCESS [  6.576 s]
[INFO] Lens Hive Driver ................................... SUCCESS [  4.673 s]
[INFO] Lens Driver for JDBC ............................... SUCCESS [  4.117 s]
[INFO] Lens Server ........................................ SUCCESS [  9.561 s]
[INFO] Lens client ........................................ SUCCESS [  5.035 s]
[INFO] Lens CLI ........................................... SUCCESS [  7.306 s]
[INFO] Lens Examples ...................................... SUCCESS [  2.892 s]
[INFO] Lens Distribution .................................. SUCCESS [  4.271 s]
[INFO] Lens ML Lib ........................................ SUCCESS [ 11.316 s]
[INFO] Lens ML Ext Distribution ........................... SUCCESS [  5.551 s]
[INFO] Lens Regression .................................... SUCCESS [  2.640 s]
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
{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.2
>
>         Attachments: LENS-493.patch
>
>
> 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 &lt;)
> 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)