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

javadoc confused OSGi version annotations with Javadoc tags

    Details

    • Subcomponent:
    • Introduced In Build:
      b04
    • Introduced In Version:
      12
    • CPU:
      x86_64
    • OS:
      generic

      Description

      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


        Attachments

          Issue Links

            Activity

              People

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

                Dates

                • Created:
                  Updated:
                  Resolved: