Merge branch 'main' into document-missing-types

Author: ZeroIntensity

Apple/__main__.py

@@ -507,7 +507,7 @@ def lib_non_platform_files(dirname, names):
 def create_xcframework(platform: str) -> str:
     """Build an XCframework from the component parts for the platform.
 
-    :return: The version number of the Python verion that was packaged.
+    :return: The version number of the Python version that was packaged.
     """
     package_path = CROSS_BUILD_DIR / platform
     try:

Doc/c-api/iterator.rst

@@ -52,8 +52,6 @@ sentinel value is returned.
    *sentinel*, the iteration will be terminated.
 
 
-.. _range-objects:
-
 Range Objects
 ^^^^^^^^^^^^^
 
@@ -68,10 +66,8 @@ Range Objects
    This function always succeeds.
 
 
-.. _other-builtin-iterator-types:
-
-Other Builtin Iterator Types
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+Builtin Iterator Types
+^^^^^^^^^^^^^^^^^^^^^^
 
 These are built-in iteration types that are included in Python's C API, but
 provide no additional functions. They are here for completeness.
@@ -95,3 +91,31 @@ provide no additional functions. They are here for completeness.
 
    The type object for :class:`zip` objects.
 
+
+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
+   :c: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.