lots of comment fixes.
Merge pull request #2 from Cadair/sep-coordinates

lots of comment fixes.