You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Describe the bug
KDoc commnents on Kotlin annotation class properties are not shown in the resulting Javadoc. In Kotlin, annotation parameters are defined as primary constructor parameters so we tried using @param and `@property' as well as putting the comments on the properties themselves without success.
Generated Javadoc for the annotation class lists the properties under the Fields Summary section with empty descriptions.
The issue doesn't occur for the html generator and above code is properly documented in html format.
Expected behaviour
Dokka should show KDoc comment put on the property declaration, or on the class with either @param or @property for the associated parameter in the javadoc. Ideally, javadoc should show annotation properties under Required Elements and Optional Elements sections as standard javadoc behavior but I believe showing them next to fields may be enough.
Additional context
We tried with both V1 and V2 and the issue is the same.
I think a simple change in the class.corte file would fix this but I am not sure about the consequences in other types. In that file, property prefix is missing at this line:
Describe the bug
KDoc commnents on Kotlin annotation class properties are not shown in the resulting Javadoc. In Kotlin, annotation parameters are defined as primary constructor parameters so we tried using
@param
and `@property' as well as putting the comments on the properties themselves without success.Generated Javadoc for the annotation class lists the properties under the Fields Summary section with empty descriptions.
The issue doesn't occur for the html generator and above code is properly documented in html format.
Here is the source code for one of our annotations: https://github.com/bivektor/lombokt/blob/main/lombokt-api/src/main/kotlin/lombokt/ToString.kt
Expected behaviour
Dokka should show KDoc comment put on the property declaration, or on the class with either
@param
or@property
for the associated parameter in the javadoc. Ideally, javadoc should show annotation properties under Required Elements and Optional Elements sections as standard javadoc behavior but I believe showing them next to fields may be enough.Screenshots
To Reproduce
The project sources are here: https://github.com/bivektor/lombokt/blob/main/lombokt-api/
Dokka configuration
Dokka configuration is here: https://github.com/bivektor/lombokt/blob/main/buildSrc/src/main/kotlin/dokka-conventions.gradle.kts
Installation
Additional context
We tried with both V1 and V2 and the issue is the same.
I think a simple change in the class.corte file would fix this but I am not sure about the consequences in other types. In that file,
property
prefix is missing at this line:dokka/dokka-subprojects/plugin-javadoc/src/main/resources/views/class.korte
Line 115 in 3b20e70
I think it should be
property.description|raw
. When I fix it and run all tests, I don't get any failure so I guess that's not on purposeThe text was updated successfully, but these errors were encountered: