comments
note on read return value inconsistency