iterator: adjust variant names and add documentation

The variant naming conventions come from CASS_ITERATOR_TYPE
values that correspond to each variant.

I also ditched the `Cass` prefix and `Iterator` suffix for variant names. These
are redundant.

Author: muzarski