readme update and misc fixes.  resolves #26 and #31.