RFR: 8311968: Clarify Three-letter time zone IDs in java.util.TimeZone [v2]

[Justin Lu]

On Thu, 13 Jul 2023 20:21:57 GMT, Justin Lu <jlu at openjdk.org> wrote:

>> src/java.base/share/classes/java/util/TimeZone.java line 135:
>> 
>>> 133:  * recognize one of them. The full list of the deprecated IDs and their mappings
>>> 134:  * can be viewed at {@link java.time.ZoneId#SHORT_IDS}. It should be noted that
>>> 135:  * not all three-letter time zone IDs are deprecated, as some come from the IANA
>> 
>> This is a bit confusing at least to me as I did not see which SHORT_IDS were not deprecated via the link above, but perhaps I missed it.
>
> I see your point, the intent was that there exists three-letter time zone IDs and only the deprecated ones were at `SHORT_IDS`. I have updated the wording to explicitly clarify this.

Please disregard the previous message, I talked with Naoto and all the three-letter time zone IDs (and four-letter) are deprecated regardless if they are from the JDK or TZDB, so I will readjust the wording again

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

PR Review Comment: https://git.openjdk.org/jdk/pull/14861#discussion_r1263059906