Consider automatically extracting javadoc from the Gradle API and converting it to KDoc

[bamboo]

JavaParser might be a good option.

[yole]

Why exactly do you need that? Dokka can parse Javadoc in Java code and generate Kotlin documentation from it.

[bamboo]

@yole gradle-script-kotlin currently generates extension members for the Gradle API so Action<T> parameters are treated as T.() -> Unit (see #117). We want those extensions to sort of inherit the documentation of the members they were generated from so the docs are immediately accessible in the IDE without any indirections.

Could Dokka be used to programatically extract KDoc from the Gradle Java source files?

[yole]

If you need to see docs in the IDE, it's possible to write a custom extension in the plugin that would show them. This should be far easier than building a separate tool to extract and convert the docs.

[bamboo]

@yole, far easier sounds great! If I understood you correctly this would be like writing a plugin to the IDEA Kotlin plugin? Could you share any pointers on that?

[bamboo]

Superseded by #155. Extension members will not be needed.