You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Java 25's Javadoc no longer picks up legacy package.html files, so package-level documentation must be provided as package-info.java to be included in modern Javadoc output.
Preserve the existing package documentation and any leading license/header comments for many packages across the repository so API docs remain complete.
Cover the main code areas that ship Javadoc: core CodenameOne sources plus CodenameOneDesigner and the Ports/J2ME packages.
Description
Added generated package-info.java files (64 files created) under CodenameOne/src, CodenameOneDesigner/src and Ports/J2ME/src to replace/represent the prior package.html content.
The generator converts package.html content into a Javadoc-style /** ... */ comment block and, when present, preserves preamble HTML license comments as a /* ... */ block at the top of the file.
Each generated file ends with the appropriate package <pkg.name>; declaration inferred from the file path so the docs are attached to the correct package.
Testing
Executed a local generation script which produced 64 package-info.java files and verified the script completed successfully.
Spot-checked several generated files including CodenameOne/src/com/codename1/ui/package-info.java and CodenameOne/src/com/codename1/javascript/package-info.java to confirm the Javadoc block, preserved license header, and package declaration are present.
No unit tests or CI Javadoc build were run as part of this change; this is a documentation-source change intended to enable upstream Javadoc runs with Java 25.
Preview info: JPEG preview quality 10; JPEG preview quality 10; downscaled to 844x1835. Full-resolution PNG saved as graphics-draw-gradient.png in workflow artifacts.
graphics-draw-round-rect — missing reference. Reference screenshot missing at /Users/runner/work/CodenameOne/CodenameOne/scripts/ios/screenshots/graphics-draw-round-rect.png.
Preview info: JPEG preview quality 10; JPEG preview quality 10; downscaled to 844x1835. Full-resolution PNG saved as graphics-draw-round-rect.png in workflow artifacts.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Motivation
package.htmlfiles, so package-level documentation must be provided aspackage-info.javato be included in modern Javadoc output.Description
package-info.javafiles (64 files created) underCodenameOne/src,CodenameOneDesigner/srcandPorts/J2ME/srcto replace/represent the priorpackage.htmlcontent.package.htmlcontent into a Javadoc-style/** ... */comment block and, when present, preserves preamble HTML license comments as a/* ... */block at the top of the file.package <pkg.name>;declaration inferred from the file path so the docs are attached to the correct package.Testing
package-info.javafiles and verified the script completed successfully.CodenameOne/src/com/codename1/ui/package-info.javaandCodenameOne/src/com/codename1/javascript/package-info.javato confirm the Javadoc block, preserved license header, andpackagedeclaration are present.Codex Task