core: various comment clarifications