Deprecates iostream transport `readsome` in favor of `read_some`

which is more consistent with the naming of the rest of the library.
adds documentation notes about when fatal_error and eof methods showed up
refactor iostream read completion to remove memory leak
updates iostream tests for new safer/less leaky API