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