Clean up comments and docstrings

None of the changes in this commit have a functional impact.
Merge pull request #1211 from Ichimonji10/cleanup

Clean up comments and docstrings
Remove "skip" decorator from working test.

Bugzilla bug 1112657 is, according to comments there, fixed. Running the
relevant test suite indicates that the issue is, in fact, fixed. Remove a
now-unnecessary "skip" decorator.