documented usage, added test for iteration