Uploaded image for project: 'JDK'
  1. JDK
  2. JDK-8223117

javadoc confused OSGi version annotations with Javadoc tags

XMLWordPrintable

    • b04
    • 12
    • x86_64
    • generic

      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


            Unassigned Unassigned
            webbuggrp Webbug Group
            Votes:
            0 Vote for this issue
            Watchers:
            4 Start watching this issue

              Created:
              Updated:
              Resolved: