src/java.base/share/classes/sun/text/bidi/BidiBase.java

@@ -79,18 +79,17 @@
  * shaping (ArabicShaping) classes can be used at the core of such "Storage
  * Layout Engines".
  *
  * <h3>General remarks about the API:</h3>
  *
- * The &quot;limit&quot; of a sequence of characters is the position just after
+ * The "limit" of a sequence of characters is the position just after
  * their last character, i.e., one more than that position.
  * <p>
  *
- * Some of the API methods provide access to &quot;runs&quot;. Such a
- * &quot;run&quot; is defined as a sequence of characters that are at the same
+ * Some of the API methods provide access to "runs". Such a
+ * "run" is defined as a sequence of characters that are at the same
  * embedding level after performing the Bidi algorithm.
- * <p>
  *
  * <h3>Basic concept: paragraph</h3>
  * A piece of text can be divided into several paragraphs by characters
  * with the Bidi class <code>Block Separator</code>. For handling of
  * paragraphs, see:

@@ -139,11 +138,12 @@
  * and the one for <code>LEVEL_DEFAULT_RTL</code> is odd,
  * just like with normal LTR and RTL level values -
  * these special values are designed that way. Also, the implementation
  * assumes that MAX_EXPLICIT_LEVEL is odd.
  *
- * <ul><b>See Also:</b>
+ * <p><b>See Also:</b>
+ * <ul>
  * <li>{@link #LEVEL_DEFAULT_LTR}
  * <li>{@link #LEVEL_DEFAULT_RTL}
  * <li>{@link #LEVEL_OVERRIDE}
  * <li>{@link #MAX_EXPLICIT_LEVEL}
  * <li>{@link #setPara}

@@ -151,11 +151,12 @@
  *
  * <h3>Basic concept: Reordering Mode</h3>
  * Reordering mode values indicate which variant of the Bidi algorithm to
  * use.
  *
- * <ul><b>See Also:</b>
+ * <p><b>See Also:</b>
+ * <ul>
  * <li>{@link #setReorderingMode}
  * <li>{@link #REORDER_DEFAULT}
  * <li>{@link #REORDER_NUMBERS_SPECIAL}
  * <li>{@link #REORDER_GROUP_NUMBERS_WITH_R}
  * <li>{@link #REORDER_RUNS_ONLY}

@@ -164,11 +165,12 @@
  * <li>{@link #REORDER_INVERSE_FOR_NUMBERS_SPECIAL}
  * </ul>
  *
  * <h3>Basic concept: Reordering Options</h3>
  * Reordering options can be applied during Bidi text transformations.
- * <ul><b>See Also:</b>
+ * <p><b>See Also:</b>
+ * <ul>
  * <li>{@link #setReorderingOptions}
  * <li>{@link #OPTION_DEFAULT}
  * <li>{@link #OPTION_INSERT_MARKS}
  * <li>{@link #OPTION_REMOVE_CONTROLS}
  * <li>{@link #OPTION_STREAMING}

@@ -200,11 +202,11 @@
  * (code units) in logical order.</li>
  * <li>The line-breaking algorithm is very complicated and Locale-dependent -
  * and therefore its implementation omitted from this sample code.</li>
  * </ul>
  *
- * <pre>
+ * <pre>{@code
  *
  *  package com.ibm.icu.dev.test.bidi;
  *
  *  import com.ibm.icu.text.Bidi;
  *  import com.ibm.icu.text.BidiRun;

@@ -449,11 +451,11 @@
  *          renderParagraph("Some Latin text...", Bidi.LTR, null, 0, 80);
  *          renderParagraph("Some Hebrew text...", Bidi.RTL, null, 0, 60);
  *      }
  *  }
  *
- * </pre>
+ * }</pre>
  */
 
 public class BidiBase {
 
     class Point {

@@ -2417,13 +2419,13 @@
      *        override levels, ignoring characters like LRE and PDF in the text.
      *        A level overrides the directional property of its corresponding
      *        (same index) character if the level has the
      *        <code>LEVEL_OVERRIDE</code> bit set.<br><br>
      *        Except for that bit, it must be
-     *        <code>paraLevel<=embeddingLevels[]<=MAX_EXPLICIT_LEVEL</code>,
+     *        {@code paraLevel<=embeddingLevels[]<=MAX_EXPLICIT_LEVEL},
      *        with one exception: a level of zero may be specified for a
-     *        paragraph separator even if <code>paraLevel&gt;0</code> when multiple
+     *        paragraph separator even if {@code paraLevel > 0} when multiple
      *        paragraphs are submitted in the same call to <code>setPara()</code>.<br><br>
      *        <strong>Caution: </strong>A reference to this array, not a copy
      *        of the levels, will be stored in the <code>Bidi</code> object;
      *        the <code>embeddingLevels</code>
      *        should not be modified to avoid unexpected results on subsequent

@@ -2678,11 +2680,11 @@
      * i.e., some levels may not be the same as if all steps were performed.
      * This is not relevant for unidirectional text.<br>
      * For example, in pure LTR text with numbers the numbers would get
      * a resolved level of 2 higher than the surrounding text according to
      * the algorithm. This implementation may set all resolved levels to
-     * the same value in such a case.<p>
+     * the same value in such a case.
      *
      * @param paragraph a paragraph of text with optional character and
      *        paragraph attribute information
      * @stable ICU 3.8
      */

@@ -2815,11 +2817,11 @@
         verifyValidParaOrLine();
         return paraLevel;
     }
 
     /**
-     * Get the index of a paragraph, given a position within the text.<p>
+     * Get the index of a paragraph, given a position within the text.
      *
      * @param charIndex is the index of a character within the text, in the
      *        range <code>[0..getProcessedLength()-1]</code>.
      *
      * @return The index of the paragraph containing the specified position,