JDK 8's javadoc tool no longer copies doc-files folders

[Uwe Schindler]

Hi,

I already filed bug reports about this to bugs.sun.com approx. 3 weeks ago, but until today there was no repose at all from the bug reviewers - so I don't even have a bug number.

We are testing Apache Lucene and Apache Solr with recent snapshot builds of JDK 8. Unfortunately we are stuck at b65 at the moment, because later versions have serious problems in javadocs:

- Source folders named "doc-files" are no longer copied to the output, so our Javadocs are now missing additional images and other additional HTML files, that were placed there to be included into the javadocs. We have our own "linting" for javadocs based on HTMLtidy and a python script, so we noticed this error very soon (and our Jenkins builds fail).
- The new doclinter is enabled by default and is very strict (and complains about invalid HTML/entities/...) in the source code. I think this is now fixed in b78 (so it does not complain about unclodes <p> and various other issues), but it’s a major regression to enable doclint by default. Almost no Java project passes javadocs, because all doclint errors are fatal to the javadoc tool.

I just wanted to send this heads-up, so maybe anybody from this list can look into this problems and take care of our bug reports.

Uwe

-----
Uwe Schindler
uschindler at apache.org 
Apache Lucene PMC Member / Committer
Bremen, Germany
http://lucene.apache.org/