From be7f1798bff559fbb1b33b83ec396fc4b5f044d8 Mon Sep 17 00:00:00 2001
From: Thilo Schwarz <osp@thischwa.codes>
Date: Mon, 24 Mar 2025 18:24:22 +0100
Subject: [PATCH] Refactor javadoc plugin into a Maven profile.

Moved javadoc configuration and execution into a dedicated profile to improve build configuration modularity. This change ensures the javadoc generation is optional and can be controlled via the `javadoc` profile activation.
---
 pom.xml | 38 ++++++++++++++++++++++++++++++--------
 1 file changed, 30 insertions(+), 8 deletions(-)

diff --git a/pom.xml b/pom.xml
index feeff61..89f5afb 100644
--- a/pom.xml
+++ b/pom.xml
@@ -114,16 +114,8 @@
                     <failOnError>false</failOnError>
                     <locale>en</locale>
                     <source>${java.version}</source>
-                    <reportOutputDirectory>${project.basedir}/docs</reportOutputDirectory>
                 </configuration>
                 <executions>
-                    <execution>
-                        <id>build javadoc html</id>
-                        <goals>
-                            <goal>javadoc</goal>
-                        </goals>
-                        <phase>package</phase>
-                    </execution>
                     <execution>
                         <id>build javadoc jar</id>
                         <goals>
@@ -201,4 +193,34 @@
             </plugin>
         </plugins>
     </build>
+
+    <profiles>
+        <profile>
+            <id>javadoc</id>
+            <build>
+                <plugins>
+                    <plugin>
+                        <groupId>org.apache.maven.plugins</groupId>
+                        <artifactId>maven-javadoc-plugin</artifactId>
+                        <version>3.6.3</version>
+                        <configuration>
+                            <failOnError>false</failOnError>
+                            <locale>en</locale>
+                            <source>${java.version}</source>
+                            <reportOutputDirectory>${project.basedir}/docs</reportOutputDirectory>
+                        </configuration>
+                        <executions>
+                            <execution>
+                                <id>build-javadoc-html</id>
+                                <goals>
+                                    <goal>javadoc</goal>
+                                </goals>
+                                <phase>package</phase>
+                            </execution>
+                        </executions>
+                    </plugin>
+                </plugins>
+            </build>
+        </profile>
+    </profiles>
 </project>
\ No newline at end of file