From: Miss Islington (bot) <31488909+miss-islington@users.noreply.github.com>
Date: Sun, 30 Mar 2025 10:07:08 +0000 (+0200)
Subject: [3.13] gh-129994: update docs when using `dualstack_ipv6` in `socket.create_server... 
X-Git-Tag: v3.13.3~61
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=19187991a8311e87735eb3abe55c0c499739769d;p=thirdparty%2FPython%2Fcpython.git

[3.13] gh-129994: update docs when using `dualstack_ipv6` in `socket.create_server` (GH-129996) (#131890)

gh-129994: update docs when using `dualstack_ipv6` in `socket.create_server` (GH-129996)
(cherry picked from commit 044a1e13d5cfc91b0a8774e936877e91cbac3a16)

Co-authored-by: Alexander Ershov <150328014+AEErshov@users.noreply.github.com>
---

diff --git a/Doc/library/socket.rst b/Doc/library/socket.rst
index 12f95b839a94..e5baa3a002a0 100644
--- a/Doc/library/socket.rst
+++ b/Doc/library/socket.rst
@@ -838,10 +838,10 @@ The following functions all create :ref:`socket objects <socket-objects>`.
    , a default reasonable value is chosen.
    *reuse_port* dictates whether to set the :data:`SO_REUSEPORT` socket option.
 
-   If *dualstack_ipv6* is true and the platform supports it the socket will
-   be able to accept both IPv4 and IPv6 connections, else it will raise
-   :exc:`ValueError`. Most POSIX platforms and Windows are supposed to support
-   this functionality.
+   If *dualstack_ipv6* is true, *family* is :data:`AF_INET6` and the platform
+   supports it the socket will be able to accept both IPv4 and IPv6 connections,
+   else it will raise :exc:`ValueError`. Most POSIX platforms and Windows are
+   supposed to support this functionality.
    When this functionality is enabled the address returned by
    :meth:`socket.getpeername` when an IPv4 connection occurs will be an IPv6
    address represented as an IPv4-mapped IPv6 address.