minor API comment clarifications