added details to README, minor code cleanup