sort allowlists by version more consistently

stdlib/@tests/stubtest_allowlists/darwin-py310.txt

@@ -1,15 +1,29 @@
-# Doesn't exist on macos:
-spwd
-_msi
-msilib(.[a-z]+)?
-ossaudiodev
-
-# Added in Python 3.10.12
-tarfile.TarInfo.replace
+# ===========
+# 3.9 to 3.11
+# ===========
 
 # Added in Python 3.10.15
 email._header_value_parser.NLSET
 email._header_value_parser.SPECIALSNL
 email.errors.HeaderWriteError
 email.utils.getaddresses
 email.utils.parseaddr
+
+
+# =======
+# <= 3.10
+# =======
+
+# Added in Python 3.10.12
+tarfile.TarInfo.replace
+
+
+# =============================================================
+# Allowlist entries that cannot or should not be fixed; <= 3.12
+# =============================================================
+
+# Doesn't exist on macos:
+_msi
+msilib(.[a-z]+)?
+ossaudiodev
+spwd

stdlib/@tests/stubtest_allowlists/darwin-py311.txt

@@ -1,18 +1,32 @@
-# Doesn't exist on macos:
-spwd
-_msi
-msilib(.[a-z]+)?
-ossaudiodev
+# ============
+# 3.11 to 3.12
+# ============
 
 # Not present on all MacOS versions
 fcntl.F_OFD_GETLK
 fcntl.F_OFD_SETLK
 fcntl.F_OFD_SETLKW
 
+
+# ===========
+# 3.9 to 3.11
+# ===========
+
 # Incompatible changes introduced in Python 3.11.10
 # (Remove once 3.11.10 becomes available for MacOS)
 email._header_value_parser.NLSET
 email._header_value_parser.SPECIALSNL
 email.errors.HeaderWriteError
 email.utils.getaddresses
 email.utils.parseaddr
+
+
+# =============================================================
+# Allowlist entries that cannot or should not be fixed; <= 3.12
+# =============================================================
+
+# Doesn't exist on macos:
+_msi
+msilib(.[a-z]+)?
+ossaudiodev
+spwd

stdlib/@tests/stubtest_allowlists/darwin-py312.txt

@@ -1,10 +1,19 @@
-# Doesn't exist on macos:
-spwd
-_msi
-msilib(.[a-z]+)?
-ossaudiodev
+# ============
+# 3.11 to 3.12
+# ============
 
 # Not present on all MacOS versions
 fcntl.F_OFD_GETLK
 fcntl.F_OFD_SETLK
 fcntl.F_OFD_SETLKW
+
+
+# =============================================================
+# Allowlist entries that cannot or should not be fixed; <= 3.12
+# =============================================================
+
+# Doesn't exist on macos:
+_msi
+msilib(.[a-z]+)?
+ossaudiodev
+spwd

stdlib/@tests/stubtest_allowlists/darwin-py313.txt

@@ -1,10 +1,11 @@
-# new in py313
-posixpath.splitroot
+# =======
+# >= 3.13
+# =======
 
 # Depends on HAVE_NCURSESW and how we install CPython,
 # should be removed when 3.13 will be officially released:
 _?curses.unget_wch
 _?curses.window.get_wch
 
-# Exists locally on MacOS but not on GitHub
-(mmap.MAP_32BIT)?
+(mmap.MAP_32BIT)?  # Exists locally on MacOS but not on GitHub
+posixpath.splitroot

stdlib/@tests/stubtest_allowlists/darwin-py38.txt

@@ -1,12 +1,26 @@
-# Doesn't exist on macos:
-spwd
-_msi
-msilib(.[a-z]+)?
-ossaudiodev
+# ======
+# <= 3.9
+# ======
 
 # Added in Python 3.8.14
 sys.set_int_max_str_digits
 sys.get_int_max_str_digits
 
+
+# =======
+# <= 3.10
+# =======
+
 # Added in Python 3.8.17
 tarfile.TarInfo.replace
+
+
+# =============================================================
+# Allowlist entries that cannot or should not be fixed; <= 3.12
+# =============================================================
+
+# Doesn't exist on macos:
+_msi
+msilib(.[a-z]+)?
+ossaudiodev
+spwd

