Change docs to reflect behaviour: missing options raise a KeyError

[jean]

Also fix formatting and reflow to 80 characters, let's get the cosmetic changes out of the way.