explicitly clarify that reading also stops after size-1 bytes
Convert EXAMPLES to IDIOMS and make it a simple select -> poll
conversion along with commentary.  A more comprehensive sample
conversion is needed too.  OK deraadt@