several important comments added as warnings