bpo-20180: use Argument Clinic in itertools module where appropriate by taleinat · Pull Request #4117 · python/cpython (original) (raw)

I've reviewed, fixed, and applied pr #4170. Please use that as a model for improving this patch.

In particular, please don't move the PyTypeObject struct definitions to the bottom. This will greatly minimize the code churn and will keep the type structs right by beside the related code (which helps maintainability).

Also, just convert the primary documented interfaces. No need for setstate, reduce, etc. Please respect the existing docstrings as much as possible. The goal is to make signatures visible, not to rewrite the documentation. That said, if you find something that is unclear or incorrect, please point it out and I will take a look.