<i18n dev> RFR: 8303275: Use {@Return and @linkplain in Locale and related classes [v2]

[Justin Lu]

On Thu, 2 Mar 2023 16:43:47 GMT, Naoto Sato <naoto at openjdk.org> wrote:

>> Justin Lu has updated the pull request incrementally with one additional commit since the last revision:
>> 
>>   Remove prefix Locale for in-class linkplains
>
> src/java.base/share/classes/java/util/Locale.java line 2075:
> 
>> 2073:      * user. This will be the values returned by getDisplayLanguage(),
>> 2074:      * getDisplayScript(), getDisplayCountry(), getDisplayVariant() and
>> 2075:      * optional {@linkplain Locale##def_locale_extension Unicode extensions}
> 
> Can `Locale` be removed? It seems redundant. There are other locations with the same situation in this class.

Yes, removed this and the other instances of `@linkplain` that use the _Locale_ prefix. I left the ones in `Locale.Builder` and `Locale.LanguageRange` since they are generated with different html pages and need the _Locale_ link.

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

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