various clarification in internal comments