formatting consistency
Document the behavior of read/total timeouts

They are not the timeout for a complete response, they are
the timeout in between reads on the socket.