From 9af7ed283ba8ba059ea0b7c89dea5906ba060c68 Mon Sep 17 00:00:00 2001
From: Ceki Gulcu <ceki@qos.ch>
Date: Fri, 22 Dec 2023 22:19:53 +0100
Subject: [PATCH] more tinkering with the javadocs

Signed-off-by: Ceki Gulcu <ceki@qos.ch>
---
 parent/pom.xml                 | 113 ++++++++-------------------------
 pom.xml                        |  34 ++++++++++
 src/main/javadoc/overview.html |   7 ++
 3 files changed, 67 insertions(+), 87 deletions(-)
 create mode 100644 src/main/javadoc/overview.html

diff --git a/parent/pom.xml b/parent/pom.xml
index 16bed26c5..72d571f98 100644
--- a/parent/pom.xml
+++ b/parent/pom.xml
@@ -126,23 +126,24 @@
           <version>${maven-deploy-plugin.version}</version>
         </plugin>
 
-        <plugin>
-          <groupId>org.apache.maven.plugins</groupId>
-          <artifactId>maven-javadoc-plugin</artifactId>
-          <version>${maven-javadoc-plugin.version}</version>
-          <configuration>
-            <verbose>true</verbose>
-            <skippedModules>
-              slf4j-ext,log4j-over-slf4j,log4j-over-slf4j-blackbox,jul-to-slf4j-blackbox,slf4j-migrator,osgi-over-slf4j
-            </skippedModules>
-            <detectLinks>true</detectLinks>
-            <linksource>true</linksource>
-            <additionalOptions>
-              <additionalOption>-Xdoclint:none</additionalOption>
-              <!--              <additionalOption>doclint:none</additionalOption>-->
-            </additionalOptions>
-          </configuration>
-        </plugin>
+        <!--        <plugin>-->
+        <!--          <groupId>org.apache.maven.plugins</groupId>-->
+        <!--          <artifactId>maven-javadoc-plugin</artifactId>-->
+        <!--          <version>${maven-javadoc-plugin.version}</version>-->
+        <!--          <configuration>-->
+        <!--            <verbose>true</verbose>-->
+        <!--            <skippedModules>-->
+        <!--              slf4j-ext,log4j-over-slf4j,log4j-over-slf4j-blackbox,jul-to-slf4j-blackbox,slf4j-migrator,osgi-over-slf4j-->
+        <!--            </skippedModules>-->
+        <!--            <detectLinks>true</detectLinks>-->
+        <!--            <doctitle>SLF4J project ${project.version}</doctitle>-->
+        <!--            <linksource>true</linksource>-->
+        <!--            <additionalOptions>-->
+        <!--              <additionalOption>-Xdoclint:none</additionalOption>-->
+        <!--              &lt;!&ndash;              <additionalOption>doclint:none</additionalOption>&ndash;&gt;-->
+        <!--            </additionalOptions>-->
+        <!--          </configuration>-->
+        <!--        </plugin>-->
       </plugins>
     </pluginManagement>
 
@@ -251,67 +252,29 @@
         </executions>
       </plugin>
 
-      <plugin>
-        <groupId>org.apache.maven.plugins</groupId>
-        <artifactId>maven-site-plugin</artifactId>
-        <version>${maven-site-plugin.version}</version>
-      </plugin>
-
-      <!--      <plugin>-->
-      <!--        <groupId>org.apache.maven.plugins</groupId>-->
-      <!--        <artifactId>maven-javadoc-plugin</artifactId>-->
-      <!--        <configuration>-->
-      <!--          <skippedModules>-->
-      <!--            :slf4j-ext,:log4j-over-slf4j,:log4j-over-slf4j-blackbox,jul-to-slf4j-blackbox,slf4j-migrator,:osgi-over-slf4j-->
-      <!--          </skippedModules>-->
-      <!--        </configuration>-->
-      <!--      </plugin>-->
-
-      <plugin>
-        <groupId>org.apache.maven.plugins</groupId>
-        <artifactId>maven-jxr-plugin</artifactId>
-        <version>${maven-jxr-plugin.version}</version>
-        <configuration>
-          <aggregate>true</aggregate>
-          <javadocDir>target/site/apidocs2/</javadocDir>
-          <linkJavadoc>true</linkJavadoc>
-        </configuration>
-      </plugin>
-
-    </plugins>
-  </build>
-
-  <reporting>
-    <plugins>
       <plugin>
         <groupId>org.apache.maven.plugins</groupId>
         <artifactId>maven-javadoc-plugin</artifactId>
         <version>${maven-javadoc-plugin.version}</version>
