false positive "you must write the annotation class in Java" warning in "sbt doc"

[scabug]

A.scala

object A

Row.java

import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;

@Retention(RetentionPolicy.RUNTIME)
public @interface Row {
  String value() default "";
}

build.sbt

scalaVersion := "2.12.1"

execute "sbt doc"

[warn] Row.java:5: Implementation restriction: subclassing Classfile does not
[warn] make your annotation visible at runtime.  If that is what
[warn] you want, you must write the annotation class in Java.
[warn] public @interface Row {
[warn]                   ^
model contains 3 documentable templates
[warn] one warning found
[info] Main Scala API documentation successful.

[scabug]

Imported From: https://issues.scala-lang.org/browse/SI-10134?orig=1
Reporter: kenji yoshida
Affected Versions: 2.12.1
See #6991

[KarelCemus]

Affects also Scala 2.12.3

[missingfaktor]

Is there a workaround for this bug?

[eed3si9n]

This seems to have been fixed in Scala 2.12.9.

sbt:hello> ++2.12.8!
[info] Forcing Scala version to 2.12.8 on all projects.
[info] Reapplying settings...
[info] Set current project to hello (in build file:/private/tmp/hello/)
sbt:hello> clean
[success] Total time: 0 s, completed Jun 14, 2020 1:13:18 AM
sbt:hello> doc
[info] Main Scala API documentation to /private/tmp/hello/target/scala-2.12/api...
[warn] /private/tmp/hello/Row.java:5:19: Implementation restriction: subclassing Classfile does not
[warn] make your annotation visible at runtime.  If that is what
[warn] you want, you must write the annotation class in Java.
[warn] public @interface Row {
[warn]                   ^
model contains 4 documentable templates
[warn] one warning found
[info] Main Scala API documentation successful.
[success] Total time: 3 s, completed Jun 14, 2020 1:13:24 AM
sbt:hello> ++2.12.9!
[info] Forcing Scala version to 2.12.9 on all projects.
[info] Reapplying settings...
[info] Set current project to hello (in build file:/private/tmp/hello/)
sbt:hello> clean
[success] Total time: 0 s, completed Jun 14, 2020 1:13:29 AM
sbt:hello> doc
[info] Main Scala API documentation to /private/tmp/hello/target/scala-2.12/api...
[info] Non-compiled module 'compiler-bridge_2.12' for Scala 2.12.9. Compiling...
[info]   Compilation completed in 9.998s.
model contains 4 documentable templates
[info] Main Scala API documentation successful.

I can't tell which of the changes in https://github.com/scala/scala/releases/tag/v2.12.9 had the intentional or unintentional effect of fixing this, but I'd vote to close it.

[lrytz]

👍

Any volunteer for a regression test PR? I hope the infrastructure is in place to do scaladoc tests with mixed Java/Scala sources.