updated readme, and fixed some erroneous comments.