unified comments for function in headers, fixed some spelling