Readme update

readme file updated to reflect current usage and behaviour