https://github.com/python/cpython/commit/7aedd0a6c6ae3b5cdd601e84411e41c56f8d00b9
commit: 7aedd0a6c6ae3b5cdd601e84411e41c56f8d00b9
branch: main
author: wouter bolsterlee <[email protected]>
committer: ncoghlan <[email protected]>
date: 2026-05-04T23:03:20+10:00
summary:
gh-87245: Improve IPv6Address.ipv4_mapped documentation (#92572)
Avoid the phrasing ‘starting with ::FFFF/96’, which is confusing since
it seems to mix a prefix and a range. Instead, make it clear what the
actual range is, and refer to the relevant RFC.
Closes #87245.
files:
M Doc/library/ipaddress.rst
diff --git a/Doc/library/ipaddress.rst b/Doc/library/ipaddress.rst
index ba20310d63b277..9ccd8602bcb2c3 100644
--- a/Doc/library/ipaddress.rst
+++ b/Doc/library/ipaddress.rst
@@ -367,9 +367,9 @@ write code that handles both IP versions correctly.
Address objects are
.. attribute:: ipv4_mapped
- For addresses that appear to be IPv4 mapped addresses (starting with
- ``::FFFF/96``), this property will report the embedded IPv4 address.
- For any other address, this property will be ``None``.
+ For addresses that appear to be IPv4 mapped addresses in the range
+ ``::FFFF:0:0/96`` as defined by :RFC:`4291`, this property reports the
+ embedded IPv4 address. For any other address, this property will be
``None``.
.. attribute:: scope_id
_______________________________________________
Python-checkins mailing list -- [email protected]
To unsubscribe send an email to [email protected]
https://mail.python.org/mailman3//lists/python-checkins.python.org
Member address: [email protected]
