upgrades to some methods; updated read me