more comment adjustments (separating interface doc from internal description)