Docs: clarify the fact that `next()` unlocks calls to the generator function
Merge pull request #128 from jeromew/docs

Docs: clarify the fact that `next()` unlocks calls to the generator func...