From e618c3a8df7a01a2f91dbdb8f4e5af0a23c64169 Mon Sep 17 00:00:00 2001
From: Valera V Harseko <vharseko@3a-systems.ru>
Date: Tue, 29 Sep 2026 13:11:16 +0300
Subject: [PATCH] Link Groovy javadoc through a local package-list instead of
 fetching it

The javadoc <link> to docs.groovy-lang.org/latest made every build
download the Groovy element-list/package-list at javadoc time. The
"latest" docs no longer serve package-list, so any transient miss on
element-list failed attach-javadocs, which kept turning random
build-maven matrix cells red.

- Drop the link from the framework modules: none of them expose Groovy
  types in their public API.
- In bundles-parent, replace it with an offlineLink backed by a
  committed package-list, pointing at the Groovy version the build
  actually uses (2.4.21) rather than "latest".
---
 OpenICF-java-framework/bundles-parent/pom.xml | 28 ++++--
 .../src/javadoc/groovy-2.4.21/package-list    | 95 +++++++++++++++++++
 OpenICF-java-framework/pom.xml                |  5 +-
 3 files changed, 116 insertions(+), 12 deletions(-)
 create mode 100644 OpenICF-java-framework/bundles-parent/src/javadoc/groovy-2.4.21/package-list

diff --git a/OpenICF-java-framework/bundles-parent/pom.xml b/OpenICF-java-framework/bundles-parent/pom.xml
index 614090499..e9118bf53 100644
--- a/OpenICF-java-framework/bundles-parent/pom.xml
+++ b/OpenICF-java-framework/bundles-parent/pom.xml
@@ -21,7 +21,7 @@
  with the fields enclosed by brackets [] replaced by
  your own identifying information:
  "Portions Copyrighted [year] [name of copyright owner]"
-  Portions Copyrighted 2024 3A Systems, LLC
+  Portions Copyrighted 2024-2026 3A Systems, LLC
 -->
 <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
     <modelVersion>4.0.0</modelVersion>
@@ -60,6 +60,13 @@
         <testConfigurations>default</testConfigurations>
         <privateConfigPath>${user.home}/.connectors/${project.artifactId}-${project.version}/config</privateConfigPath>
 
+        <!--
+            Local copy of the Groovy API package-list, so javadoc links to Groovy without fetching it
+            over the network. Resolved from each connector module, all of which sit next to
+            OpenICF-java-framework. Refresh the file when the Groovy version changes.
+        -->
+        <groovyJavadocPackageList>${project.basedir}/../OpenICF-java-framework/bundles-parent/src/javadoc/groovy-2.4.21</groovyJavadocPackageList>
+
         <!-- OSGi Properties -->
         <openicf.osgi.exclude.dependencies>false</openicf.osgi.exclude.dependencies>
         <project.framework.version>${framework.compatibilityVersion}.${framework.releaseVersion}</project.framework.version>
@@ -180,10 +187,12 @@
                     <groupId>org.apache.maven.plugins</groupId>
                     <artifactId>maven-javadoc-plugin</artifactId>
                     <configuration>
-                        <links>
-                            <link>https://docs.groovy-lang.org/latest/html/api/</link>
-<!--                            <link>http://openicf.forgerock.org/apidocs/</link>-->
-                        </links>
+                        <offlineLinks>
+                            <offlineLink>
+                                <url>https://docs.groovy-lang.org/2.4.21/html/api/</url>
+                                <location>${groovyJavadocPackageList}</location>
+                            </offlineLink>
+                        </offlineLinks>
                     </configuration>
                 </plugin>
                 <plugin>
@@ -327,9 +336,12 @@
                 <groupId>org.apache.maven.plugins</groupId>
                 <artifactId>maven-javadoc-plugin</artifactId>
                 <configuration>
-                    <links>
-                        <link>https://docs.groovy-lang.org/latest/html/api/</link>
-                    </links>
+                    <offlineLinks>
+                        <offlineLink>
+                            <url>https://docs.groovy-lang.org/2.4.21/html/api/</url>
+                            <location>${groovyJavadocPackageList}</location>
+                        </offlineLink>
+                    </offlineLinks>
                 </configuration>
             </plugin>
         </plugins>
