Don't expose implementation details.

Co-authored-by: Petr Viktorin <encukou@gmail.com>

Author: ZeroIntensity

Doc/c-api/bytearray.rst

@@ -19,12 +19,6 @@ Byte Array Objects
    it is the same object as :class:`bytearray` in the Python layer.
 
 
-.. c:var:: PyTypeObject PyByteArrayIter_Type
-
-   Type object for an iterator over a :class:`bytearray` object. Instances
-   of this object are returned by :meth:`!bytearray.__iter__`.
-
-
 Type check macros
 ^^^^^^^^^^^^^^^^^
 

Doc/c-api/bytes.rst

@@ -22,12 +22,6 @@ called with a non-bytes parameter.
    is the same object as :class:`bytes` in the Python layer.
 
 
-.. c:var:: PyTypeObject PyBytesIter_Type
-
-   Type object for an iterator over a :class:`bytes` object. Instances
-   of this object are returned by :meth:`!bytes.__iter__`.
-
-
 .. c:function:: int PyBytes_Check(PyObject *o)
 
    Return true if the object *o* is a bytes object or an instance of a subtype

Doc/c-api/iterator.rst

@@ -50,3 +50,33 @@ sentinel value is returned.
    callable object that can be called with no parameters; each call to it should
    return the next item in the iteration.  When *callable* returns a value equal to
    *sentinel*, the iteration will be terminated.
+
+
+Other Iterator Objects
+^^^^^^^^^^^^^^^^^^^^^^
+
+.. c:var:: PyTypeObject PyByteArrayIter_Type
+.. c:var:: PyTypeObject PyBytesIter_Type
+.. c:var:: PyTypeObject PyListIter_Type
+.. c:var:: PyTypeObject PyListRevIter_Type
+.. c:var:: PyTypeObject PySetIter_Type
+.. c:var:: PyTypeObject PyTupleIter_Type
+.. c:var:: PyTypeObject PyRangeIter_Type
+.. c:var:: PyTypeObject PyLongRangeIter_Type
+.. c:var:: PyTypeObject PyDictIterKey_Type
+.. c:var:: PyTypeObject PyDictRevIterKey_Type
+.. c:var:: PyTypeObject PyDictIterValue_Type
+.. c:var:: PyTypeObject PyDictRevIterValue_Type
+.. c:var:: PyTypeObject PyDictIterItem_Type
+.. c:var:: PyTypeObject PyDictRevIterItem_Type
+
+   Type objects for iterators of various built-in objects.
+
+   Do not create instances of these directly; prefer calling
+   :func:`PyObject_GetIter` instead.
+
+   Note that there is no guarantee that a given built-in type uses a given iterator
+   type. For example, iterating over :class:`range` will use one of two iterator
+   types depending on the size of the range. Other types may start using a
+   similar scheme in the future, without warning.
+

Doc/c-api/list.rst

@@ -181,18 +181,3 @@ List Objects
 
    Return a new tuple object containing the contents of *list*; equivalent to
    ``tuple(list)``.
-
-List Iterators
-^^^^^^^^^^^^^^
-
-
-.. c:var:: PyTypeObject PyListIter_Type
-
-   Type object for an iterator over a :class:`list` object. Instances
-   of this object are returned by :meth:`!bytes.__iter__`.
-
-
-.. c:var:: PyTypeObject PyListRevIter_Type
-
-   Type object for a reversed iterator over a :class:`list` object.
-   Instances of this object are returned by :meth:`!bytes.__reversed__`.

Doc/c-api/set.rst

@@ -41,12 +41,6 @@ the abstract object protocol (including :c:func:`PyObject_CallMethod`,
    :class:`set` type.
 
 
-.. c:var:: PyTypeObject PySetIter_Type
-
-   Type object for an iterator over a :class:`set` object. Instances
-   of this object are returned by :meth:`!set.__iter__`.
-
-
 .. c:var:: PyTypeObject PyFrozenSet_Type
 
    This is an instance of :c:type:`PyTypeObject` representing the Python

Doc/c-api/tuple.rst

@@ -19,12 +19,6 @@ Tuple Objects
    is the same object as :class:`tuple` in the Python layer.
 
 
-.. c:var:: PyTypeObject PyTupleIter_Type
-
-   Type object for an iterator over a :class:`tuple` object. Instances
-   of this object are returned by :meth:`!tuple.__iter__`.
-
-
 .. c:function:: int PyTuple_Check(PyObject *p)
 
    Return true if *p* is a tuple object or an instance of a subtype of the