diff -r a7f16447085e -r 48e480e56aad src/java.base/share/classes/java/text/RuleBasedCollator.java
--- a/src/java.base/share/classes/java/text/RuleBasedCollator.java Tue Sep 24 10:04:13 2019 +0000
+++ b/src/java.base/share/classes/java/text/RuleBasedCollator.java Tue Sep 24 09:43:43 2019 +0100
@@ -43,14 +43,14 @@
import java.util.Locale;
/**
- * The RuleBasedCollator
class is a concrete subclass of
- * Collator
that provides a simple, data-driven, table
+ * The {@code RuleBasedCollator} class is a concrete subclass of
+ * {@code Collator} that provides a simple, data-driven, table
* collator. With this class you can create a customized table-based
- * Collator
. RuleBasedCollator
maps
+ * {@code Collator}. {@code RuleBasedCollator} maps
* characters to sort keys.
*
*
- * RuleBasedCollator
has the following restrictions
+ * {@code RuleBasedCollator} has the following restrictions
* for efficiency (other subclasses may be used for more complex languages) :
*
b c
is treated as bc
.
+ * are ignored; e.g. {@code b c} is treated as {@code bc}.
* Normalization and Accents *
- * RuleBasedCollator
automatically processes its rule table to
+ * {@code RuleBasedCollator} automatically processes its rule table to
* include both pre-composed and combining-character versions of
* accented characters. Even if the provided rule string contains only
* base characters and separate combining accent characters, the pre-composed
@@ -175,8 +175,8 @@
* text-argument) is not already in the sequence.
* (e.g. "a < b & e < f")
*
RuleBasedCollator
throws
- * a ParseException
.
+ * If you produce one of these errors, a {@code RuleBasedCollator} throws
+ * a {@code ParseException}.
*
* Examples *
Simple: "< a < b < c < d" @@ -191,9 +191,9 @@ * aa, AA" * *
- * To create a RuleBasedCollator
object with specialized
- * rules tailored to your needs, you construct the RuleBasedCollator
- * with the rules contained in a String
object. For example:
+ * To create a {@code RuleBasedCollator} object with specialized
+ * rules tailored to your needs, you construct the {@code RuleBasedCollator}
+ * with the rules contained in a {@code String} object. For example:
*
** String simple = "< a< b< c< d"; @@ -218,7 +218,7 @@ ** A new collation rules string can be created by concatenating rules * strings. For example, the rules returned by {@link #getRules()} could - * be concatenated to combine multiple
RuleBasedCollator
s. + * be concatenated to combine multiple {@code RuleBasedCollator}s. * ** The following example demonstrates how to change the order of @@ -350,7 +350,7 @@ * than, greater than or equal to another string in a language. * This can be overridden in a subclass. * - * @throws NullPointerException if
source
ortarget
is null. + * @throws NullPointerException if {@code source} or {@code target} is null. */ public synchronized int compare(String source, String target) {