Details
-
Bug
-
Status: Closed
-
Major
-
Resolution: Fixed
-
None
-
New
Description
As of jdk9-ea-b158, ant documentation seems to build the core javadocs just fine, but fails on the lucene/memory/ javadocs...
javadocs: [mkdir] Created dir: /home/hossman/lucene/dev/lucene/build/docs/memory download-java8-javadoc-packagelist: [javadoc] Generating Javadoc [javadoc] Javadoc execution [javadoc] Loading source files for package org.apache.lucene.index.memory... [javadoc] Constructing Javadoc information... [javadoc] Standard Doclet version 9-ea [javadoc] Building tree for all the packages and classes... [javadoc] javadoc: warning - invalid usage of tag &pa [javadoc] javadoc: warning - invalid usage of tag &pid [javadoc] javadoc: warning - invalid usage of tag &page [javadoc] Building index for all the packages and classes... [javadoc] Building index for all classes... [javadoc] Generating /home/hossman/lucene/dev/lucene/build/docs/memory/help-doc.html... [javadoc] Note: Custom tags that were not seen: @lucene.internal [javadoc] 3 warnings BUILD FAILED /home/hossman/lucene/dev/build.xml:93: The following error occurred while executing this line: /home/hossman/lucene/dev/lucene/build.xml:251: The following error occurred while executing this line: /home/hossman/lucene/dev/lucene/common-build.xml:2179: The following error occurred while executing this line: /home/hossman/lucene/dev/lucene/module-build.xml:549: The following error occurred while executing this line: /home/hossman/lucene/dev/lucene/module-build.xml:65: The following error occurred while executing this line: /home/hossman/lucene/dev/lucene/module-build.xml:78: The following error occurred while executing this line: /home/hossman/lucene/dev/lucene/common-build.xml:2155: Javadocs warnings were found! Total time: 1 minute 0 seconds
looking at the generated html files turns up this...
hossman@tray:~/lucene/dev [master] $ find lucene/build/docs/memory -name \*.html | xargs grep -C5 "&pa" lucene/build/docs/memory/org/apache/lucene/index/memory/MemoryIndex.html- but rather thrown away immediately after tokenization. lucene/build/docs/memory/org/apache/lucene/index/memory/MemoryIndex.html- <p> lucene/build/docs/memory/org/apache/lucene/index/memory/MemoryIndex.html- For some interesting background information on search technology, see Bob Wyman's lucene/build/docs/memory/org/apache/lucene/index/memory/MemoryIndex.html- <a target="_blank" href="http://bobwyman.pubsub.com/main/2005/05/mary_hodder_poi.html">Prospective Search</a>, lucene/build/docs/memory/org/apache/lucene/index/memory/MemoryIndex.html- Jim Gray's lucene/build/docs/memory/org/apache/lucene/index/memory/MemoryIndex.html: <a target="_blank" href="http://www.acmqueue.org/modules.php?name=Content&pa=showpage&pid=293&page=4"> lucene/build/docs/memory/org/apache/lucene/index/memory/MemoryIndex.html- A Call to Arms - Custom subscriptions</a>, and Tim Bray's lucene/build/docs/memory/org/apache/lucene/index/memory/MemoryIndex.html- <a target="_blank" href="http://www.tbray.org/ongoing/When/200x/2003/07/30/OnSearchTOC">On Search, the Series</a>. lucene/build/docs/memory/org/apache/lucene/index/memory/MemoryIndex.html- lucene/build/docs/memory/org/apache/lucene/index/memory/MemoryIndex.html- <p> lucene/build/docs/memory/org/apache/lucene/index/memory/MemoryIndex.html- <b>Example Usage</b>
The source java file has this...
* Jim Gray's * <a target="_blank" href="http://www.acmqueue.org/modules.php?name=Content&pa=showpage&pid=293&page=4"> * A Call to Arms - Custom subscriptions</a>, and Tim Bray's
...which does in fact seem to be invalid HTML ... aren't & always suppose to be encoded as & ... even in URLs?
I'm suprised the java8 javadocs/linter don't warn about this.
Attachments
Attachments
Issue Links
- blocks
-
LUCENE-7725 it should be possible to run "ant precommit" with java9
- Open