From: Miss Islington (bot) <31488909+miss-islington@users.noreply.github.com> Date: Mon, 4 May 2026 13:10:51 +0000 (+0200) Subject: [3.14] gh-87245: Improve IPv6Address.ipv4_mapped documentation (GH-92572) (#149360) X-Git-Tag: v3.14.5rc1~4 X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=62f5d946b2ce39c764ecf20a999e8b7e84927664;p=thirdparty%2FPython%2Fcpython.git [3.14] gh-87245: Improve IPv6Address.ipv4_mapped documentation (GH-92572) (#149360) gh-87245: Improve IPv6Address.ipv4_mapped documentation (GH-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 GH-87245. (cherry picked from commit 7aedd0a6c6ae3b5cdd601e84411e41c56f8d00b9) Co-authored-by: wouter bolsterlee --- diff --git a/Doc/library/ipaddress.rst b/Doc/library/ipaddress.rst index c546d913cbea..45256d29e854 100644 --- a/Doc/library/ipaddress.rst +++ b/Doc/library/ipaddress.rst @@ -369,9 +369,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