6341345: (spec) Console.reader() should make it clear that the reader requires line termination
Summary: to clarify the spec
Reviewed-by: alanb
--- a/jdk/src/share/classes/java/io/Console.java Wed Sep 04 16:22:22 2013 +0200
+++ b/jdk/src/share/classes/java/io/Console.java Wed Sep 04 12:35:22 2013 -0700
@@ -124,9 +124,11 @@
* {@link java.io.Reader#read(java.nio.CharBuffer) read(java.nio.CharBuffer)}
* on the returned object will not read in characters beyond the line
* bound for each invocation, even if the destination buffer has space for
- * more characters. A line bound is considered to be any one of a line feed
- * (<tt>'\n'</tt>), a carriage return (<tt>'\r'</tt>), a carriage return
- * followed immediately by a linefeed, or an end of stream.
+ * 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 (<tt>'\n'</tt>),
+ * a carriage return (<tt>'\r'</tt>), a carriage return followed immediately
+ * by a linefeed, or an end of stream.
*
* @return The reader associated with this console
*/