we should not unilaterally mark “Java API”; I’ve started marking those methods which are not intended for Java users (like this one) “Scala API” as well