gh-150831: clarify generator, generator function, and generator iterator in glossary

[Aniketsy]

fixes #150831
…sary

• Issue: Glossary terms for generators might mismatch usage in the community and are inconsistent with coroutines #150831

[read-the-docs-community]

Documentation build overview

📚 cpython-previews | 🛠️ Build #33008873 | 📁 Comparing 80fde9d against main (cb064e7)

  🔍 Preview build  

5 files changed · ± 5 modified

± Modified

• glossary.html
• library/io.html
• library/stdtypes.html
• using/windows.html
• whatsnew/changelog.html

[nedbat]

I would love to move the glossary closer to actual usage. I have never heard someone say "generator iterator": it's redundant. Can we explicitly mention that "generator" is used informally for both meanings and that "generator function" and "generator iterator" are formal terms that are uncommon?

[Aniketsy]

Can we explicitly mention that "generator" is used informally for both meanings and that "generator function" and "generator iterator" are formal terms that are uncommon?

hmm , i think its good to mention like this. thanks for the improvement 😊