Add Highlight.js to Maven Javadoc and remove BUILDING.md note

[shai-almog]

Motivation

• Ensure generated Javadoc includes client-side syntax highlighting for code samples by injecting a lightweight highlighter into the Maven Javadoc output.
• Remove the previously added explanatory note from BUILDING.md to restore the prior documentation state.

Description

• Updated maven/pom.xml maven-javadoc-plugin configuration to add a <bottom> block that injects Highlight.js CSS/JS and initializes highlighting for pre code elements using hljs.highlightElement.
• Kept the --allow-script-in-comments additionalOption to permit the injected script to run in generated Javadoc pages.
• Reverted BUILDING.md to its prior content and removed the JavaDoc syntax-highlighting note.

Testing

• No automated tests were run for these configuration and documentation changes.
• The BUILDING.md content was inspected to confirm the revert was applied successfully.

---

Codex Task

[github-actions]

✅ Continuous Quality Report

Test & Coverage

• ✅ Tests: 2292 total, 0 failed, 0 skipped
• 📊 Line coverage: 52.79% [HTML preview] [Download]
  • Lowest covered classes
    • com.codename1.io.rest.RequestBuilder$FetchAsPropertyListActionListener – 0.00%
    • com.codename1.io.rest.RequestBuilder$FetchAsPropertiesActionListener – 0.00%
    • com.codename1.ui.Display$EdtException – 0.00%
    • com.codename1.ui.BrowserWindow$BrowserForm – 0.00%
    • com.codename1.ui.plaf.CSSBorder$LinearGradient – 0.00%
    • com.codename1.io.rest.RequestBuilder$GetAsStringAsyncImplActionListener – 0.00%
    • com.codename1.io.rest.RequestBuilder$GetAsJsonMapActionListener – 0.00%
    • com.codename1.payment.Purchase$SynchronizeReceiptsSyncRunnable – 0.00%
    • com.codename1.io.rest.RequestBuilder$GetAsBytesAsyncImplActionListener – 0.00%
    • com.codename1.io.rest.RequestBuilder$FetchAsJsonMapActionListener – 0.00%

Static Analysis

• SpotBugs [HTML preview] [Download]
  • ❌ ByteCodeTranslator: 122 findings (High: 6, Normal: 84, Low: 32)
    • Top findings
      • High: com/codename1/tools/translator/ByteCodeTranslator.java:579 – Found reliance on default encoding in com.codename1.tools.translator.ByteCodeTranslator.writeCmakeProject(File, File, String): new java.io.FileWriter(File) (rule: DM_DEFAULT_ENCODING)
      • High: com/codename1/tools/translator/ByteCodeTranslator.java:660 – Found reliance on default encoding in com.codename1.tools.translator.ByteCodeTranslator.readFileAsStringBuilder(File): new String(byte[]) (rule: DM_DEFAULT_ENCODING)
      • High: com/codename1/tools/translator/ByteCodeTranslator.java:690 – Found reliance on default encoding in com.codename1.tools.translator.ByteCodeTranslator.replaceInFile(File, String[]): new java.io.FileWriter(File) (rule: DM_DEFAULT_ENCODING)
      • …and 119 more
  • ❌ android: 425 findings (High: 37, Normal: 196, Low: 192)
    • Top findings
      • High: CodenameOne/src/com/codename1/impl/CodenameOneThread.java:48 – com.codename1.impl.CodenameOneThread.STACK_FRAME_SIZE isn't final but should be (rule: MS_SHOULD_BE_FINAL)
      • High: com/codename1/impl/android/AndroidImplementation.java:1065 – Write to static field com.codename1.impl.android.AndroidImplementation.context from instance method com.codename1.impl.android.AndroidImplementation.setContext(Context) (rule: ST_WRITE_TO_STATIC_FROM_INSTANCE_METHOD)
      • High: com/codename1/impl/android/AndroidImplementation.java:1266 – com.codename1.impl.android.AndroidImplementation.isDarkMode() has Boolean return type and returns explicit null (rule: NP_BOOLEAN_RETURN_NULL)
      • …and 422 more
  • ❌ codenameone-maven-plugin: 533 findings (High: 36, Normal: 325, Low: 172)
    • Top findings
      • High: com/codename1/builders/AndroidGradleBuilder.java:1553 – Found reliance on default encoding in com.codename1.builders.AndroidGradleBuilder.build(File, BuildRequest): String.getBytes() (rule: DM_DEFAULT_ENCODING)
      • High: com/codename1/builders/AndroidGradleBuilder.java:1983 – Found reliance on default encoding in com.codename1.builders.AndroidGradleBuilder.build(File, BuildRequest): new java.io.FileReader(File) (rule: DM_DEFAULT_ENCODING)
      • High: com/codename1/builders/AndroidGradleBuilder.java:3990 – Found reliance on default encoding in com.codename1.builders.AndroidGradleBuilder.extract(InputStream, File, String): String.getBytes() (rule: DM_DEFAULT_ENCODING)
      • …and 530 more
  • ✅ core-unittests: 0 findings (no issues)
  • ❌ ios: 126 findings (High: 5, Normal: 75, Low: 46)
    • Top findings
      • High: com/codename1/impl/ios/IOSImplementation.java:1218 – com.codename1.impl.ios.IOSImplementation.isDarkMode() has Boolean return type and returns explicit null (rule: NP_BOOLEAN_RETURN_NULL)
      • High: com/codename1/impl/ios/IOSImplementation.java:127 – com.codename1.impl.ios.IOSImplementation.nativeInstance isn't final but should be (rule: MS_SHOULD_BE_FINAL)
      • High: com/codename1/impl/ios/IOSImplementation.java:212 – Write to static field com.codename1.impl.ios.IOSImplementation.instance from instance method com.codename1.impl.ios.IOSImplementation.init(Object) (rule: ST_WRITE_TO_STATIC_FROM_INSTANCE_METHOD)
      • …and 123 more
• ✅ PMD: 0 findings (no issues) [Report archive]
• ❌ Checkstyle: 33 findings (Error: 33) [HTML preview] [Download]
  • Top findings
    • Error: CodenameOne/src/com/codename1/ui/Image.java:429:9 – Line contains a tab character. (rule: FileTabCharacterCheck)
    • Error: CodenameOne/src/com/codename1/ui/Image.java:430:9 – Line contains a tab character. (rule: FileTabCharacterCheck)
    • Error: CodenameOne/src/com/codename1/ui/Image.java:431:9 – Line contains a tab character. (rule: FileTabCharacterCheck)
    • Error: CodenameOne/src/com/codename1/ui/Image.java:432:9 – Line contains a tab character. (rule: FileTabCharacterCheck)
    • Error: CodenameOne/src/com/codename1/ui/Image.java:433:9 – Line contains a tab character. (rule: FileTabCharacterCheck)
    • …and 28 more

Generated automatically by the PR CI workflow.

[shai-almog]

Compared 30 screenshots: 30 matched.

Native Android coverage

