Add some comments and a few style fixes.

In responding to questions from someone working on a port I found a few things I wanted to comment better.
Done, and rebased off current trunk-tracking.