OSGi版本注释的怪异Javadoc错误（带有jdk12）

Question

随着从Java 11到Java 12的更改，我们现在在包含OSGi版本注释的程序包信息文件上生成Javadoc时看到一个奇怪的错误。

源代码为：

$scope.incrementRate= function()
{
  console.log($scope.selectedTech) // {name: "angular", rate: 0, bar: 10},
  console.log($scope.selectedTech.rate) // 0
  ...

};

错误是：

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

import org.osgi.annotation.versioning.Version;

（See details and context）

这是Java 12中的回归，还是注释的使用方式存在问题，或者（通过maven）如何调用Javadoc？

Answer 1

可能是Javadoc错误，因为Javadoc将Java注释视为 Javadoc标记。

解决方法1： 禁用此Javadoc标签

            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-javadoc-plugin</artifactId>
                <version>3.1.0</version>
                <configuration>                        
                    <tags>
                        <tag>
                            <name>Version</name>                            
                            <placement>X</placement>                            
                        </tag>
                    </tags>
                </configuration>
            </plugin>

解决方法2： 在每个注释的前面添加一个空的Javadoc块

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