Improving timeout behavior and documentation

See #392 
isn't that done by libcurl anyways?