Clarification in comments in files

clarified some of the functions in the files