clarified some comments in the code