some clarifications in comments and function name.