Fix docs on http package

The recent change to throw errors wasn't done to completion.
Update the examples and some of the prose.