improved comments for code associated with PR#407 & PR#408

per @michitux request