aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--runners/cli/build.gradle2
-rw-r--r--runners/cli/src/main/kotlin/cli/main.kt77
2 files changed, 45 insertions, 34 deletions
diff --git a/runners/cli/build.gradle b/runners/cli/build.gradle
index 24db0b1e..ed560112 100644
--- a/runners/cli/build.gradle
+++ b/runners/cli/build.gradle
@@ -11,6 +11,6 @@ tasks.withType(org.jetbrains.kotlin.gradle.tasks.KotlinCompile).all {
}
dependencies {
- implementation "org.jetbrains.kotlinx:kotlinx-cli-jvm:0.1.0-dev-3"
+ implementation "org.jetbrains.kotlinx:kotlinx-cli-jvm:0.1.0-dev-5"
implementation project(":core")
}
diff --git a/runners/cli/src/main/kotlin/cli/main.kt b/runners/cli/src/main/kotlin/cli/main.kt
index 3bd52a39..52815e75 100644
--- a/runners/cli/src/main/kotlin/cli/main.kt
+++ b/runners/cli/src/main/kotlin/cli/main.kt
@@ -27,10 +27,7 @@ open class GlobalArguments(parser: DokkaArgumentsParser) : DokkaConfiguration {
"Path to cache folder, or 'default' to use ~/.cache/dokka, if not provided caching is disabled",
null)
- override val impliedPlatforms: List<String> by parser.repeatableOption(
- listOf("-impliedPlatforms"),
- "List of implied platforms (comma-separated)"
- )
+ override val impliedPlatforms: List<String> = emptyList()
override val passesConfigurations: List<Arguments> by parser.repeatableFlag(
listOf("-pass"),
@@ -57,7 +54,7 @@ class Arguments(val parser: DokkaArgumentsParser) : DokkaConfiguration.PassConfi
) { SourceRootImpl(it) }
override val samples: List<String> by parser.repeatableOption(
- listOf("-samples"),
+ listOf("-sample"),
"Source root for samples"
)
@@ -72,22 +69,22 @@ class Arguments(val parser: DokkaArgumentsParser) : DokkaConfiguration.PassConfi
override val includeRootPackage: Boolean by parser.singleFlag(
listOf("-includeRootPackage"),
- "Include non public")
+ "Include root package")
override val reportUndocumented: Boolean by parser.singleFlag(
listOf("-reportUndocumented"),
- "Include non public")
+ "Report undocumented members")
override val skipEmptyPackages: Boolean by parser.singleFlag(
listOf("-skipEmptyPackages"),
- "Include non public")
+ "Do not create index pages for empty packages")
override val skipDeprecated: Boolean by parser.singleFlag(
listOf("-skipDeprecated"),
- "Include non public")
+ "Do not output deprecated members")
override val jdkVersion: Int by parser.singleOption(
- listOf("jdkVersion"),
+ listOf("-jdkVersion"),
"Version of JDK to use for linking to JDK JavaDoc",
{ it.toInt() },
{ 6 }
@@ -99,7 +96,7 @@ class Arguments(val parser: DokkaArgumentsParser) : DokkaConfiguration.PassConfi
null)
override val apiVersion: String? by parser.stringOption(
- listOf("-apiVesion"),
+ listOf("-apiVersion"),
"Kotlin Api Version to pass to Kotlin Analysis",
null
)
@@ -110,10 +107,10 @@ class Arguments(val parser: DokkaArgumentsParser) : DokkaConfiguration.PassConfi
override val noJdkLink: Boolean by parser.singleFlag(
listOf("-noJdkLink"),
- "Disable documentation link to stdlib")
+ "Disable documentation link to JDK")
override val suppressedFiles: List<String> by parser.repeatableOption(
- listOf("-suppressedFiles"),
+ listOf("-suppressedFile"),
""
)
@@ -135,17 +132,34 @@ class Arguments(val parser: DokkaArgumentsParser) : DokkaConfiguration.PassConfi
)
override val targets: List<String> by parser.repeatableOption(
- listOf("-targets"),
+ listOf("-target"),
"Generation targets"
)
+ override val perPackageOptions: MutableList<DokkaConfiguration.PackageOptions> by parser.singleOption(
+ listOf("-packageOptions"),
+ "List of package passConfiguration in format \"prefix,-deprecated,-privateApi,+warnUndocumented,+suppress;...\" ",
+ { parsePerPackageOptions(it).toMutableList() },
+ { mutableListOf() }
+ )
+ override val externalDocumentationLinks: MutableList<DokkaConfiguration.ExternalDocumentationLink> by parser.singleOption(
+ listOf("-links"),
+ "External documentation links in format url^packageListUrl^^url2...",
+ { MainKt.parseLinks(it).toMutableList() },
+ { mutableListOf() }
+ )
- override val sourceLinks: MutableList<DokkaConfiguration.SourceLinkDefinition> = mutableListOf()
-
- override val perPackageOptions: MutableList<DokkaConfiguration.PackageOptions> = mutableListOf()
-
- override val externalDocumentationLinks: MutableList<DokkaConfiguration.ExternalDocumentationLink> = mutableListOf()
+ override val sourceLinks: MutableList<DokkaConfiguration.SourceLinkDefinition> by parser.repeatableOption(
+ listOf("-srcLink"),
+ "Mapping between a source directory and a Web site for browsing the code"
+ ) {
+ if (it.isNotEmpty() && it.contains("="))
+ SourceLinkDefinitionImpl.parseSourceLinkDefinition(it)
+ else {
+ throw IllegalArgumentException("Warning: Invalid -srcLink syntax. Expected: <path>=<url>[#lineSuffix]. No source links will be generated.")
+ }
+ }
}
object MainKt {
@@ -211,27 +225,24 @@ object MainKt {
fun createConfiguration(args: Array<String>): GlobalArguments {
val parseContext = ParseContext()
val parser = DokkaArgumentsParser(args, parseContext)
-
-
val configuration = GlobalArguments(parser)
-
parseContext.cli.singleAction(
- listOf("-packageOptions"),
+ listOf("-globalPackageOptions"),
"List of package passConfiguration in format \"prefix,-deprecated,-privateApi,+warnUndocumented,+suppress;...\" "
- ) {
- configuration.passesConfigurations.last().perPackageOptions.addAll(parsePerPackageOptions(it))
+ ) { link ->
+ configuration.passesConfigurations.all { it.perPackageOptions.addAll(parsePerPackageOptions(link)) }
}
parseContext.cli.singleAction(
- listOf("-links"),
+ listOf("-globalLinks"),
"External documentation links in format url^packageListUrl^^url2..."
- ) {
- configuration.passesConfigurations.last().externalDocumentationLinks.addAll(MainKt.parseLinks(it))
+ ) { link ->
+ configuration.passesConfigurations.all { it.externalDocumentationLinks.addAll(parseLinks(link)) }
}
- parseContext.cli.singleAction(
- listOf("-srcLink"),
+ parseContext.cli.repeatingAction(
+ listOf("-globalSrcLink"),
"Mapping between a source directory and a Web site for browsing the code"
) {
val newSourceLinks = if (it.isNotEmpty() && it.contains("="))
@@ -243,8 +254,7 @@ object MainKt {
listOf()
}
- configuration.passesConfigurations.last().sourceLinks.addAll(newSourceLinks)
-
+ configuration.passesConfigurations.all { it.sourceLinks.addAll(newSourceLinks) }
}
parser.parseInto(configuration)
@@ -254,7 +264,8 @@ object MainKt {
@JvmStatic
fun main(args: Array<String>) {
val configuration = createConfiguration(args)
- if (configuration.format == "javadoc")
+
+ if (configuration.format.toLowerCase() == "javadoc")
startWithToolsJar(configuration)
else
entry(configuration)