README and dam modified with some comments