updated README to match new cliff-based code
misc code cleanups/pep8 fixes