comments and minor changes. Nearly done with the first pass through the
source.