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

[Koushik Muthukrishnan Thirupattur]

On Wed, 19 Feb 2025 22:39:21 GMT, Sean Mullan <mullan 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.

Created here [8350384](https://bugs.openjdk.org/browse/JDK-8350384)

> > The name and title should not be "Security Properties". This is about the debug system property.
> 
> Yes, this is because "Security Properties" are different than system properties, and are listed in the `java.security` file. We may want to someday also add them to this file, but not now. So, I would change it to "Security System Properties" or maybe "Security-Related System Properties"

Changed.

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

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