Equivalent of package-info.java


#1

Hello,

I am currently porting a code generator from Java to Kotlin, and I currently output some useful information at package level to package-info.java for various packages. I’ve hunted around online, and found a stack overflow from quite a while ago saying that Kotlin doesn’t have anything similar. I also found a question in this forum that was not answered.

I considered just creating a package-info.java corresponding the the Kotlin source, which I guess would be fine as a documentation asset, but it would be ignored by dokka, which kind of goes against the point of the port in the first place.

What I’d like to know is the best approach for documentation at package level?

Chris


#2

Please see the documentation: http://kotlinlang.org/docs/reference/kotlin-doc.html#module-and-package-documentation


#3

Thanks for the link. I had seen that information, but now I have confirmation that it’s not possible without external configuration. If I’m reading it right, it would appear that there is no convention for code generating package level documentation? So you can wire something up via kdoc parameters but simply interrogating the source tree (or trees) won’t automatically import well structured package level comments?

I know there is probably a good reason for it, but it feels like a regression.

I understand Kotlin is changing all the time. Are there any plans to change this, or possibly have kdoc pick up package-info.java if it is placed in the appropriate position?


#4

At this time we don’t have any plans to add a pure Kotlin way to define package-level annotations and doc comments. Adding support for package-info.java to Dokka is possible; you’re welcome to file a feature request in YouTrack.


#5

Done: https://youtrack.jetbrains.com/issue/KT-22384