• 📊 Line coverage: 7.14% (3622/50725 lines covered) [HTML preview] (artifact android-coverage-report, jacocoAndroidReport/html/index.html)
  • Other counters: instruction 5.57% (17791/319446), branch 2.72% (844/31079), complexity 3.32% (985/29700), method 5.83% (806/13829), class 9.52% (174/1827)
  • Lowest covered classes
    • kotlin.collections.kotlin.collections.ArraysKt___ArraysKt – 0.00% (0/6327 lines covered)
    • kotlin.collections.unsigned.kotlin.collections.unsigned.UArraysKt___UArraysKt – 0.00% (0/2384 lines covered)
    • org.jacoco.agent.rt.internal_b6258fc.asm.org.jacoco.agent.rt.internal_b6258fc.asm.ClassReader – 0.00% (0/1519 lines covered)
    • kotlin.collections.kotlin.collections.CollectionsKt___CollectionsKt – 0.00% (0/1148 lines covered)
    • org.jacoco.agent.rt.internal_b6258fc.asm.org.jacoco.agent.rt.internal_b6258fc.asm.MethodWriter – 0.00% (0/923 lines covered)
    • kotlin.sequences.kotlin.sequences.SequencesKt___SequencesKt – 0.00% (0/712 lines covered)
    • kotlin.text.kotlin.text.StringsKt___StringsKt – 0.00% (0/623 lines covered)
    • org.jacoco.agent.rt.internal_b6258fc.asm.org.jacoco.agent.rt.internal_b6258fc.asm.Frame – 0.00% (0/564 lines covered)
    • kotlin.collections.kotlin.collections.ArraysKt___ArraysJvmKt – 0.00% (0/495 lines covered)
    • kotlinx.coroutines.kotlinx.coroutines.JobSupport – 0.00% (0/423 lines covered)

✅ Native Android screenshot tests passed.

Native Android coverage

• 📊 Line coverage: 7.14% (3622/50725 lines covered) [HTML preview] (artifact android-coverage-report, jacocoAndroidReport/html/index.html)
  • Other counters: instruction 5.57% (17791/319446), branch 2.72% (844/31079), complexity 3.32% (985/29700), method 5.83% (806/13829), class 9.52% (174/1827)
  • Lowest covered classes
    • kotlin.collections.kotlin.collections.ArraysKt___ArraysKt – 0.00% (0/6327 lines covered)
    • kotlin.collections.unsigned.kotlin.collections.unsigned.UArraysKt___UArraysKt – 0.00% (0/2384 lines covered)
    • org.jacoco.agent.rt.internal_b6258fc.asm.org.jacoco.agent.rt.internal_b6258fc.asm.ClassReader – 0.00% (0/1519 lines covered)
    • kotlin.collections.kotlin.collections.CollectionsKt___CollectionsKt – 0.00% (0/1148 lines covered)
    • org.jacoco.agent.rt.internal_b6258fc.asm.org.jacoco.agent.rt.internal_b6258fc.asm.MethodWriter – 0.00% (0/923 lines covered)
    • kotlin.sequences.kotlin.sequences.SequencesKt___SequencesKt – 0.00% (0/712 lines covered)
    • kotlin.text.kotlin.text.StringsKt___StringsKt – 0.00% (0/623 lines covered)
    • org.jacoco.agent.rt.internal_b6258fc.asm.org.jacoco.agent.rt.internal_b6258fc.asm.Frame – 0.00% (0/564 lines covered)
    • kotlin.collections.kotlin.collections.ArraysKt___ArraysJvmKt – 0.00% (0/495 lines covered)
    • kotlinx.coroutines.kotlinx.coroutines.JobSupport – 0.00% (0/423 lines covered)

[shai-almog]

Compared 30 screenshots: 30 matched.
✅ Native Android screenshot tests passed.

Benchmark Results

• VM Translation Time: 354 seconds
• Compilation Time: 268 seconds

Detailed Performance Metrics

Metric	Duration
Build Time Statistics
Setup & Unzip	31071 ms
Extract Extensions	21 ms
Google Services Setup	2 ms
Scan Classes	558 ms
Extract Libs	1326 ms
Inject Build Hints	31 ms
Generate Unit Tests	2 ms
Generate Stubs	1128 ms
Compile Stubs	2537 ms
Generate Icons	1489 ms
Prepare ParparVM	219 ms
ParparVM Execution	186208 ms
Post-VM Setup	179 ms
CocoaPods	5632 ms
Finalize	21 ms
Total Time	230425 msMaven Overhead : 124000 ms
CocoaPods Install (Script)	1000 ms
Simulator Boot	256000 ms
Simulator Boot (Run)	3000 ms
App Install	17000 ms
App Launch	42000 ms
Test Execution	166000 ms