Documentation for iteration.py

Also brings `iteration.py` up to PEP8 and introduces a useful option for `utils.wraps`.