code review

A few small changes, mostly to documentation and comments.