flesh out IteratorTools tests and clarify documentation