[P5P] [perl #116805] IO::Handle's error() method does not accurately reflect read errors

On Sun Feb 17 14:53:43 2013, tom christiansen wrote:
The documentation for IO::Handle reads:

$io->error
Returns a true value if the given handle has experienced any
errors
since it was opened or since the last call to "clearerr", or if
the
handle is invalid. It only returns false for a valid handle with
no
outstanding errors.

However, this is not true. For example, a failed read on a given
handle
can set errno to EAGAIN, yet fail to be noted by the error() method on
that
handle. This is shown by the enclosed test script, which is designed
to
trigger an error on the read. You can tell that there is a bug
because
it emits:

IMPOSSIBLE CASE #1: errno set but has_error clear

--tom