JDK-8350128 : Document the java.security.debug property in javadoc
  • Type: CSR
  • Component: security-libs
  • Sub-Component: java.security
  • Priority: P4
  • Status: Closed
  • Resolution: Approved
  • Fix Versions: 25
  • Submitted: 2025-02-14
  • Updated: 2025-04-29
  • Resolved: 2025-04-29
Related Reports
CSR :  
JDK-8328914 - Document the java.security.debug property in javadoc
Description
Summary
-------
java.security.debug is a widely used debug system property for JDK security libs. It's time to capture details about this property via javadoc.

Problem
-------
java.security.debug details are not captured via javadoc

Solution
--------

See Spec

Specification
-------------
Adding a new file debug-system-property.html in java.security/doc-files to document details on the java.security.debug property and link this new page from java.security/package.info file. We can start to use it to document common or standard system properties. See the attached snapshot of the new page for the specification of the property.
Comments
Moving to Approved.
29-04-2025
[~darcy] I confirm that it is a JDK specific property. We have added a link to this document from the `package-info` file in the `java/security` directory.
29-04-2025
Moving to Provisional, not Approved. [~kthirupattur] and [~mullan], I noticed java.security.debug is _not_ listed as a standard property in the specification of System.gretProperties. Please confirm this CSR which of JDK Scope and Java SE Scope this CSR is intended to have. What existing doc page(s) would link to the the one being proposed?
21-04-2025