merged pull, comments on pull code, update readme