dokka icon indicating copy to clipboard operation
dokka copied to clipboard

Dokka missing Kotlin source code on javadocs

Open fmcarvalho opened this issue 1 year ago • 0 comments

Question Is Dokka supposed to exclude Kotlin source code from Javadocs?

Screenshots

Here, HtmlContinuation is a Java class extending a Kotlin class HtmlContinuationSuspendable. However, Dokka did not include a link for HtmlContinuationSuspendable nor generate Javadoc for it.

Installation

  • Operating system: macOS
  • Build tool: Maven
  • Dokka version: 1.9.10

Additional context It seems javadoc maven plugin cannot generate javadocs for Kotlin source code. Thus, I successfully replace it with Jetbrains Dokka maven plugin. But now Dokka only generates javadocs for Java source code and is missing Kotlin source code.

I have already tried to include sourceDirectories and sourceRoots in the Jetbrains Dokka maven plugin according to documentation, but it continues to generate javadocs only for Java source code.

I am using the following configuration in pom.xml:

<executions>
        <execution>
            <phase>prepare-package</phase>
            <goals>
                <goal>dokka</goal>
                <goal>javadoc</goal>
                <goal>javadocJar</goal>
            </goals>
        </execution>
    </executions>
    <configuration>
        <sourceDirectories>
            <source>src/main/java</source>
            <source>src/main/kotlin</source>
        </sourceDirectories>
    </configuration>
</plugin>

fmcarvalho avatar Feb 14 '24 11:02 fmcarvalho