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

[Sean Mullan]

On Fri, 14 Feb 2025 19:16:41 GMT, Weijun Wang <weijun at openjdk.org> wrote:

> Also, now we have the same content in 3 places:
> 
>     1. Here
> 
>     2. In the Security Guide at https://docs.oracle.com/en/java/javase/23/security/troubleshooting-security.html#GUID-05F3E865-20FF-46EB-AC35-84D4B552CA48
> 
>     3. At https://github.com/openjdk/jdk/blob/940aa7c4cf1bf770690660c8bb21fb3ddc5186e4/src/java.base/share/classes/sun/security/util/Debug.java#L85
>        .
>        Do we need to keep all of them? @seanjmullan

Well, I still find #3 valuable as it is useful as a command-line help option.

For #2, we don't need the duplication, but I think it is useful to still have a pointer from the guides to this new html file, so @koushikthirupattur please file a subtask (in the docs/guides category) to have the section in the security guide link to this new properties file in the javadoc.

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

PR Comment: https://git.openjdk.org/jdk/pull/23569#issuecomment-2669921633