more comments and some typo fixes