* Read and write operations are synchronized to guarantee the atomic * completion of critical operations; therefore invoking methods @@ -56,17 +56,17 @@ * on the objects returned by {@link #reader()} and {@link #writer()} may * block in multithreaded scenarios. *
- * Invoking close() on the objects returned by the {@link #reader()} + * Invoking {@code close()} on the objects returned by the {@link #reader()} * and the {@link #writer()} will not close the underlying stream of those * objects. *
- * The console-read methods return null when the end of the + * The console-read methods return {@code null} when the end of the * console input stream is reached, for example by typing control-D on * Unix or control-Z on Windows. Subsequent read operations will succeed * if additional characters are later entered on the console's input * device. *
- * Unless otherwise specified, passing a null argument to any method + * Unless otherwise specified, passing a {@code null} argument to any method * in this class will cause a {@link NullPointerException} to be thrown. *
* Security note: @@ -107,7 +107,7 @@ *
* This method is intended to be used by sophisticated applications, for * example, a {@link java.util.Scanner} object which utilizes the rich - * parsing/scanning functionality provided by the Scanner: + * parsing/scanning functionality provided by the {@code Scanner}: *
* Console con = System.console();
* if (con != null) {
@@ -117,7 +117,7 @@
*
* For simple applications requiring only line-oriented reading, use
- * {@link #readLine}.
+ * {@link #readLine}.
*
* The bulk read operations {@link java.io.Reader#read(char[]) read(char[]) }, * {@link java.io.Reader#read(char[], int, int) read(char[], int, int) } and @@ -126,8 +126,8 @@ * bound for each invocation, even if the destination buffer has space for * more characters. The {@code Reader}'s {@code read} methods may block if a * line bound has not been entered or reached on the console's input device. - * A line bound is considered to be any one of a line feed ('\n'), - * a carriage return ('\r'), a carriage return followed immediately + * A line bound is considered to be any one of a line feed ({@code '\n'}), + * a carriage return ({@code '\r'}), a carriage return followed immediately * by a linefeed, or an end of stream. * * @return The reader associated with this console @@ -152,7 +152,7 @@ * limited by the maximum dimension of a Java array as defined by * The Java™ Virtual Machine Specification. * The behaviour on a - * null argument depends on the conversion. * * @throws IllegalFormatException @@ -175,8 +175,9 @@ * A convenience method to write a formatted string to this console's * output stream using the specified format string and arguments. * - *
An invocation of this method of the form con.printf(format, - * args) behaves in exactly the same way as the invocation of + *
An invocation of this method of the form + * {@code con.printf(format, args)} behaves in exactly the same way + * as the invocation of *
con.format(format, args). * * @param format @@ -191,7 +192,7 @@ * limited by the maximum dimension of a Java array as defined by * The Java™ Virtual Machine Specification. * The behaviour on a - * null argument depends on the conversion. * * @throws IllegalFormatException @@ -237,7 +238,7 @@ * If an I/O error occurs. * * @return A string containing the line read from the console, not - * including any line-termination characters, or null + * including any line-termination characters, or {@code null} * if an end of stream has been reached. */ public String readLine(String fmt, Object ... args) { @@ -265,7 +266,7 @@ * If an I/O error occurs. * * @return A string containing the line read from the console, not - * including any line-termination characters, or null + * including any line-termination characters, or {@code null} * if an end of stream has been reached. */ public String readLine() { @@ -302,7 +303,7 @@ * * @return A character array containing the password or passphrase read * from the console, not including any line-termination characters, - * or null if an end of stream has been reached. + * or {@code null} if an end of stream has been reached. */ public char[] readPassword(String fmt, Object ... args) { char[] passwd = null; @@ -346,7 +347,7 @@ * * @return A character array containing the password or passphrase read * from the console, not including any line-termination characters, - * or null if an end of stream has been reached. + * or {@code null} if an end of stream has been reached. */ public char[] readPassword() { return readPassword("");