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

[Sean Mullan]

On Tue, 15 Apr 2025 07:50:00 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.
>> 
>> <img width="1183" alt="image" src="https://github.com/user-attachments/assets/4aa9d5e7-0886-4943-8ba3-707ca774675c" />
>> 
>> 
>> 
>> 
>> 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 with a new target base due to a merge or a rebase. The incremental webrev excludes the unrelated changes brought in by the merge/rebase. The pull request contains 22 additional commits since the last revision:
> 
>  - 8328914: Document the java.security.debug property in javadoc
>  - Merge branch 'master' into 8328914
>  - 8328914: Document the java.security.debug property in javadoc
>  - 8328914: Document the java.security.debug property in javadoc
>  - 8328914: Document the java.security.debug property in javadoc
>  - 8328914: Document the java.security.debug property in javadoc
>  - 8328914: Document the java.security.debug property in javadoc
>  - 8328914: Document the java.security.debug property in javadoc
>  - 8328914: Document the java.security.debug property in javadoc
>  - 8328914: Document the java.security.debug property in javadoc
>  - ... and 12 more: https://git.openjdk.org/jdk/compare/42e78a27...dc7f34fa

src/java.base/share/classes/java/security/doc-files/debug-system-property.html line 58:

> 56: </p>
> 57: 
> 58: <H1>Printing Thread and Timestamp Information</H1>

I would keep this heading as H3, it looks too large as H1.

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

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