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

Uwe Schindler updated LUCENE-4797:
----------------------------------
    Attachment: LUCENE-4797-java7.patch

Patch that enables doclint on java 8+ in branch_5x, but no-op on java 7.
I will run the whole build now, to assure Robert did not miss any files and 
commit this.

Maybe we should forward-port the separation of the properties 
javac.doclint.args and javadoc.doclint.args to trunk, too. In trunk there would 
be just no condition. Comments?

> Fix remaining Lucene/Solr Javadocs issue
> ----------------------------------------
>
>                 Key: LUCENE-4797
>                 URL: https://issues.apache.org/jira/browse/LUCENE-4797
>             Project: Lucene - Core
>          Issue Type: Bug
>          Components: general/javadocs
>    Affects Versions: 4.1
>            Reporter: Uwe Schindler
>            Assignee: Uwe Schindler
>              Labels: Java8
>         Attachments: LUCENE-4797-java7.patch
>
>
> Java 8 has a new feature (enabled by default): 
> http://openjdk.java.net/jeps/172
> It fails the build on:
> - incorrect links (@see, @link,...)
> - incorrect HTML entities
> - invalid HTML in general
> Thanks to our linter written in HTMLTidy and Python, most of the bugs are 
> already solved in our source code, but the Oracle Linter finds some more 
> problems, our linter does not:
> - missing escapes <
> - invalid entities
> Unfortunately the versions of JDK8 released up to today have a bug, making 
> optional closing tags (which are valid HTML4), like </p>, mandatory. This 
> will be fixed in b78.
> Currently there is another bug in the Oracle javadocs tool (it fails to copy 
> doc-files folders), but this is under investigation at the moment.
> We should clean up our javadocs, so the pass the new JDK8 javadocs tool with 
> build 78+. Maybe we can put our own linter out of service, once we rely on 
> Java 8 :-)



--
This message was sent by Atlassian JIRA
(v6.3.4#6332)

---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]

Reply via email to