stdlib/@tests/stubtest_allowlists/darwin-py39.txt

@@ -1,19 +1,38 @@
-# Doesn't exist on macos:
-spwd
-_msi
-msilib(.[a-z]+)?
-ossaudiodev
+# ===========
+# 3.9 to 3.11
+# ===========
+
+# Added in Python 3.9.20
+email._header_value_parser.NLSET
+email._header_value_parser.SPECIALSNL
+email.errors.HeaderWriteError
+email.utils.getaddresses
+email.utils.parseaddr
+
+
+# ======
+# <= 3.9
+# ======
 
 # Added in Python 3.9.14
 sys.set_int_max_str_digits
 sys.get_int_max_str_digits
 
+
+# =======
+# <= 3.10
+# =======
+
 # Added in Python 3.9.17
 tarfile.TarInfo.replace
 
-# Added in Python 3.9.20
-email._header_value_parser.NLSET
-email._header_value_parser.SPECIALSNL
-email.errors.HeaderWriteError
-email.utils.getaddresses
-email.utils.parseaddr
+
+# =============================================================
+# Allowlist entries that cannot or should not be fixed; <= 3.12
+# =============================================================
+
+# Doesn't exist on macos:
+_msi
+msilib(.[a-z]+)?
+ossaudiodev
+spwd

stdlib/@tests/stubtest_allowlists/linux-py310.txt

@@ -1,3 +1,7 @@
+# =============================================================
+# Allowlist entries that cannot or should not be fixed; <= 3.12
+# =============================================================
+
 # doesn't exist on linux
 _msi
 msilib(.[a-z]+)?

stdlib/@tests/stubtest_allowlists/linux-py311.txt

@@ -1,3 +1,7 @@
+# =============================================================
+# Allowlist entries that cannot or should not be fixed; <= 3.12
+# =============================================================
+
 # doesn't exist on linux
 _msi
 msilib(.[a-z]+)?

stdlib/@tests/stubtest_allowlists/linux-py312.txt

@@ -1,11 +1,20 @@
+# =======
+# >= 3.12
+# =======
+
+# These seem like they should be available on Linux, but they're not
+# on GitHub Actions runners for some reason.
+os.CLONE_NEWTIME
+posix.CLONE_NEWTIME
+
+
+# =============================================================
+# Allowlist entries that cannot or should not be fixed; <= 3.12
+# =============================================================
+
 # doesn't exist on linux
 _msi
 msilib(.[a-z]+)?
 
 # doesn't exist in all installations
 (nis)?
-
-# These seem like they should be available on Linux, but they're not
-# on GitHub Actions runners for some reason.
-os.CLONE_NEWTIME
-posix.CLONE_NEWTIME

stdlib/@tests/stubtest_allowlists/linux-py313.txt

@@ -1,6 +1,15 @@
+# =======
+# >= 3.13
+# =======
+
 # TODO: triage these (new in py313)
 posixpath.splitroot
 
+
+# =======
+# >= 3.12
+# =======
+
 # These seem like they should be available on Linux, but they're not
 # on GitHub Actions runners for some reason.
 os.CLONE_NEWTIME

stdlib/@tests/stubtest_allowlists/linux-py38.txt

@@ -1,7 +1,16 @@
+# ======
+# <= 3.9
+# ======
+
 # `eventmask` argument exists at runtime, but is not correctly recognized
 # while being inspected by stubtest. Fixed in Python 3.10.
 select.epoll.register
 
+
+# =============================================================
+# Allowlist entries that cannot or should not be fixed; <= 3.12
+# =============================================================
+
 # doesn't exist on linux
 _msi
 msilib(.[a-z]+)?

stdlib/@tests/stubtest_allowlists/linux-py39.txt

@@ -1,7 +1,16 @@
+# ======
+# <= 3.9
+# ======
+
 # `eventmask` argument exists at runtime, but is not correctly recognized
 # while being inspected by stubtest. Fixed in Python 3.10.
 select.epoll.register
 
+
+# =============================================================
+# Allowlist entries that cannot or should not be fixed; <= 3.12
+# =============================================================
+
 # doesn't exist on linux
 _msi
 msilib(.[a-z]+)?