[Bug] Parameter link unresolved with annotation before doc comment

[juliamcclellan]

What is happening? What should have happened instead?

Starting in build 2.2.0-dev-417, if a function has both a visibility modifier and an annotation that appears before the function doc comment, kdoc links to the function parameters are unresolved.

Reproducer

@JvmOverloads
/**
 * @param i int parameter
 */
public fun foo(i: Int = 0) = Unit

Leads to WARN: Couldn't resolve link: [i] in the warning output. The warning doesn't occur if @JvmOverloads is moved to after the doc comment or if the public modifier is removed.

Dokka version

2.2.0-dev-417

Kotlin Gradle Plugin (KGP) version

No response

Android Gradle Plugin (AGP) version (if applicable)

No response

Build tool

Gradle

Project type

• Kotlin Multiplatform (KMP)
• Android
• JVM
• Other

Anything else? (optional)

No response

[whyoleg]

I see the same behaviour in the IDEA, so it looks like not Dokka specific, but AA. cc @vmishenev / @BlaBlaHuman.
Only @param tag links are unresolved; all other links are working fine.

BTW, the same happens with context over KDoc :)

And at last, all at once, with the bonus of splitting visibility and dangling kdoc.

Funnily enough, kdoc after the visibility modifier is working correctly. :)

---

TBH, I'm not sure that Dokka and IDEA should even support such cases.

[vmishenev]

I think #3569 is related to this