dokka tasks improved.

Author: syslogic

wallet-core/build.gradle.kts

@@ -14,6 +14,7 @@
  * limitations under the License.
  */
 
+import com.android.build.gradle.internal.tasks.factory.dependsOn
 import com.github.jk1.license.filter.DependencyFilter
 import com.github.jk1.license.filter.ExcludeTransitiveDependenciesFilter
 import com.github.jk1.license.filter.LicenseBundleNormalizer
@@ -180,8 +181,11 @@ dependencyCheck {
 // Dokka generation
 dokka {
     dokkaSourceSets.configureEach {
+        dokkaPublications.javadoc {
+            outputDirectory.set(rootProject.file("docs/javadoc"))
+        }
         dokkaPublications.html {
-            outputDirectory.set(rootProject.file("docs"))
+            outputDirectory.set(rootProject.file("docs/html"))
         }
         externalDocumentationLinks.register("android") {
             url("https://developer.android.com/reference")
@@ -194,20 +198,40 @@ dokka {
     }
 }
 
-val dokkaHtmlJar by tasks.registering(Jar::class) {
-    group = "documentation"
+val dokkaGenerateJavadocJar by tasks.registering(Jar::class) {
+    group = "dokka"
+    dependsOn(tasks.dokkaGeneratePublicationJavadoc)
+    from(tasks.dokkaGeneratePublicationJavadoc.flatMap { it.outputDirectory })
+    archiveClassifier.set("javadoc")
+    description = "Assembles a JAR containing the Javadoc-style documentation generated by Dokka."
+}
+
+val dokkaGenerateHtmlJar by tasks.registering(Jar::class) {
+    group = "dokka"
     dependsOn(tasks.dokkaGeneratePublicationHtml)
     from(tasks.dokkaGeneratePublicationHtml.flatMap { it.outputDirectory })
     archiveClassifier.set("html-docs")
     description = "Assembles a JAR containing the HTML documentation generated by Dokka."
 }
 
-val dokkaJavadocJar by tasks.registering(Jar::class) {
-    group = "documentation"
-    dependsOn(tasks.dokkaGeneratePublicationJavadoc)
-    from(tasks.dokkaGeneratePublicationJavadoc.flatMap { it.outputDirectory })
-    archiveClassifier.set("javadoc")
-    description = "Assembles a JAR containing the Javadoc-style documentation generated by Dokka."
+val dokkaCleanJavadoc by tasks.registering(Delete::class) {
+    group = "dokka"
+    delete = setOf(rootProject.file("docs/javadoc"))
+    description = "It removes the documentation generated by Dokka."
+}
+
+val dokkaCleanHtml by tasks.registering(Delete::class) {
+    group = "dokka"
+    delete = setOf(rootProject.file("docs/html"))
+    description = "It removes the documentation generated by Dokka."
+}
+
+tasks.dokkaGeneratePublicationJavadoc.dependsOn(dokkaCleanJavadoc)
+tasks.dokkaGeneratePublicationHtml.dependsOn(dokkaCleanHtml)
+
+val dokkaClean by tasks.registering() {
+    group = "dokka"
+    dependsOn(dokkaCleanJavadoc, dokkaCleanHtml)
 }
 
 // Third-party licenses report
@@ -236,8 +260,8 @@ tasks.generateLicenseReport.configure {
 // Build documentation and license report
 tasks.register<Task>("buildDocumentation") {
     group = "documentation"
-    dependsOn("dokkaGfm", "generateLicenseReport")
-    description = "Aggregates all documentation tasks (Dokka GFM, License Report)."
+    dependsOn("dokkaGenerate", "generateLicenseReport")
+    description = "Aggregates all documentation tasks (Dokka, License Report)."
 }
 tasks.assemble.configure {
     finalizedBy("buildDocumentation")