JDK-8302708 : Release Note: The `MetaspaceReclaimPolicy` Flag has Been Obsoleted
  • Type: Sub-task
  • Component: hotspot
  • Sub-Component: runtime
  • Affected Version: 21
  • Priority: P4
  • Status: Resolved
  • Resolution: Delivered
  • Submitted: 2023-02-17
  • Updated: 2023-08-18
  • Resolved: 2023-07-12
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.
JDK 21
21Resolved
Related Reports
Relates :  
JDK-8302385 - Remove MetaspaceReclaimPolicy=none
Description
The option `MetaspaceReclaimPolicy` existed to fine-tune the memory reclamation behavior of metaspace after class unloading. In practice, this had limited effect and was rarely used. 

The option has therefore been obsoleted. It now produces an obsolete warning and is ignored.
Comments
Given this flag was never documented on the Java manpage I'm not sure it really needs a RN when it is obsoleted - that said it was documented in the JEP so a case can be made.
13-07-2023
I'm quite sure writing a Release Note was not my idea, but I was asked to do so by someone at Oracle. I have to dig through my mail and the GH comment history. I can scrap this RN if that is preferred.
13-07-2023
The association of this RN with JDK-8302385 left me very confused. We are not noting the removal of the "none" policy we are documenting the obsoletion of the flag - so I would have created this as a sub-task of JDK-8306696. Suggested changes Title: The MetaspaceReclaimPolicy Flag has Been Obsoleted In the text reference JEP 387 - as that was AFAICS the only place this flag was documented. It doesn't appear to ever have been added to the Java command reference.
13-07-2023
Thank you Coleen!
12-07-2023
> The option has therefore been obsoleted. It now produces an obsolete warning and is ignored. Maybe shorten it to: The option now produces an obsolete warning and is ignored. I think then you can "Resolve" it as "Delivered"
12-07-2023
Can you change it to "in practice, this had limited effect and was rarely used". Also, "It now produces an obsolete warning and is ignored". Seems a bit more direct. Thanks for doing this RN.
10-07-2023
[~coleenp] could you review this RN, please? Thank you!
09-07-2023
FYI here is the release note process in case you have any questions: https://openjdk.org/guide/index.html#release-notes
21-02-2023