ICU-12739 Fixed some API doc issues and eased doclint option with Java 8.

X-SVN-Rev: 39290

diff --git a/icu4j/build.xml b/icu4j/build.xml
index a2f789b85ac169f489de1a9e234e929b873e7d80..329790cfce032faf1a61c7f9b9779ed857029367 100644 (file)
--- a/icu4j/build.xml
+++ b/icu4j/build.xml
@@ -917,7 +917,7 @@
 
     <target name="_docsLintOption" unless="doclint.options">
         <!-- syntax check is disabled because JCite tag name "@.jcite" is invalidated -->
-        <condition property="doclint.option" value="-Xdoclint:all,-accessibility,-syntax" else="">
+        <condition property="doclint.option" value="-Xdoclint:reference,html" else="">
             <isset property="is.java8.plus"/>
         </condition>
     </target>

diff --git a/icu4j/main/classes/core/src/com/ibm/icu/text/BidiTransform.java b/icu4j/main/classes/core/src/com/ibm/icu/text/BidiTransform.java
index 656f29cdb9d4d7b26602c844ae75b2f58642361e..692aa6a54b4f2018a13a68df21706ea02b41331c 100644 (file)
--- a/icu4j/main/classes/core/src/com/ibm/icu/text/BidiTransform.java
+++ b/icu4j/main/classes/core/src/com/ibm/icu/text/BidiTransform.java
@@ -175,7 +175,7 @@ public class BidiTransform
      * <li>{Logical LTR, Visual RTL},</li>\r
      * <li>{Visual RTL, Logical RTL}.</li>\r
      * </ul>\r
-     * <p>Example of usage of the transformation engine:<br>\r
+     * <p>Example of usage of the transformation engine:</p>\r
      * <pre>\r
      * BidiTransform bidiTransform = new BidiTransform();\r
      * String in = "abc \u06f0123"; // "abc \\u06f0123"\r
@@ -197,7 +197,6 @@ public class BidiTransform
      *          ArabicShaping.DIGITS_EN2AN | ArabicShaping.DIGIT_TYPE_AN_EXTENDED);\r
      * // Result: "abc \\u06f4\\u06f1\\u06f2\\u06f3"\r
      * </pre>\r
-     * </p>\r
      *\r
      * @param text An input character sequence that the Bidi layout\r
      *        transformations will be performed on.\r

diff --git a/icu4j/main/classes/core/src/com/ibm/icu/text/DecimalFormatSymbols.java b/icu4j/main/classes/core/src/com/ibm/icu/text/DecimalFormatSymbols.java
index 7bd446ec9c558c0daff5559da9762e1289a37a7a..b769256325addd9dabbc509d868825bc6a053c13 100644 (file)
--- a/icu4j/main/classes/core/src/com/ibm/icu/text/DecimalFormatSymbols.java
+++ b/icu4j/main/classes/core/src/com/ibm/icu/text/DecimalFormatSymbols.java
@@ -185,7 +185,7 @@ public class DecimalFormatSymbols implements Cloneable, Serializable {
     /**
      * Sets the character used for zero.
      * <p>
-     * <b>Note:</p> When the specified zeroDigit is a Unicode decimal digit character
+     * <b>Note:</b> When the specified zeroDigit is a Unicode decimal digit character
      * (category:Nd) and the number value is 0, then this method propagate digit 1 to
      * digit 9 by incrementing code point one by one.
      *

diff --git a/icu4j/main/classes/core/src/com/ibm/icu/text/SpoofChecker.java b/icu4j/main/classes/core/src/com/ibm/icu/text/SpoofChecker.java
index a7ad518105ac07e7697355056e097d296438e79c..a80ba9efebfc330cd898aad41c1e9932b0f491a0 100644 (file)
--- a/icu4j/main/classes/core/src/com/ibm/icu/text/SpoofChecker.java
+++ b/icu4j/main/classes/core/src/com/ibm/icu/text/SpoofChecker.java
@@ -98,7 +98,6 @@ import com.ibm.icu.util.ULocale;
  * shown below:
  *
  * <pre>
- * <code>
  * // Setup:
  * String[] DICTIONARY = new String[]{ "lorem", "ipsum" }; // example
  * SpoofChecker sc = new SpoofChecker.Builder().setChecks(SpoofChecker.CONFUSABLE).build();
@@ -110,7 +109,6 @@ import com.ibm.icu.util.ULocale;
  * // Live Check:
  * boolean result = skeletons.contains(sc.getSkeleton("1orern"));
  * System.out.println(result);  // true
- * </code>
  * </pre>
  *
  * <p>
@@ -124,7 +122,6 @@ import com.ibm.icu.util.ULocale;
  * The following snippet shows a minimal example of using <code>SpoofChecker</code> to perform spoof detection on a
  * string:
  *
- * <code>
  * <pre>
  * SpoofChecker sc = new SpoofChecker.Builder()
  *     .setAllowedChars(SpoofChecker.RECOMMENDED.cloneAsThawed().addAll(SpoofChecker.INCLUSION))
@@ -134,7 +131,6 @@ import com.ibm.icu.util.ULocale;
  * boolean result = sc.failsChecks("pаypаl");  // with Cyrillic 'а' characters
  * System.out.println(result);  // true
  * </pre>
- * </code>
  *
  * <p>
  * As in the case for confusability checking, it is good practice to create one <code>SpoofChecker</code> instance at