First documentation pass.
Add man page note.
Argh. Remove stray dot.
Document states.
Add man pages.