updated README and some cosmetic code cleanup