forked from Kotlin/kotlinx.coroutines
-
Notifications
You must be signed in to change notification settings - Fork 0
/
dokka.gradle
80 lines (71 loc) · 2.7 KB
/
dokka.gradle
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
// Configures generation of JavaDoc & Dokka artifacts
def platform = platformOf(project)
def coroutines_core = platformLib("kotlinx-coroutines-core", platform)
def makeLinkMapping(dokka, projectDir) {
dokka.linkMapping {
def relPath = rootProject.projectDir.toPath().relativize(projectDir.toPath())
dir = "$projectDir/src/main/kotlin"
url = "http:https://github.com/kotlin/kotlinx.coroutines/tree/master/$relPath/src/main/kotlin"
suffix = "#L"
}
}
if (platform == "jvm") {
apply plugin: 'org.jetbrains.dokka'
tasks.withType(dokka.getClass()) {
jdkVersion = 8
includes = ['README.md']
}
dokka {
outputFormat = 'kotlin-website'
}
if (project.name == coroutines_core) {
// Custom configuration for MPP modules
dependencies {
compileOnly project(":js-stub") // so that JS library reference can resolve properly
}
dokka {
kotlinTasks { [] }
suppressedModifiers = ['actual']
// map for JS & Common sources
makeLinkMapping(it, projectDir)
makeLinkMapping(it, rootProject.file("js/$project.name-js"))
makeLinkMapping(it, rootProject.file("common/$project.name-common"))
// source roots
impliedPlatforms = ['JVM', 'JS']
sourceRoot {
path = rootProject.file("core/$project.name/src/main/kotlin")
platforms = ['JVM']
}
sourceRoot {
path = rootProject.file("js/$project.name-js/src/main/kotlin")
platforms = ['JS']
}
sourceRoot {
path = rootProject.file("common/$project.name-common/src/main/kotlin")
}
// depends on JS & Common, too
afterEvaluate {
dependsOn(tasks.getByPath(":$project.name:classes"))
dependsOn(tasks.getByPath(":$project.name-js:classes"))
dependsOn(tasks.getByPath(":$project.name-common:classes"))
dependsOn(project.configurations.compileClasspath)
classpath = project.configurations.compileClasspath.files + project.sourceSets.main.output.files
}
}
}
// real xxx-javadoc.jar for JVM
task dokkaJavadoc(type: dokka.getClass()) {
outputFormat = 'javadoc'
outputDirectory = "$buildDir/javadoc"
}
task javadocJar(type: Jar, dependsOn: dokkaJavadoc) {
classifier = 'javadoc'
from "$buildDir/javadoc"
}
} else {
// empty xxx-javadoc.jar for JS and Common modules
task javadocJar(type: Jar) {
classifier = 'javadoc'
from "$buildDir/javadoc" // would not exist
}
}