diff -r 22badc53802f -r bf24e33c7919 jdk/src/java.base/share/classes/java/lang/Appendable.java --- a/jdk/src/java.base/share/classes/java/lang/Appendable.java Wed Aug 05 12:19:38 2015 -0700 +++ b/jdk/src/java.base/share/classes/java/lang/Appendable.java Thu Aug 06 13:20:13 2015 +0300 @@ -28,15 +28,15 @@ import java.io.IOException; /** - * An object to which char sequences and values can be appended. The - * Appendable interface must be implemented by any class whose + * An object to which {@code char} sequences and values can be appended. The + * {@code Appendable} interface must be implemented by any class whose * instances are intended to receive formatted output from a {@link * java.util.Formatter}. * *

The characters to be appended should be valid Unicode characters as * described in Unicode Character * Representation. Note that supplementary characters may be composed of - * multiple 16-bit char values. + * multiple 16-bit {@code char} values. * *

Appendables are not necessarily safe for multithreaded access. Thread * safety is the responsibility of classes that extend and implement this @@ -51,19 +51,19 @@ public interface Appendable { /** - * Appends the specified character sequence to this Appendable. + * Appends the specified character sequence to this {@code Appendable}. * *

Depending on which class implements the character sequence - * csq, the entire sequence may not be appended. For - * instance, if csq is a {@link java.nio.CharBuffer} then + * {@code csq}, the entire sequence may not be appended. For + * instance, if {@code csq} is a {@link java.nio.CharBuffer} then * the subsequence to append is defined by the buffer's position and limit. * * @param csq - * The character sequence to append. If csq is - * null, then the four characters "null" are + * The character sequence to append. If {@code csq} is + * {@code null}, then the four characters {@code "null"} are * appended to this Appendable. * - * @return A reference to this Appendable + * @return A reference to this {@code Appendable} * * @throws IOException * If an I/O error occurs @@ -72,10 +72,10 @@ /** * Appends a subsequence of the specified character sequence to this - * Appendable. + * {@code Appendable}. * - *

An invocation of this method of the form out.append(csq, start, - * end) when csq is not null, behaves in + *

An invocation of this method of the form {@code out.append(csq, start, end)} + * when {@code csq} is not {@code null}, behaves in * exactly the same way as the invocation * *

@@ -83,9 +83,9 @@
      *
      * @param  csq
      *         The character sequence from which a subsequence will be
-     *         appended.  If csq is null, then characters
-     *         will be appended as if csq contained the four
-     *         characters "null".
+     *         appended.  If {@code csq} is {@code null}, then characters
+     *         will be appended as if {@code csq} contained the four
+     *         characters {@code "null"}.
      *
      * @param  start
      *         The index of the first character in the subsequence
@@ -94,12 +94,12 @@
      *         The index of the character following the last character in the
      *         subsequence
      *
-     * @return  A reference to this Appendable
+     * @return  A reference to this {@code Appendable}
      *
      * @throws  IndexOutOfBoundsException
-     *          If start or end are negative, start
-     *          is greater than end, or end is greater than
-     *          csq.length()
+     *          If {@code start} or {@code end} are negative, {@code start}
+     *          is greater than {@code end}, or {@code end} is greater than
+     *          {@code csq.length()}
      *
      * @throws  IOException
      *          If an I/O error occurs
@@ -107,12 +107,12 @@
     Appendable append(CharSequence csq, int start, int end) throws IOException;
 
     /**
-     * Appends the specified character to this Appendable.
+     * Appends the specified character to this {@code Appendable}.
      *
      * @param  c
      *         The character to append
      *
-     * @return  A reference to this Appendable
+     * @return  A reference to this {@code Appendable}
      *
      * @throws  IOException
      *          If an I/O error occurs