Configure javadoc overview and doc-files copying

closes #7462

Co-authored-by: Jake Potrebic <jake.m.potrebic@gmail.com>

patches/api/Adventure.patch

@@ -43,21 +43,7 @@ index 0000000000000000000000000000000000000000..00000000000000000000000000000000
      // Paper end
  
      compileOnly("org.apache.maven:maven-resolver-provider:3.8.4")
-@@ -0,0 +0,0 @@ tasks.jar {
+@@ -0,0 +0,0 @@ tasks.withType<Javadoc> {
- }
- 
- tasks.withType<Javadoc> {
-+    inputs.files(apiAndDocs)
-+        .ignoreEmptyDirectories()
-+        .withPropertyName(apiAndDocs.name + "-configuration")
-+    doFirst {
-+        (options as CoreJavadocOptions).addStringOption(
-+            "sourcepath",
-+            apiAndDocs.resolvedConfiguration.files.joinToString(separator = File.pathSeparator, transform = File::getPath)
-+        )
-+    }
-     (options as StandardJavadocDocletOptions).links(
-         "https://guava.dev/releases/31.0.1-jre/api/docs/",
          "https://javadoc.io/doc/org.yaml/snakeyaml/1.30/",
          "https://javadoc.io/doc/org.jetbrains/annotations/23.0.0/", // Paper - we don't want Java 5 annotations
          "https://javadoc.io/doc/net.md-5/bungeecord-chat/1.16-R0.4/",
@@ -68,7 +54,18 @@ index 0000000000000000000000000000000000000000..00000000000000000000000000000000
 +        "https://jd.adventure.kyori.net/text-serializer-plain/$adventureVersion/",
 +        // Paper end
      )
- }
+ 
++    inputs.files(apiAndDocs).ignoreEmptyDirectories().withPropertyName(apiAndDocs.name + "-configuration")
++    doFirst {
++        options.addStringOption(
++            "sourcepath",
++            apiAndDocs.resolvedConfiguration.files.joinToString(separator = File.pathSeparator, transform = File::getPath)
++        )
++    }
++
+     // workaround for https://github.com/gradle/gradle/issues/4046
+     inputs.dir("src/main/javadoc").withPropertyName("javadoc-sourceset")
+     doLast {
 diff --git a/src/main/java/co/aikar/timings/TimingsReportListener.java b/src/main/java/co/aikar/timings/TimingsReportListener.java
 index 0000000000000000000000000000000000000000..0000000000000000000000000000000000000000 100644
 --- a/src/main/java/co/aikar/timings/TimingsReportListener.java

patches/api/Build-system-changes.patch

@@ -38,11 +38,11 @@ index 0000000000000000000000000000000000000000..00000000000000000000000000000000
      testImplementation("org.hamcrest:hamcrest-library:1.3")
      testImplementation("org.ow2.asm:asm-tree:9.2")
 @@ -0,0 +0,0 @@ tasks.withType<Javadoc> {
-     (options as StandardJavadocDocletOptions).links(
+     options.links(
          "https://guava.dev/releases/31.0.1-jre/api/docs/",
          "https://javadoc.io/doc/org.yaml/snakeyaml/1.30/",
 -        "https://javadoc.io/doc/org.jetbrains/annotations-java5/23.0.0/",
 +        "https://javadoc.io/doc/org.jetbrains/annotations/23.0.0/", // Paper - we don't want Java 5 annotations
          "https://javadoc.io/doc/net.md-5/bungeecord-chat/1.16-R0.4/",
      )
- }
+ 

patches/api/Convert-project-to-Gradle.patch

@@ -90,12 +90,26 @@ index 0000000000000000000000000000000000000000..00000000000000000000000000000000
 +}
 +
 +tasks.withType<Javadoc> {
-+    (options as StandardJavadocDocletOptions).links(
++    val options = options as StandardJavadocDocletOptions
++    options.overview = "src/main/javadoc/overview.html"
++    options.isDocFilesSubDirs = true
++    options.links(
 +        "https://guava.dev/releases/31.0.1-jre/api/docs/",
 +        "https://javadoc.io/doc/org.yaml/snakeyaml/1.30/",
 +        "https://javadoc.io/doc/org.jetbrains/annotations-java5/23.0.0/",
 +        "https://javadoc.io/doc/net.md-5/bungeecord-chat/1.16-R0.4/",
 +    )
++
++    // workaround for https://github.com/gradle/gradle/issues/4046
++    inputs.dir("src/main/javadoc").withPropertyName("javadoc-sourceset")
++    doLast {
++        copy {
++            from("src/main/javadoc") {
++                include("**/doc-files/**")
++            }
++            into("build/docs/javadoc")
++        }
++    }
 +}
 diff --git a/pom.xml b/pom.xml
 deleted file mode 100644