Improvements to function comments