modification of README and some of the functional code