documentation updates, typos, commenting

damn typos and some more commenting.  documentation updated. version
number corrected.