From 62c36de8c6fe75662464971bce25535ed2ecf69f Mon Sep 17 00:00:00 2001
From: darksaid98 <darksaid9889@gmail.com>
Date: Thu, 22 Feb 2024 19:09:05 +0100
Subject: [PATCH] build: enable javadoc generation by default

---
 build.gradle.kts | 10 ++++++++--
 1 file changed, 8 insertions(+), 2 deletions(-)

diff --git a/build.gradle.kts b/build.gradle.kts
index c368f20..e383026 100644
--- a/build.gradle.kts
+++ b/build.gradle.kts
@@ -22,7 +22,8 @@ val mainPackage = "${project.group}.${rootProject.name.lowercase()}"
 
 java {
     toolchain.languageVersion.set(JavaLanguageVersion.of(17)) // Configure the java toolchain. This allows gradle to auto-provision JDK 17 on systems that only have JDK 8 installed for example.
-//    withJavadocJar() // NOTE: Use if you want to generate javadocs for your plugin
+    withJavadocJar() // Enable Javadoc generation
+//    withSourcesJar()
 }
 
 repositories {
@@ -102,8 +103,13 @@ tasks {
     }
 
     javadoc {
-        options.encoding = Charsets.UTF_8.name() // We want UTF-8 for everything
+        isFailOnError = false
         exclude("${mainPackage.replace(".", "/")}/db/schema/**") // Exclude generated jOOQ sources from javadocs
+        val options = options as StandardJavadocDocletOptions
+        options.encoding = Charsets.UTF_8.name() // We want UTF-8 for everything
+        options.overview = "src/main/javadoc/overview.html"
+        options.tags("apiNote:a:API Note:", "implNote:a:Implementation Note:", "implSpec:a:Implementation Requirements:")
+        options.use()
     }
 
     processResources {