clarify function comments