-        <configuration>
+        <configuration combine.self="append">
           <verbose>true</verbose>
           <skippedModules>
             slf4j-ext,log4j-over-slf4j,log4j-over-slf4j-blackbox,jul-to-slf4j-blackbox,slf4j-migrator,osgi-over-slf4j
           </skippedModules>
           <detectLinks>true</detectLinks>
+          <doctitle>SLF4J project ${project.version}</doctitle>
           <linksource>true</linksource>
           <additionalOptions>
             <additionalOption>-Xdoclint:none</additionalOption>
-            <!--              <additionalOption>doclint:none</additionalOption>-->
+<!--            <additionalOption>doclint:none</additionalOption>-->
           </additionalOptions>
         </configuration>
       </plugin>
 
-      <plugin>
-        <groupId>org.apache.maven.plugins</groupId>
-        <artifactId>maven-jxr-plugin</artifactId>
-        <version>${maven-jxr-plugin.version}</version>
-        <configuration>
-          <javadocDir>target/site/apidocs/</javadocDir>
-          <linkJavadoc>true</linkJavadoc>
-        </configuration>
-      </plugin>
-
     </plugins>
+  </build>
+
+  <reporting>
   </reporting>
 
   <profiles>
@@ -350,6 +313,8 @@
       </build>
     </profile>
 
+
+
     <profile>
       <id>license</id>
       <build>
@@ -412,32 +377,6 @@
       </build>
     </profile>
 
-    <!--
-    <profile>
-      <id>travis</id>
-      <activation>
-        <property>
-          <name>env.TRAVIS</name>
-          <value>true</value>
-        </property>
-      </activation>
-      <build>
-        <plugins>
-          <plugin>
-            <groupId>org.apache.maven.plugins</groupId>
-            <artifactId>maven-toolchains-plugin</artifactId>
-            <version>1.1</version>
-            <executions>
-              <execution>
-                <id>toolchain</id>
-                <phase>none</phase>
-              </execution>
-            </executions>
-          </plugin>
-        </plugins>
-      </build>
-    </profile>
-    -->
   </profiles>
 
 
diff --git a/pom.xml b/pom.xml
index d1313211f..aaf981e20 100755
--- a/pom.xml
+++ b/pom.xml
@@ -172,6 +172,40 @@
         </plugins>
       </build>
     </profile>
+
+    <profile>
+      <id>prayer</id>
+      <build>
+        <plugins>
+          <plugin>
+            <groupId>org.apache.maven.plugins</groupId>
+            <artifactId>maven-javadoc-plugin</artifactId>
+            <version>3.6.3</version>
+            <executions>
+              <execution>
+                <id>default</id>
+                <goals>
+                  <goal>aggregate</goal>
+                </goals>
+              </execution>
+            </executions>
+            <configuration>
+              <verbose>true</verbose>
+              <skippedModules>
+                slf4j-ext,log4j-over-slf4j,log4j-over-slf4j-blackbox,jul-to-slf4j-blackbox,slf4j-migrator,osgi-over-slf4j
+              </skippedModules>
+              <detectLinks>true</detectLinks>
+              <doctitle>SLF4J project ${project.version}</doctitle>
+              <windowtitle>SLF4J bla</windowtitle>
+              <linksource>true</linksource>
+              <additionalOptions>
+                <additionalOption>-Xdoclint:none</additionalOption>
+              </additionalOptions>
+            </configuration>
+          </plugin>
+        </plugins>
+      </build>
+    </profile>
   </profiles>
   
 </project>
diff --git a/src/main/javadoc/overview.html b/src/main/javadoc/overview.html
new file mode 100644
index 000000000..dcf59150c
--- /dev/null
+++ b/src/main/javadoc/overview.html
@@ -0,0 +1,7 @@
+<html>
+  <body>
+    
+    <p>This is the javadocs for modules produces by the SLF4J project.</p>
+    
+  </body>
+</html>