Hi all, I'm trying to get dokka to include documentation for files generated from AIDL, which output to the build folder. How do you include additional sources in an Android project for dokka 1.4.10.2? The README suggests I should be putting config in

dokkaSourceSets { named("main") { ... } }

. I've managed to get

includeNotPublic.set

working in that block, but

sourceRoots.from

and

sourceRoots.setFrom

don't do anything.

I suspect that they are not a part of a configured sourceSet. Is this project available publicly so i can take a look?

example at: https://github.com/rbares/dokka-aidl-sample

Thanks, ill take a look

as I have a package which exclusively contains AIDL generated classes, I am able to use the following workaround:

task removeAidlSources(type: Delete) {
    delete "src/main/java/my/aidl/package/"
}

task addAidlSources(type: Copy) {
    from "$buildDir/generated/aidl_source_output_dir/release/out/my/aidl/package/"
    into "src/main/java/my/aidl/package/"
}

afterEvaluate {
    tasks.matching { it.name.startsWith("dokka") }.all {
        it.dependsOn addAidlSources
        it.finalizedBy removeAidlSources
    }
}

but it would be helpful if I didn't need to temporarily pollute the codebase with duplicate definitions

They may be suppressed by default. When configuring dokka source set (I believe it’s called

main

or similar on Android) you can just remove the default value of the

suppresedFiles

parameter (eg.

suppressedFiles.setFrom(...)

)

Indeed I have been using "main". Unfortunately adding

suppressedFiles.setFrom

didn't change the behavior in the sample app provided. If the files were suppressed I would expect exclusively setting

sourceRoots.setFrom

to the generated path to result in no documentation at all. Instead I get the same result whether I try to set sourceRoots or not. This does make me wonder whether I have fallen into an edge-case where I am trying to use the syntax incorrectly but it isn't sufficiently wrong to show any errors.

This might be a bug on our side, give me a few hours to check that