From f4cd34c16ddc9dbff82a2b7ecc43e386d7ca11d7 Mon Sep 17 00:00:00 2001
From: Norman Maurer <norman_maurer@apple.com>
Date: Fri, 23 Aug 2024 10:48:31 +0200
Subject: [PATCH] Ensure we generate javadocs for all artifacts (#881)

Motivation:

We need to generate javadocs for all artifacts that we publish as
otherwise the release process will fail

Modifications:

Generate empty javadocs jars when needed

Result:

Release process does not fail anymore
---
 boringssl-static/pom.xml | 21 +++++++++++++++++++++
 libressl-static/pom.xml  | 19 +++++++++++++++++++
 openssl-dynamic/pom.xml  | 19 +++++++++++++++++++
 openssl-static/pom.xml   | 19 +++++++++++++++++++
 4 files changed, 78 insertions(+)

diff --git a/boringssl-static/pom.xml b/boringssl-static/pom.xml
index 0ba6d49f..f5e63b2d 100644
--- a/boringssl-static/pom.xml
+++ b/boringssl-static/pom.xml
@@ -45,6 +45,27 @@
         </plugin>
       </plugins>
     </pluginManagement>
+
+    <plugins>
+      <!-- We must generate a -javadoc JAR file to publish on Maven Central -->
+      <plugin>
+        <groupId>org.apache.maven.plugins</groupId>
+        <artifactId>maven-jar-plugin</artifactId>
+        <executions>
+          <execution>
+            <id>empty-javadoc-jar</id>
+            <phase>package</phase>
+            <goals>
+              <goal>jar</goal>
+            </goals>
+            <configuration>
+              <classifier>javadoc</classifier>
+              <classesDirectory>${basedir}/javadoc</classesDirectory>
+            </configuration>
+          </execution>
+        </executions>
+      </plugin>
+    </plugins>
   </build>
 
   <properties>
diff --git a/libressl-static/pom.xml b/libressl-static/pom.xml
index 30f71423..0dc2c9ea 100644
--- a/libressl-static/pom.xml
+++ b/libressl-static/pom.xml
@@ -195,6 +195,25 @@
           </execution>
         </executions>
       </plugin>
+
+      <!-- We must generate a -javadoc JAR file to publish on Maven Central -->
+      <plugin>
+        <groupId>org.apache.maven.plugins</groupId>
+        <artifactId>maven-jar-plugin</artifactId>
+        <executions>
+          <execution>
+            <id>empty-javadoc-jar</id>
+            <phase>package</phase>
+            <goals>
+              <goal>jar</goal>
+            </goals>
+            <configuration>
+              <classifier>javadoc</classifier>
+              <classesDirectory>${basedir}/javadoc</classesDirectory>
+            </configuration>
+          </execution>
+        </executions>
+      </plugin>
     </plugins>
   </build>
 
diff --git a/openssl-dynamic/pom.xml b/openssl-dynamic/pom.xml
index c76b5e67..dab587d8 100644
--- a/openssl-dynamic/pom.xml
+++ b/openssl-dynamic/pom.xml
@@ -152,6 +152,25 @@
           </execution>
         </executions>
       </plugin>
+
+      <!-- We must generate a -javadoc JAR file to publish on Maven Central -->
+      <plugin>
+        <groupId>org.apache.maven.plugins</groupId>
+        <artifactId>maven-jar-plugin</artifactId>
+        <executions>
+          <execution>
+            <id>empty-javadoc-jar</id>
+            <phase>package</phase>
+            <goals>
+              <goal>jar</goal>
+            </goals>
+            <configuration>
+              <classifier>javadoc</classifier>
+              <classesDirectory>${basedir}/javadoc</classesDirectory>
+            </configuration>
+          </execution>
+        </executions>
+      </plugin>
     </plugins>
   </build>
 
diff --git a/openssl-static/pom.xml b/openssl-static/pom.xml
index fb6b0fdb..cc3dbe1c 100644
--- a/openssl-static/pom.xml
+++ b/openssl-static/pom.xml
@@ -189,6 +189,25 @@
           </execution>
         </executions>
       </plugin>
+
+      <!-- We must generate a -javadoc JAR file to publish on Maven Central -->
+      <plugin>
+        <groupId>org.apache.maven.plugins</groupId>
+        <artifactId>maven-jar-plugin</artifactId>
+        <executions>
+          <execution>
+            <id>empty-javadoc-jar</id>
+            <phase>package</phase>
+            <goals>
+              <goal>jar</goal>
+            </goals>
+            <configuration>
+              <classifier>javadoc</classifier>
+              <classesDirectory>${basedir}/javadoc</classesDirectory>
+            </configuration>
+          </execution>
+        </executions>
+      </plugin>
     </plugins>
   </build>