error raro javadoc (con jdk12) para OSGi versión de anotación

Julian Reschke:

Con el cambio de Java 11 al 12 de Java, ahora vemos un error raro cuando la generación de Javadoc en el paquete de archivos que contienen información-OSGi anotaciones de versión.

El código fuente es:

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

import org.osgi.annotation.versioning.Version;

El error es:

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

( Ver detalles y contexto )

¿Es esta una regresión en Java 12, o hay algo mal en la forma en que se utilizan las anotaciones, o cómo se invoca Javadoc (a través de Maven)?

Marcos Zolnowski :

Probablemente un error Javadoc, porque considera que el Javadoc Anotación Java como una etiqueta Javadoc .

Solución 1: desactivar esta etiqueta 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>

Solución 2: añadir un bloque de Javadoc vacío delante de cada anotación

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