Documented the enumerator helper methods

Also added a few tests to confirm that my understanding of them was
correct.