JDK-8355319 : Update Manpage for Compact Object Headers (Production)
  • Type: Sub-task
  • Component: hotspot
  • Sub-Component: runtime
  • Affected Version: 25
  • Priority: P4
  • Status: Open
  • Resolution: Unresolved
  • OS: linux
  • Submitted: 2025-04-22
  • Updated: 2025-05-28
The Version table provides details related to the release that this issue/RFE will be addressed.

Unresolved : Release in which this issue/RFE will be addressed.
Resolved: Release in which this issue/RFE has been resolved.
Fixed : Release in which this issue/RFE has been fixed. The release containing this fix may be available for download as an Early Access Release or a General Availability Release.

To download the current JDK release, click here.
Other
tbdUnresolved
Description
The manpage sources need to be updated.

The section "Advanced Runtime Options for Java" should note the -XX:+UseCompactObjectHeaders option and that it improves Java heap memory usage: https://docs.oracle.com/en/java/javase/24/docs/specs/man/java.html#advanced-runtime-options-for-java

The sources are here (used to not be in the open repository): src/java.base/share/man/java.md

Since UseCompactObjectHeaders seems more useful than some of the other options in the list (except the JFR and NMT options), I think it should go first.

[~rkennke] Would you like to write the description to document the option?
Comments
A pull request was submitted for review. Branch: master URL: https://git.openjdk.org/jdk/pull/25491 Date: 2025-05-28 11:30:46 +0000
28-05-2025

Sure, I will do that.
27-05-2025

[~lfoltan] The manpage source is now in the open so can be updated by anyone.
22-04-2025