chore: bump Dokka to v2, and reduce Gradle daemon memory consumption

Previously, Dokka (kotlin doc + javadoc) was running within Gradle Daemon process,
so it required every Gradle Daemon to allocate lots of heap.

The change allows reducing heap consumption

Author: vlsi

build-logic/jvm/build.gradle.kts

@@ -27,5 +27,5 @@ dependencies {
     api("com.github.vlsi.gradle-extensions:com.github.vlsi.gradle-extensions.gradle.plugin:1.90")
     api("org.jetbrains.kotlin.jvm:org.jetbrains.kotlin.jvm.gradle.plugin:1.9.22")
     api("org.jetbrains.kotlin.kapt:org.jetbrains.kotlin.kapt.gradle.plugin:1.9.22")
-    api("org.jetbrains.dokka:org.jetbrains.dokka.gradle.plugin:1.9.10")
+    api("org.jetbrains.dokka:org.jetbrains.dokka.gradle.plugin:2.0.0")
 }

build-logic/jvm/src/main/kotlin/build-logic.dokka-javadoc.gradle.kts

@@ -17,7 +17,7 @@
 
 plugins {
     id("java-base")
-    id("org.jetbrains.dokka")
+    id("org.jetbrains.dokka-javadoc")
 }
 
 java {
@@ -30,15 +30,21 @@ tasks.named<Jar>("javadocJar") {
     archiveClassifier.set("javadoc_java")
 }
 
-tasks.dokkaJavadoc {
-    moduleName.set("Apache JMeter ${project.name}")
+dokka {
+    moduleName = "Apache JMeter ${project.name}"
+    dokkaGeneratorIsolation = ProcessIsolation {
+        maxHeapSize = "2g"
+    }
+}
+
+tasks.dokkaGeneratePublicationJavadoc {
     mustRunAfter("kaptKotlin")
 }
 
 val dokkaJar by tasks.registering(Jar::class) {
     group = LifecycleBasePlugin.BUILD_GROUP
     description = "Assembles a jar archive containing javadoc"
-    from(tasks.dokkaJavadoc)
+    from(tasks.dokkaGeneratePublicationJavadoc)
     archiveClassifier.set("javadoc")
 }
 

gradle.properties

@@ -15,7 +15,7 @@
 # limitations under the License.
 #
 
-org.gradle.jvmargs=-Xmx700m -XX:MaxMetaspaceSize=368m
+org.gradle.jvmargs=-Xms128m -Xmx768m -XX:MaxMetaspaceSize=768m -XX:+HeapDumpOnOutOfMemoryError
 org.gradle.parallel=true
 # Build cache can be disabled with --no-build-cache option
 org.gradle.caching=true
@@ -24,6 +24,10 @@ org.gradle.dependency.verification.console=verbose
 
 kapt.include.compile.classpath=false
 
+# Kotlin Dokka is experemental, and we want silence the build warning
+org.jetbrains.dokka.experimental.gradle.pluginMode=V2Enabled
+org.jetbrains.dokka.experimental.gradle.pluginMode.noWarn=true
+
 # See https://github.com/gradle/gradle/pull/11358 , https://issues.apache.org/jira/browse/INFRA-14923
 # repository.apache.org does not yet support .sha256 and .sha512 checksums
 systemProp.org.gradle.internal.publish.checksums.insecure=true

gradle/verification-metadata.xml

@@ -207,6 +207,7 @@
             <trusting group="org.apache.commons"/>
             <trusting group="org.xmlunit"/>
          </trusted-key>
+         <trusted-key id="CFBE6E7934FB211224EE1C2B0C0A9468268C79AE" group="org.jetbrains"/>
          <trusted-key id="D022218DCC08AAD6EF3AF876B3DE72E647D35161" group="org.testcontainers"/>
          <trusted-key id="D112630C899F508198C09018105CB91CAC2AEE0E">
             <trusting group="com.github.autostyle"/>
@@ -508,6 +509,11 @@
             <sha256 value="27bb52753f97b2cbedd5ad72e111e05e53e0b08a4d22a2aaa80069df5d527ae1" origin="Generated by Gradle" reason="Artifact is not signed"/>
          </artifact>
       </component>
+      <component group="org.jetbrains.dokka" name="org.jetbrains.dokka.gradle.plugin" version="2.0.0">
+         <artifact name="org.jetbrains.dokka.gradle.plugin-2.0.0.pom">
+            <sha256 value="e1fc686a01837e7e86291185901507ffeaf794b8a9ec947b5d04368fa70e00ca" origin="Generated by Gradle" reason="Artifact is not signed"/>
+         </artifact>
+      </component>
       <component group="org.jetbrains.gradle.plugin.idea-ext" name="org.jetbrains.gradle.plugin.idea-ext.gradle.plugin" version="1.1.7">
          <artifact name="org.jetbrains.gradle.plugin.idea-ext.gradle.plugin-1.1.7.pom">
             <sha256 value="b953806a04ecd62b1bc87f81da56e809f5f0d7881c181f056554805af8664eb9" origin="Generated by Gradle" reason="Artifact is not signed"/>