add some more explicit comments as per requirements

(don't ask...)