--- a/src/java.base/share/classes/java/util/spi/LocaleNameProvider.java Tue Sep 24 10:04:13 2019 +0000
+++ b/src/java.base/share/classes/java/util/spi/LocaleNameProvider.java Tue Sep 24 09:43:43 2019 +0100
@@ -48,10 +48,10 @@
* Returns a localized name for the given <a href="http://www.rfc-editor.org/rfc/bcp/bcp47.txt">
* IETF BCP47</a> language code and the given locale that is appropriate for
* display to the user.
- * For example, if <code>languageCode</code> is "fr" and <code>locale</code>
- * is en_US, getDisplayLanguage() will return "French"; if <code>languageCode</code>
- * is "en" and <code>locale</code> is fr_FR, getDisplayLanguage() will return "anglais".
- * If the name returned cannot be localized according to <code>locale</code>,
+ * For example, if {@code languageCode} is "fr" and {@code locale}
+ * is en_US, getDisplayLanguage() will return "French"; if {@code languageCode}
+ * is "en" and {@code locale} is fr_FR, getDisplayLanguage() will return "anglais".
+ * If the name returned cannot be localized according to {@code locale},
* (say, the provider does not have a Japanese name for Croatian),
* this method returns null.
* @param languageCode the language code string in the form of two to eight
@@ -59,9 +59,9 @@
* @param locale the desired locale
* @return the name of the given language code for the specified locale, or null if it's not
* available.
- * @throws NullPointerException if <code>languageCode</code> or <code>locale</code> is null
- * @throws IllegalArgumentException if <code>languageCode</code> is not in the form of
- * two or three lower-case letters, or <code>locale</code> isn't
+ * @throws NullPointerException if {@code languageCode} or {@code locale} is null
+ * @throws IllegalArgumentException if {@code languageCode} is not in the form of
+ * two or three lower-case letters, or {@code locale} isn't
* one of the locales returned from
* {@link java.util.spi.LocaleServiceProvider#getAvailableLocales()
* getAvailableLocales()}.
@@ -73,10 +73,10 @@
* Returns a localized name for the given <a href="http://www.rfc-editor.org/rfc/bcp/bcp47.txt">
* IETF BCP47</a> script code and the given locale that is appropriate for
* display to the user.
- * For example, if <code>scriptCode</code> is "Latn" and <code>locale</code>
- * is en_US, getDisplayScript() will return "Latin"; if <code>scriptCode</code>
- * is "Cyrl" and <code>locale</code> is fr_FR, getDisplayScript() will return "cyrillique".
- * If the name returned cannot be localized according to <code>locale</code>,
+ * For example, if {@code scriptCode} is "Latn" and {@code locale}
+ * is en_US, getDisplayScript() will return "Latin"; if {@code scriptCode}
+ * is "Cyrl" and {@code locale} is fr_FR, getDisplayScript() will return "cyrillique".
+ * If the name returned cannot be localized according to {@code locale},
* (say, the provider does not have a Japanese name for Cyrillic),
* this method returns null. The default implementation returns null.
* @param scriptCode the four letter script code string in the form of title-case
@@ -86,9 +86,9 @@
* @param locale the desired locale
* @return the name of the given script code for the specified locale, or null if it's not
* available.
- * @throws NullPointerException if <code>scriptCode</code> or <code>locale</code> is null
- * @throws IllegalArgumentException if <code>scriptCode</code> is not in the form of
- * four title case letters, or <code>locale</code> isn't
+ * @throws NullPointerException if {@code scriptCode} or {@code locale} is null
+ * @throws IllegalArgumentException if {@code scriptCode} is not in the form of
+ * four title case letters, or {@code locale} isn't
* one of the locales returned from
* {@link java.util.spi.LocaleServiceProvider#getAvailableLocales()
* getAvailableLocales()}.
@@ -103,10 +103,10 @@
* Returns a localized name for the given <a href="http://www.rfc-editor.org/rfc/bcp/bcp47.txt">
* IETF BCP47</a> region code (either ISO 3166 country code or UN M.49 area
* codes) and the given locale that is appropriate for display to the user.
- * For example, if <code>countryCode</code> is "FR" and <code>locale</code>
- * is en_US, getDisplayCountry() will return "France"; if <code>countryCode</code>
- * is "US" and <code>locale</code> is fr_FR, getDisplayCountry() will return "Etats-Unis".
- * If the name returned cannot be localized according to <code>locale</code>,
+ * For example, if {@code countryCode} is "FR" and {@code locale}
+ * is en_US, getDisplayCountry() will return "France"; if {@code countryCode}
+ * is "US" and {@code locale} is fr_FR, getDisplayCountry() will return "Etats-Unis".
+ * If the name returned cannot be localized according to {@code locale},
* (say, the provider does not have a Japanese name for Croatia),
* this method returns null.
* @param countryCode the country(region) code string in the form of two
@@ -115,9 +115,9 @@
* @param locale the desired locale
* @return the name of the given country code for the specified locale, or null if it's not
* available.
- * @throws NullPointerException if <code>countryCode</code> or <code>locale</code> is null
- * @throws IllegalArgumentException if <code>countryCode</code> is not in the form of
- * two upper-case letters or three digit letters, or <code>locale</code> isn't
+ * @throws NullPointerException if {@code countryCode} or {@code locale} is null
+ * @throws IllegalArgumentException if {@code countryCode} is not in the form of
+ * two upper-case letters or three digit letters, or {@code locale} isn't
* one of the locales returned from
* {@link java.util.spi.LocaleServiceProvider#getAvailableLocales()
* getAvailableLocales()}.
@@ -128,14 +128,14 @@
/**
* Returns a localized name for the given variant code and the given locale that
* is appropriate for display to the user.
- * If the name returned cannot be localized according to <code>locale</code>,
+ * If the name returned cannot be localized according to {@code locale},
* this method returns null.
* @param variant the variant string
* @param locale the desired locale
* @return the name of the given variant string for the specified locale, or null if it's not
* available.
- * @throws NullPointerException if <code>variant</code> or <code>locale</code> is null
- * @throws IllegalArgumentException if <code>locale</code> isn't
+ * @throws NullPointerException if {@code variant} or {@code locale} is null
+ * @throws IllegalArgumentException if {@code locale} isn't
* one of the locales returned from
* {@link java.util.spi.LocaleServiceProvider#getAvailableLocales()
* getAvailableLocales()}.