Tweak lots of docstrings and comments.

Also remove the pointless debug numbers.