remove debugs
Improve docs
Catch EOFError which have unknown causes; we can usually just retry when this happens.