cleanup of code and comments
flushing out of README