more function commentary adjustments