RFR: 8299836: Make `user.timezone` system property searchable [v2]

[Justin Lu]

On Tue, 10 Jan 2023 01:50:45 GMT, Jaikiran Pai <jpai at openjdk.org> wrote:

>> Like Naoto notes, my understanding of it is that the `@systemProperty` should appear only once at the place where the semantics of that system property is being defined. This mail, which was sent when this tag was introduced, has more details https://mail.openjdk.org/pipermail/core-libs-dev/2018-November/056653.html.
>> 
>> I think using it here is fine, but you may want to check how it "reads" on the generated javadoc index page for system properties.
>
>> but you may want to check how it "reads" on the generated javadoc index page for system properties.
> 
> For clarity, I meant the page where you will see all the system properties - there's a "Index" on top of the javadoc API page https://docs.oracle.com/en/java/javase/19/docs/api/index.html which leads to a page which has a link to the "System Properties" page, which should lead to https://docs.oracle.com/en/java/javase/19/docs/api/system-properties.html

Hi Jai,

I read the article and have a better understanding of when _ at systemProperty_ should be used and the supporting features.

I wasn't aware such a [page](https://docs.oracle.com/en/java/javase/19/docs/api/system-properties.html) existed, I checked that _user.timezone_ was displayed and linked to _java.util.TimeZone.getDefault()_ properly.

Thanks for the help!

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

PR: https://git.openjdk.org/jdk/pull/11915