A few issues with the specification of java.io.Console has been identified:

- It's not specified whether Console uses stdin and stdout or something else
- It doesn't specify when clients might want to call flush()
- The sentence on effects of close() on Console.reader() and Console.writer() is vague
- readLine and readPassword don't specify that null is returned if end of input is reached *without having transferred any characters*
- There's no information on system console capabilities in case of redirection
- There's no information on availability of system console depending on how JVM is started
- The definition of isTerminal() needs to be clarified