dokka
dokka copied to clipboard
[K2] Inconsistent KDoc link into inhertited documentation
interface A {
/**
* [a]
*/
fun foo(a: Int)
}
class B : A {
override fun foo(a: Int) {
}
}
In the documentation of B.foo, the reference [a] leads to a parameter of A.foo.
In IDE and Dokka K1, it leads to a parameter of B.foo.
Also, there is the unit test
Also see #2621
Real-world cases:
- kotlinx.serialization - links to parameters, when documentation is copied to the inheritor (AbstractEncoder) leads to
CompositeEncoder.encodeStringElementin K2 (AbstractEncoder.encodeStringElementin K1) - kotlinx.io - same, links to parameter, when copied to inheritor