6341345: (spec) Console.reader() should make it clear that the reader requires line termination
authorsherman
Wed, 04 Sep 2013 12:35:22 -0700
changeset 19810 98b738773420
parent 19809 dc0480c1b36c
child 19811 8a5812fbba44
6341345: (spec) Console.reader() should make it clear that the reader requires line termination Summary: to clarify the spec Reviewed-by: alanb
jdk/src/share/classes/java/io/Console.java
--- 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
     */