various code  changes + readme update