kotlin-dokka

How do I use multiple source paths with dokka's fatjar?


I'm using dokka to generate some code for a multi-module project. I have successfully been able to generate documentation for a single module with their cli fatjar, but the module is dependent on another one.

Let me note that the only difference between the processes' commands I kick off are the sources argument (though I have redacted things like the classpath for ease and NDA purposes):

Single module

(working)

java -jar <path_to_jar>/dokka-fatjar-0.9.17.jar /<absolute_path1>/src -output docs -classpath <class_path>

Multiple sources

(not even analyzing and produces 0 results in output directory)

java -jar <path_to_jar>/dokka-fatjar-0.9.17.jar /<absolute_path1>/src:/<absolute_path2>/src -output docs -classpath <class_path>

The classpaths end up being the exact same (after aggregating them in the project build code).


Solution

  • What ended up working for me was java -jar <path_to_jar>/dokka-fatjar-0.9.17.jar -src /<absolute_path1>/src:/<absolute_path2>/src -output docs -classpath <class_path>'=

    That is, using -src with the native path separator. Provided by @Semoro at dokka's gh issues. Thank you!