fix and document submiterator stuff