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

[Sean Mullan]

On Tue, 25 Feb 2025 22:35:56 GMT, Sean Mullan <mullan at openjdk.org> wrote:

>> This was the title recommended by Sean above as we want to initially create this file for security related system properties. We are going to be adding more to it later as needed like he mentioned but for now we will just have the debug. Let me know if this still needs a more suitable title.
>
> Ok, so I don't like "Security-Related System Property" because you would not need a title like that for one property. The overall intent of this document is to use it as a place to document more system properties, but if we have no immediate plans to do that within the JDK 25 timeframe, then maybe a more specific title like what Weijun is suggesting is more appropriate.
> 
> There are many other security related system properties which are worth documenting but more of them are in the TLS and Kerberos areas, which are in different packages or modules. I'm not sure if we need different html pages for each of those areas. I was really hoping we would have one page for all security library areas.
> 
> Let me think about this more first.

Ok, so for now, since we are only documenting one property I think it makes sense (as Weijun suggested) to change the title of this to "The java.security.debug system property". Remove the paragraph starting with "There are several system properties ..."

As a followup, let's open another issue to add the JSSE system properties to this file, and then it can become more of what was originally intended. So think of this as a temporary title.

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

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