read me corrections
general formatting and documentation updates,
spacing issues,
renamed some internal functions for clarity