Skip to content

gh-87245: Improve IPv6Address.ipv4_mapped documentation#92572

Merged
ncoghlan merged 2 commits intopython:mainfrom
wbolster:gh-87245-ipv4-mapped
May 4, 2026
Merged

gh-87245: Improve IPv6Address.ipv4_mapped documentation#92572
ncoghlan merged 2 commits intopython:mainfrom
wbolster:gh-87245-ipv4-mapped

Conversation

@wbolster
Copy link
Copy Markdown
Contributor

@wbolster wbolster commented May 9, 2022

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.

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 python#87245.
@bedevere-bot bedevere-bot added docs Documentation in the Doc dir awaiting review labels May 9, 2022
@wbolster
Copy link
Copy Markdown
Contributor Author

wbolster commented May 9, 2022

(this can be labelled as skip-news)

Copy link
Copy Markdown
Contributor

@MaxwellDupre MaxwellDupre left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Checked all good. Even though RFC 4291 does not actually state precisely the address given.

@github-actions
Copy link
Copy Markdown

This PR is stale because it has been open for 30 days with no activity.

@github-actions github-actions Bot added the stale Stale PR or inactive for long period of time. label Apr 11, 2026
@ncoghlan ncoghlan added triaged The issue has been accepted as valid by a triager. 3.13 bugs and security fixes 3.14 bugs and security fixes needs backport to 3.13 bugs and security fixes needs backport to 3.14 bugs and security fixes 3.15 new features, bugs and security fixes and removed stale Stale PR or inactive for long period of time. labels May 4, 2026
@ncoghlan
Copy link
Copy Markdown
Contributor

ncoghlan commented May 4, 2026

A case of stale bot nudges doing their job - sorry for the long delay here, and thanks for the PR!

@read-the-docs-community
Copy link
Copy Markdown

Documentation build overview

📚 cpython-previews | 🛠️ Build #32526121 | 📁 Comparing aba7d22 against main (2ba0a81)

  🔍 Preview build  

1 file changed
± library/ipaddress.html

@ncoghlan ncoghlan merged commit 7aedd0a into python:main May 4, 2026
48 checks passed
@github-project-automation github-project-automation Bot moved this from Todo to Done in Docs PRs May 4, 2026
@miss-islington-app
Copy link
Copy Markdown

Thanks @wbolster for the PR, and @ncoghlan for merging it 🌮🎉.. I'm working now to backport this PR to: 3.13, 3.14.
🐍🍒⛏🤖

@bedevere-app
Copy link
Copy Markdown

bedevere-app Bot commented May 4, 2026

GH-149360 is a backport of this pull request to the 3.14 branch.

@bedevere-app bedevere-app Bot removed the needs backport to 3.14 bugs and security fixes label May 4, 2026
@bedevere-app
Copy link
Copy Markdown

bedevere-app Bot commented May 4, 2026

GH-149361 is a backport of this pull request to the 3.13 branch.

@bedevere-app bedevere-app Bot removed the needs backport to 3.13 bugs and security fixes label May 4, 2026
ncoghlan pushed a commit that referenced this pull request May 4, 2026
) (#149361)

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 7aedd0a)

Co-authored-by: wouter bolsterlee <wouter@bolsterl.ee>
ncoghlan pushed a commit that referenced this pull request May 4, 2026
) (#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 7aedd0a)

Co-authored-by: wouter bolsterlee <wouter@bolsterl.ee>
@wbolster wbolster deleted the gh-87245-ipv4-mapped branch May 4, 2026 13:35
@jap
Copy link
Copy Markdown

jap commented May 4, 2026

while at it, you could do a quick s/FFFF/ffff/ to be compliant with rfc5952 §4.3 ,

The characters "a", "b", "c", "d", "e", and "f" in an IPv6 address
MUST be represented in lowercase.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

3.13 bugs and security fixes 3.14 bugs and security fixes 3.15 new features, bugs and security fixes docs Documentation in the Doc dir skip news triaged The issue has been accepted as valid by a triager.

Projects

Status: Done

Development

Successfully merging this pull request may close these issues.

wrong IP address range given for ipv4_mapped

6 participants