Attach JavaDoc sources to all deployed artifacts with any Java code

Author: steve-s

org.graalvm.python.gradle.plugin/build.gradle

@@ -30,6 +30,14 @@ java {
     sourceCompatibility = JavaVersion.VERSION_17
     targetCompatibility = JavaVersion.VERSION_17
     withSourcesJar()
+    withJavadocJar()
+}
+
+tasks.withType(Javadoc).configureEach {
+    failOnError = false
+    options.addBooleanOption('Xdoclint:none', true)
+    options.addBooleanOption('quiet', true)
+    options.encoding = 'UTF-8'
 }
 
 sourceSets.main.java.srcDirs += ['../org.graalvm.python.embedding.tools/src/main/java']

pom.xml

@@ -261,17 +261,10 @@
           <artifactId>maven-surefire-plugin</artifactId>
           <version>3.5.3</version>
         </plugin>
-        <!-- by default no JavaDoc linting, we override this in modules that provide public API -->
         <plugin>
           <groupId>org.apache.maven.plugins</groupId>
           <artifactId>maven-javadoc-plugin</artifactId>
           <version>3.11.2</version>
-          <configuration>
-            <failOnError>false</failOnError>
-            <additionalJOptions>
-              <additionalJOption>-Xdoclint:none</additionalJOption>
-            </additionalJOptions>
-          </configuration>
         </plugin>
       </plugins>
     </pluginManagement>
@@ -327,6 +320,25 @@
           </execution>
         </executions>
       </plugin>
+      <!-- by default no JavaDoc linting, we override this in modules that provide public API -->
+      <plugin>
+        <groupId>org.apache.maven.plugins</groupId>
+        <artifactId>maven-javadoc-plugin</artifactId>
+        <configuration>
+          <failOnError>false</failOnError>
+          <additionalJOptions>
+            <additionalJOption>-Xdoclint:none</additionalJOption>
+          </additionalJOptions>
+        </configuration>
+        <executions>
+          <execution>
+            <id>attach-javadocs</id>
+            <goals>
+              <goal>jar</goal>
+            </goals>
+          </execution>
+        </executions>
+      </plugin>
       <plugin>
         <!-- prevent installation of the parent pom, intentionally not inherited by submodules -->
         <groupId>org.apache.maven.plugins</groupId>