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

javadoc confuses OSGi version annotations with Javadoc tags

XMLWordPrintable

      ADDITIONAL SYSTEM INFORMATION :
      fails on Ubuntu as well

      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] ^
      ---

      Note this is the same as JDK-8223117 which got resolved as incomplete and which I can't comment on.

      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/>.

      Checkout revision r1858385 (svn up -r r1858385). Note that the problem is worked around in later revisions as described under "workaround".

      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 :
      Implemented in <http://svn.apache.org/r1858407> by disabling the javadoc tag "Version".

      FREQUENCY : always


            fmatte Fairoz Matte
            webbuggrp Webbug Group
            Votes:
            0 Vote for this issue
            Watchers:
            2 Start watching this issue

              Created:
              Updated:
              Resolved: