Documentation fixes and improvements

Warning to reflect the fact that as I'm using
documentation-driven development, not all features exist. Ok, almost no
features exist.

Corrected the main example code