corrected and clarified comments from last commit