Skip to content

Enable Javadoc doclint errors#2799

Draft
8Keep wants to merge 1 commit into
jMonkeyEngine:masterfrom
8Keep:javadoc-doclint-errors
Draft

Enable Javadoc doclint errors#2799
8Keep wants to merge 1 commit into
jMonkeyEngine:masterfrom
8Keep:javadoc-doclint-errors

Conversation

@8Keep
Copy link
Copy Markdown
Contributor

@8Keep 8Keep commented May 23, 2026

Summary

  • fail Javadoc tasks on doclint errors by removing the global doclint suppression and failOnError override
  • remove module-local doclint suppressions for terrain, lwjgl3, and saferallocator
  • fix the doclint errors exposed in core Javadocs and exclude generated libjglios native-image glue from iOS examples Javadocs

@github-actions
Copy link
Copy Markdown

🖼️ Screenshot tests have failed.

The purpose of these tests is to ensure that changes introduced in this PR don't break visual features. They are visual unit tests.

📄 Where to find the report:

⚠️ If you didn't expect to change anything visual:
Fix your changes so the screenshot tests pass.

If you did mean to change things:
Review the replacement images in jme3-screenshot-tests/build/changed-images to make sure they really are improvements and then replace and commit the replacement images at jme3-screenshot-tests/src/test/resources.

If you are creating entirely new tests:
Find the new images in jme3-screenshot-tests/build/changed-images and commit the new images at jme3-screenshot-tests/src/test/resources.

Note; it is very important that the committed reference images are created on the build pipeline, locally created images are not reliable. Similarly tests will fail locally but you can look at the report to check they are "visually similar".

See https://github.com/jMonkeyEngine/jmonkeyengine/blob/master/jme3-screenshot-tests/README.md for more information

Contact @richardTingle (aka richtea) for guidance if required

Copy link
Copy Markdown
Contributor

@gemini-code-assist gemini-code-assist Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request focuses on improving Javadoc quality and consistency across the project. Key changes include fixing malformed HTML tags, updating parameter descriptions to match method signatures, and removing Javadoc error suppression in Gradle build files to enforce stricter documentation standards. A review comment identifies a grammatical improvement in BlendSpace.java, suggesting the use of "between" instead of "among" when referring to exactly two actions.

Comment thread jme3-core/src/main/java/com/jme3/anim/tween/action/BlendSpace.java
@8Keep 8Keep force-pushed the javadoc-doclint-errors branch from 43c48d4 to b6f51ca Compare May 23, 2026 18:41
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant