lucene-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Uwe Schindler (JIRA)" <j...@apache.org>
Subject [jira] [Created] (LUCENE-4797) Fix remaining Lucene/Solr Javadocs issue
Date Mon, 25 Feb 2013 19:20:12 GMT
Uwe Schindler created LUCENE-4797:
-------------------------------------

             Summary: 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


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 is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators
For more information on JIRA, see: http://www.atlassian.com/software/jira

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@lucene.apache.org
For additional commands, e-mail: dev-help@lucene.apache.org


Mime
View raw message