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

...tion

--
I had to look into the source code to check for the guarantee that the generator function cannot be called again until a call to `next()` releases it

If I am correct, this guarantee is by design, and I tried in this PR to make it more clear in the documentation.