update api docs for change made in issue #328
Merge pull request #331 from psalaets/docs-for-328

Docs: updated for recent change to iterate()