Generating documentation for bindings to a kotlin library (KDoc/dokka).

[LeadAssimilator]

Android framework version

net9.0-android

Affected platform version

.NET 9.0.304

Description

How is one supposed to generate documentation for bindings of android libraries written in kotlin? Am I missing something? Unless I'm blind, I didn't see anything related to kotlin in the docs.

Neither JavaSourceJar nor JavaDocJar appear to work.

I'm assuming that is because neither KDoc nor the javadoc format dokka produces (nor any other dokka output) is supported.

Steps to Reproduce

1. Make an android library in Kotlin
2. Add some documentation with KDoc comments to a class or function or somewhere
3. Build the aar and either an androidSourcesJar or javadocJar with dokka
4. Create a binding project
5. Add item group entries for the AndroidLibrary to the aar and either JavaSourceJar or JavaDocJar to the corresponding jar.
6. Set property group entries for GenerateDocumentationFile to true and AndroidJavadocVerbosity to full
7. Build
8. Observe no documentation in the output xml.

Did you find any workaround?

No response

Relevant log output

[jonpryor]

The short answer is: you're not supposed to, you're not missing anything.

Contributions welcome? 😅

The longer answer is that parsing Javadoc HTML was a PITA (changed and broke constantly), and was replaced with @(JavaSourceJar) (a7413a2, dotnet/java-interop@69e1b80, others) which uses com.github.javaparser to parse Java source code and extract the Javadoc comments. generator then parses the Javadoc comments with an Irony grammar to convert into C# XML Documentation comments.

All of that would need to be updated to support whatever Kotlin documentation format exists.

Given (waves frantically at the "things"), I would not expect to see Kotlin documentation support anytime soon. (If ever.)