Change the comments to match the code.

The original literate programming style meant that I could talk to
myself while coding, however, now it is time to explain what I am
doing in this file.