diff --git a/OpenICF-java-framework/bundles-parent/src/javadoc/groovy-2.4.21/package-list b/OpenICF-java-framework/bundles-parent/src/javadoc/groovy-2.4.21/package-list
new file mode 100644
index 000000000..2af302de1
--- /dev/null
+++ b/OpenICF-java-framework/bundles-parent/src/javadoc/groovy-2.4.21/package-list
@@ -0,0 +1,95 @@
+groovy.beans
+groovy.grape
+groovy.inspect
+groovy.inspect.swingui
+groovy.io
+groovy.jmx.builder
+groovy.json
+groovy.json.internal
+groovy.lang
+groovy.mock.interceptor
+groovy.model
+groovy.security
+groovy.servlet
+groovy.sql
+groovy.swing.binding
+groovy.swing.impl
+groovy.test
+groovy.text
+groovy.text.markup
+groovy.time
+groovy.transform
+groovy.transform.builder
+groovy.transform.stc
+groovy.ui
+groovy.ui.text
+groovy.util
+groovy.util.logging
+groovy.util.slurpersupport
+groovy.xml
+groovy.xml.dom
+groovy.xml.streamingmarkupsupport
+org.apache.commons.cli
+org.apache.groovy.io
+org.apache.groovy.util
+org.codehaus.groovy
+org.codehaus.groovy.ant
+org.codehaus.groovy.antlr
+org.codehaus.groovy.antlr.java
+org.codehaus.groovy.antlr.parser
+org.codehaus.groovy.antlr.treewalker
+org.codehaus.groovy.ast
+org.codehaus.groovy.ast.builder
+org.codehaus.groovy.ast.expr
+org.codehaus.groovy.ast.stmt
+org.codehaus.groovy.ast.tools
+org.codehaus.groovy.binding
+org.codehaus.groovy.bsf
+org.codehaus.groovy.classgen
+org.codehaus.groovy.classgen.asm
+org.codehaus.groovy.classgen.asm.indy
+org.codehaus.groovy.classgen.asm.sc
+org.codehaus.groovy.cli
+org.codehaus.groovy.control
+org.codehaus.groovy.control.customizers
+org.codehaus.groovy.control.customizers.builder
+org.codehaus.groovy.control.io
+org.codehaus.groovy.control.messages
+org.codehaus.groovy.groovydoc
+org.codehaus.groovy.jsr223
+org.codehaus.groovy.plugin
+org.codehaus.groovy.reflection
+org.codehaus.groovy.reflection.android
+org.codehaus.groovy.reflection.stdclasses
+org.codehaus.groovy.reflection.v7
+org.codehaus.groovy.runtime
+org.codehaus.groovy.runtime.callsite
+org.codehaus.groovy.runtime.dgmimpl
+org.codehaus.groovy.runtime.dgmimpl.arrays
+org.codehaus.groovy.runtime.m12n
+org.codehaus.groovy.runtime.memoize
+org.codehaus.groovy.runtime.metaclass
+org.codehaus.groovy.runtime.powerassert
+org.codehaus.groovy.runtime.typehandling
+org.codehaus.groovy.runtime.wrappers
+org.codehaus.groovy.syntax
+org.codehaus.groovy.testng
+org.codehaus.groovy.tools
+org.codehaus.groovy.tools.groovydoc
+org.codehaus.groovy.tools.groovydoc.gstringTemplates
+org.codehaus.groovy.tools.gse
+org.codehaus.groovy.tools.javac
+org.codehaus.groovy.tools.shell
+org.codehaus.groovy.tools.shell.util
+org.codehaus.groovy.tools.xml
+org.codehaus.groovy.transform
+org.codehaus.groovy.transform.sc
+org.codehaus.groovy.transform.sc.transformers
+org.codehaus.groovy.transform.stc
+org.codehaus.groovy.transform.trait
+org.codehaus.groovy.util
+org.codehaus.groovy.vmplugin
+org.codehaus.groovy.vmplugin.v5
+org.codehaus.groovy.vmplugin.v6
+org.codehaus.groovy.vmplugin.v7
+org.codehaus.groovy.vmplugin.v8
diff --git a/OpenICF-java-framework/pom.xml b/OpenICF-java-framework/pom.xml
index dd8312dd9..344463688 100644
--- a/OpenICF-java-framework/pom.xml
+++ b/OpenICF-java-framework/pom.xml
@@ -22,7 +22,7 @@
  your own identifying information:
  "Portions Copyrighted [year] [name of copyright owner]"
 
- Portions Copyrighted 2018-2025 3A Systems, LLC
+ Portions Copyrighted 2018-2026 3A Systems, LLC
 -->
 <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
     <modelVersion>4.0.0</modelVersion>
@@ -151,9 +151,6 @@
                         <docfilessubdirs>true</docfilessubdirs>
                         <source>${maven.compiler.source}</source>
                         <show>public</show>
-                        <links>
-                            <link>https://docs.groovy-lang.org/latest/html/api/</link>
-                        </links>
                     </configuration>
                     <executions>
                         <execution>