cleans up specs. Improves #95
removes defaults from all classes except Document. Improves #95 and #92
improves specs for exception handling in Document.

We better avoid memoized helper methods in these examples, and also test that
warnings really appear on STDERR (while avoiding cluttering rspec output).

Improves #95
release 3.2.0