Bug ID: JDK-8223117 javadoc confused OSGi version annotations with Javadoc tags

Type: Bug
Component: tools
Sub-Component: javadoc(tool)
Affected Version: 12,13

Priority: P3
Status: Closed
Resolution: Duplicate
OS: generic
CPU: x86_64

Submitted: 2019-04-30
Updated: 2019-05-09
Resolved: 2019-05-09

ADDITIONAL SYSTEM INFORMATION :
openjdk version "13-ea" 2019-09-17
OpenJDK Runtime Environment (build 13-ea+18)
OpenJDK 64-Bit Server VM (build 13-ea+18, mixed mode, sharing)


A DESCRIPTION OF THE PROBLEM :
When running javadoc on package-info files containing OSGi version annotations, such as:

---
@Version("1.3.0")
package org.apache.jackrabbit.oak.commons;

import org.osgi.annotation.versioning.Version;
---

it fails with

---
[ERROR] C:\projects\apache\oak\trunk\oak-commons\src\main\java\org\apache\jackrabbit\oak\commons\package-info.java:17: error: unknown tag: Version
[ERROR] @Version("1.3.0")
[ERROR] ^
---


REGRESSION : Last worked in version 11.0.2

STEPS TO FOLLOW TO REPRODUCE THE PROBLEM :
Checkout <https://svn.apache.org/repos/asf/jackrabbit/oak/trunk/>. Set JAVA_HOME to Java 12 or newer and run "mvn javadoc:javadoc"

EXPECTED VERSUS ACTUAL BEHAVIOR :
EXPECTED -
Javadoc should be generated just like with Java 11.
ACTUAL -
See error above.

CUSTOMER SUBMITTED WORKAROUND :
Disable javadoc tag "Version", as proposed in answer to <https://stackoverflow.com/questions/55906161/weird-javadoc-error-with-jdk12-for-osgi-version-annotation/>

FREQUENCY : always

With additional steps, i am able to reproduce this issue on 12 and 13 ea b17. This is a regression from 12 ea b04 onwards 12 ea b03 - Pass 12 ea b04 - Fail 12 GA - Fail 13 ea b17 - Fail
06-05-2019
Additional Information from submitter: The reason you couldn't reproduce the problem was because a workaround was added in <http://svn.apache.org/r1858407>. The problem is reproducable on earlier versions, such as our latest release: --- svn co https://svn.apache.org/repos/asf/jackrabbit/oak/tags/jackrabbit-oak-1.10.2/oak-commons/ cd oak-commons/ export JAVA_HOME=/usr/local/jdk-12.0.1/ mvn javadoc:javadoc --- Output is: --- [ERROR] C:\tmp\oak-commons\src\main\java\org\apache\jackrabbit\oak\commons\package-info.java:17: error: unknown tag: Version [ERROR] @Version("1.2.1") [ERROR] ^ [ERROR] C:\tmp\oak-commons\src\main\java\org\apache\jackrabbit\oak\commons\cache\package-info.java:17: error: unknown tag: Version [ERROR] @Version("1.0.0") [ERROR] ^ [ERROR] C:\tmp\oak-commons\src\main\java\org\apache\jackrabbit\oak\commons\concurrent\package-info.java:17: error: unknown tag: Version [ERROR] @Version("1.0.1") [ERROR] ^ [ERROR] C:\tmp\oak-commons\src\main\java\org\apache\jackrabbit\oak\commons\io\package-info.java:17: error: unknown tag: Version [ERROR] @Version("1.0.0") [ERROR] ^ [ERROR] C:\tmp\oak-commons\src\main\java\org\apache\jackrabbit\oak\commons\json\package-info.java:17: error: unknown tag: Version [ERROR] @Version("1.0.1") [ERROR] ^ [ERROR] C:\tmp\oak-commons\src\main\java\org\apache\jackrabbit\oak\commons\sort\package-info.java:17: error: unknown tag: Version [ERROR] @Version("1.0.1") ---
06-05-2019
Looks like a duplicate of JDK-8222091
01-05-2019
It is big repository "https://svn.apache.org/repos/asf/jackrabbit/oak/trunk/", executed the steps mentioned in the report. Checkout <https://svn.apache.org/repos/asf/jackrabbit/oak/trunk/>. Set JAVA_HOME to Java 12 or newer and run "mvn javadoc:javadoc" Found the below error, which is not relevant to Java. "[ERROR] Failed to execute goal on project oak-core-spi: Could not resolve dependencies for project org.apache.jackrabbit:oak-core-spi:bundle:1.14-SNAPSHOT: The following artifacts could not be resolved: org.apache.jackrabbit:oak-api:jar:1.14-SNAPSHOT, org.apache.jackrabbit:oak-commons:jar:1.14-SNAPSHOT: Could not transfer artifact org.apache.jackrabbit:oak-api:jar:1.14-SNAPSHOT from/to tangosol-virtual-snapshots (http://tangosol-build.us.oracle.com:8081/artifactory/virtual-snapshot): Failed to transfer file: http://tangosol-build.us.oracle.com:8081/artifactory/virtual-snapshot/org/apache/jackrabbit/oak-api/1.14-SNAPSHOT/oak-api-1.14-SNAPSHOT.jar. Return code is: 502 , ReasonPhrase:notresolvable." Could you please reproduce this issue for smaller test case and share with us?
30-04-2019