Generate aggregate javadoc and sources at top-level (#11)

Author: mcculls

build.gradle.kts

@@ -10,6 +10,11 @@ repositories {
   mavenCentral()
 }
 
+java {
+  withJavadocJar()
+  withSourcesJar()
+}
+
 val embed by configurations.creating {
   isTransitive = false
 }
@@ -25,3 +30,15 @@ tasks.jar {
   dependsOn(embed)
   from(embed.map { zipTree(it) })
 }
+tasks.javadoc {
+  dependsOn(embed)
+  setSource(subprojects.map { it.sourceSets.main.get().allSource })
+  classpath = files(subprojects.flatMap { it.sourceSets.main.get().compileClasspath })
+  if (JavaVersion.current().isJava9Compatible) {
+    (options as StandardJavadocDocletOptions).addBooleanOption("html5", true)
+  }
+}
+tasks.named<Jar>("sourcesJar") {
+  dependsOn(embed)
+  from(subprojects.map { it.sourceSets.main.get().allSource })
+}

buildSrc/src/main/kotlin/instrument-glue.gradle.kts

@@ -36,6 +36,9 @@ tasks.register<JavaExec>("generateGlue") {
 tasks.compileJava {
   dependsOn(tasks.named("generateGlue"))
 }
+tasks.named("sourcesJar") {
+  dependsOn(tasks.named("generateGlue"))
+}
 
 tasks.jar {
   // glue classes only contain large string constants that get inlined into other classes

buildSrc/src/main/kotlin/java-common.gradle.kts

@@ -19,11 +19,19 @@ java {
   toolchain {
     languageVersion = JavaLanguageVersion.of(17)
   }
+  withJavadocJar()
+  withSourcesJar()
 }
 tasks.withType<JavaCompile>().configureEach {
   options.release = 8
 }
 
+tasks.javadoc {
+  if (JavaVersion.current().isJava9Compatible) {
+    (options as StandardJavadocDocletOptions).addBooleanOption("html5", true)
+  }
+}
+
 dependencies {
   compileOnly(libs.spotbugs.annotations)
   testCompileOnly(libs.spotbugs.annotations)