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

[Michael McMahon]

On Wed, 19 Feb 2025 23:27:19 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/bf8bb8bf-a63b-4b14-9790-783fa8c9c080)
>> 
>> 
>> 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 two additional commits since the last revision:
> 
>  - 8328914: Document the java.security.debug property in javadoc
>  - 8328914: Document the java.security.debug property in javadoc

As a regular user of the property, this change is a great idea. I think the text accompanying the table should describe the syntax of the property value. Is it a comma separated list etc?

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

PR Review: https://git.openjdk.org/jdk/pull/23569#pullrequestreview-2629963339