From a3b6565a77d36d798bf686dcbcd368718a1f00e8 Mon Sep 17 00:00:00 2001
From: Shai Almog <67850168+shai-almog@users.noreply.github.com>
Date: Tue, 13 Jan 2026 05:51:16 +0200
Subject: [PATCH 1/5] Run CI Javadocs with Java 25

---
 .github/workflows/pr.yml | 11 +++++++++--
 1 file changed, 9 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/pr.yml b/.github/workflows/pr.yml
index 4153e1455a..b77e8c523f 100644
--- a/.github/workflows/pr.yml
+++ b/.github/workflows/pr.yml
@@ -253,6 +253,13 @@ jobs:
         if: matrix.java-version == 8
         run: ant -noinput -buildfile CodenameOne/build.xml weeklyLibUpdate
 
+      - name: Set up Java 25 for JavaDocs
+        if: matrix.java-version == 8
+        uses: actions/setup-java@v4
+        with:
+          distribution: temurin
+          java-version: '25'
+
       - name: Build JavaDocs
         if: matrix.java-version == 8
         run: |
@@ -263,7 +270,8 @@ jobs:
           mkdir -p dist/javadoc
           # Skip JavaDocSourceEmbed due to gist access issues in CI
           cp -r src/* build/tempJavaSources/
-          find build/tempJavaSources ../Ports/CLDC11/src -name "*.java" | /usr/bin/grep -v /impl/ | /usr/bin/xargs javadoc --allow-script-in-comments -protected -d dist/javadoc -windowtitle "Codename One API" || true
+          # Suppress doclint noise on modern JDKs (e.g., Java 25) while keeping output consistent.
+          find build/tempJavaSources ../Ports/CLDC11/src -name "*.java" | /usr/bin/grep -v /impl/ | /usr/bin/xargs javadoc --allow-script-in-comments -Xdoclint:none -quiet -protected -d dist/javadoc -windowtitle "Codename One API" || true
           cd dist/javadoc
           zip -r ../../javadocs.zip *
           cd ..
@@ -339,4 +347,3 @@ jobs:
           name: JavaSE.jar
           path: Ports/JavaSE/dist/JavaSE.jar
   
-

From df27cacad1de4b9a08dd7a29e7a8163f605e421a Mon Sep 17 00:00:00 2001
From: Shai Almog <67850168+shai-almog@users.noreply.github.com>
Date: Tue, 13 Jan 2026 07:08:02 +0200
Subject: [PATCH 2/5] Run CI Javadocs with Java 25

---
 .github/workflows/pr.yml | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/.github/workflows/pr.yml b/.github/workflows/pr.yml
index b77e8c523f..017ebaab10 100644
--- a/.github/workflows/pr.yml
+++ b/.github/workflows/pr.yml
@@ -271,7 +271,8 @@ jobs:
           # Skip JavaDocSourceEmbed due to gist access issues in CI
           cp -r src/* build/tempJavaSources/
           # Suppress doclint noise on modern JDKs (e.g., Java 25) while keeping output consistent.
-          find build/tempJavaSources ../Ports/CLDC11/src -name "*.java" | /usr/bin/grep -v /impl/ | /usr/bin/xargs javadoc --allow-script-in-comments -Xdoclint:none -quiet -protected -d dist/javadoc -windowtitle "Codename One API" || true
+          # Patch java.base with CLDC11 stubs to avoid module conflicts for java.* packages.
+          find build/tempJavaSources ../Ports/CLDC11/src -name "*.java" | /usr/bin/grep -v /impl/ | /usr/bin/xargs javadoc --allow-script-in-comments --patch-module java.base=../Ports/CLDC11/src/java -Xdoclint:none -quiet -protected -d dist/javadoc -windowtitle "Codename One API" || true
           cd dist/javadoc
           zip -r ../../javadocs.zip *
           cd ..

From cc96d2a229dfaa276d4f28c874e4e8e7e8186b01 Mon Sep 17 00:00:00 2001
From: Shai Almog <67850168+shai-almog@users.noreply.github.com>
Date: Tue, 13 Jan 2026 07:22:43 +0200
Subject: [PATCH 3/5] Run CI Javadocs with Java 25

---
 .github/workflows/pr.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/pr.yml b/.github/workflows/pr.yml
index 017ebaab10..bb496f0d79 100644
--- a/.github/workflows/pr.yml
+++ b/.github/workflows/pr.yml
@@ -272,7 +272,7 @@ jobs:
           cp -r src/* build/tempJavaSources/
           # Suppress doclint noise on modern JDKs (e.g., Java 25) while keeping output consistent.
           # Patch java.base with CLDC11 stubs to avoid module conflicts for java.* packages.
-          find build/tempJavaSources ../Ports/CLDC11/src -name "*.java" | /usr/bin/grep -v /impl/ | /usr/bin/xargs javadoc --allow-script-in-comments --patch-module java.base=../Ports/CLDC11/src/java -Xdoclint:none -quiet -protected -d dist/javadoc -windowtitle "Codename One API" || true
+          find build/tempJavaSources ../Ports/CLDC11/src -name "*.java" | /usr/bin/xargs javadoc --allow-script-in-comments --patch-module java.base=../Ports/CLDC11/src/java -exclude com.codename1.impl -Xdoclint:none -quiet -protected -d dist/javadoc -windowtitle "Codename One API" || true
           cd dist/javadoc
           zip -r ../../javadocs.zip *
           cd ..

From 26e1110e8860eb2d0d04144eb4eb2abdf108bca6 Mon Sep 17 00:00:00 2001
From: Shai Almog <67850168+shai-almog@users.noreply.github.com>
Date: Tue, 13 Jan 2026 16:22:24 +0200
Subject: [PATCH 4/5] Run CI Javadocs with Java 25

---
 .github/workflows/pr.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/pr.yml b/.github/workflows/pr.yml
index bb496f0d79..dca79f5a68 100644
--- a/.github/workflows/pr.yml
+++ b/.github/workflows/pr.yml
@@ -272,7 +272,7 @@ jobs:
           cp -r src/* build/tempJavaSources/
           # Suppress doclint noise on modern JDKs (e.g., Java 25) while keeping output consistent.
           # Patch java.base with CLDC11 stubs to avoid module conflicts for java.* packages.
-          find build/tempJavaSources ../Ports/CLDC11/src -name "*.java" | /usr/bin/xargs javadoc --allow-script-in-comments --patch-module java.base=../Ports/CLDC11/src/java -exclude com.codename1.impl -Xdoclint:none -quiet -protected -d dist/javadoc -windowtitle "Codename One API" || true
+          { find build/tempJavaSources ../Ports/CLDC11/src -name "*.java"; echo ../Ports/JavaSE/src/com/codename1/impl/ImplementationFactory.java; } | /usr/bin/xargs javadoc --allow-script-in-comments --patch-module java.base=../Ports/CLDC11/src/java -exclude com.codename1.impl -Xdoclint:none -quiet -protected -d dist/javadoc -windowtitle "Codename One API" || true
           cd dist/javadoc
           zip -r ../../javadocs.zip *
           cd ..

From 4a157e8b80832cf2fef51f859f1ae3d99b865938 Mon Sep 17 00:00:00 2001
From: Shai Almog <67850168+shai-almog@users.noreply.github.com>
Date: Tue, 13 Jan 2026 19:02:27 +0200
Subject: [PATCH 5/5] Run CI Javadocs with Java 25

---
 .github/workflows/pr.yml | 16 +++++++++++++++-
 1 file changed, 15 insertions(+), 1 deletion(-)

diff --git a/.github/workflows/pr.yml b/.github/workflows/pr.yml
index dca79f5a68..ebddb7a25d 100644
--- a/.github/workflows/pr.yml
+++ b/.github/workflows/pr.yml
@@ -270,9 +270,23 @@ jobs:
           mkdir -p dist/javadoc
           # Skip JavaDocSourceEmbed due to gist access issues in CI
           cp -r src/* build/tempJavaSources/
+          # Provide a minimal ImplementationFactory stub for Javadoc type resolution on JDK 25.
+          cat > build/tempJavaSources/com/codename1/impl/ImplementationFactory.java <<'EOF'
+          package com.codename1.impl;
+
+          public class ImplementationFactory {
+              public static ImplementationFactory getInstance() {
+                  return null;
+              }
+
+              public Object createImplementation() {
+                  return null;
+              }
+          }
+          EOF
           # Suppress doclint noise on modern JDKs (e.g., Java 25) while keeping output consistent.
           # Patch java.base with CLDC11 stubs to avoid module conflicts for java.* packages.
-          { find build/tempJavaSources ../Ports/CLDC11/src -name "*.java"; echo ../Ports/JavaSE/src/com/codename1/impl/ImplementationFactory.java; } | /usr/bin/xargs javadoc --allow-script-in-comments --patch-module java.base=../Ports/CLDC11/src/java -exclude com.codename1.impl -Xdoclint:none -quiet -protected -d dist/javadoc -windowtitle "Codename One API" || true
+          find build/tempJavaSources ../Ports/CLDC11/src -name "*.java" | /usr/bin/xargs javadoc --allow-script-in-comments --patch-module java.base=../Ports/CLDC11/src/java -exclude com.codename1.impl -Xdoclint:none -quiet -protected -d dist/javadoc -windowtitle "Codename One API" || true
           cd dist/javadoc
           zip -r ../../javadocs.zip *
           cd ..