Added iterator exampels for documentation.
Fixed table in documentation.
Added example and explanations for iterators.
Merge branch 'master' into feature/new_iterators