Documentation Pass 2
Documentation Pass 3 for Summary description
Documentation Pass 4.  Messed up remarks with last commit.
Merge pull request #269 from mono/master

Documentation Pass 2 and Pass 3