RFR: 8328914: Document the java.security.debug property in javadoc [v2]

[Sean Mullan]

On Fri, 14 Feb 2025 19:12:51 GMT, Koushik Muthukrishnan Thirupattur <duke at openjdk.org> wrote:

>> 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.
>> 
>> ![image](https://github.com/user-attachments/assets/2c58dd82-363e-49be-9734-755d5d0014d7)
>> 
>> NOTE : We are adding a new html file (similar to the Networking Properties [here](https://download.java.net/java/early_access/jdk25/docs/api/java.base/java/net/doc-files/net-properties.html#networking-properties-heading)) for documenting security-related properties, and over time, we will add more properties to this page.
>
> Koushik Muthukrishnan Thirupattur has updated the pull request incrementally with one additional commit since the last revision:
> 
>   8328914: Document the java.security.debug property in javadoc

src/java.base/share/classes/java/security/doc-files/security-properties.html line 60:

> 58:     the <a href="../../lang/System.html#setProperty(java.lang.String,java.lang.String)">System.setProperty()</a> API.
> 59:     The purpose of this document is to list
> 60:     and detail all of these properties.

I would remove this last sentence. Although that is an eventual goal, it may not happen right away, so best to not give someone the impression that this is the only security related system property.

-------------

PR Review Comment: https://git.openjdk.org/jdk/pull/23569#discussion_r1962479350