blob: f511543524600050bee202edfb28c991566689d5 (
plain)
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
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
|
package org.jetbrains.dokka
import java.io.File
import java.net.URL
enum class Platform(val key: String) {
jvm("jvm"),
js("js"),
native("native"),
common("common");
companion object {
val DEFAULT = jvm
fun fromString(key: String): Platform {
return when (key.toLowerCase()) {
jvm.key -> jvm
js.key -> js
native.key -> native
common.key -> common
else -> throw IllegalArgumentException("Unrecognized platform: $key")
}
}
}
}
interface DokkaConfiguration {
val outputDir: String
val format: String
val cacheRoot: String?
val offlineMode: Boolean
val passesConfigurations: List<PassConfiguration>
val modules: List<DokkaModuleDescription>
val pluginsClasspath: List<File>
val pluginsConfiguration: Map<String, String>
val failOnWarning: Boolean
interface PassConfiguration {
val moduleName: String
val displayName: String
val sourceSetID: String
val classpath: List<String>
val sourceRoots: List<SourceRoot>
val dependentSourceSets: List<String>
val samples: List<String>
val includes: List<String>
val includeNonPublic: Boolean
val includeRootPackage: Boolean
val reportUndocumented: Boolean
val skipEmptyPackages: Boolean
val skipDeprecated: Boolean
val jdkVersion: Int
val sourceLinks: List<SourceLinkDefinition>
val perPackageOptions: List<PackageOptions>
val externalDocumentationLinks: List<ExternalDocumentationLink>
val languageVersion: String?
val apiVersion: String?
val noStdlibLink: Boolean
val noJdkLink: Boolean
val suppressedFiles: List<String>
val analysisPlatform: Platform
}
interface SourceRoot {
val path: String
}
interface SourceLinkDefinition {
val path: String
val url: String
val lineSuffix: String?
}
interface DokkaModuleDescription {
val name: String
val path: String
val docFile: String
}
interface PackageOptions {
val prefix: String
val includeNonPublic: Boolean
val reportUndocumented: Boolean?
val skipDeprecated: Boolean
val suppress: Boolean
}
interface ExternalDocumentationLink {
val url: URL
val packageListUrl: URL
open class Builder(open var url: URL? = null,
open var packageListUrl: URL? = null) {
constructor(root: String, packageList: String? = null) : this(URL(root), packageList?.let { URL(it) })
fun build(): ExternalDocumentationLink =
if (packageListUrl != null && url != null)
ExternalDocumentationLinkImpl(url!!, packageListUrl!!)
else if (url != null)
ExternalDocumentationLinkImpl(url!!, URL(url!!, "package-list"))
else
throw IllegalArgumentException("url or url && packageListUrl must not be null for external documentation link")
}
}
}
|
