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

[Sean Mullan]

On Thu, 10 Apr 2025 05:09:52 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/b8a589d1-691e-4fb6-bb18-5890c73cb37d)
>> 
>> 
>> 
>> 
>> 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-related-system-properties.html line 53:

> 51: <H1 style="text-align:center">The java.security.debug system property</H1>
> 52: <a id="security.debug"></a>
> 53: <H2>Debug</H2>

I would remove these 2 headings ("The java.security.debug system property" and "Debug"), as they are not needed since right now this document is only about one property and the title says the name of the property. If we add more system properties in the future, we can add more subsections.

src/java.base/share/classes/java/security/package-info.java line 1:

> 1: /*

Update copyright date.

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

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