adds clarification in comment docs.