| Subject: | Documentation bug for read() |
The docs for the read() method says:
read returns one line from the input file. If there are no lines ready, it blocks until there are.
This is only true in scalar context, in list context it returns a list (of all pending lines?).