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