improved function comments