doc comment clarification