bpo-29651 - Cover edge case of square brackets in urllib docs (#1128) (#1597)

(cherry picked from commit f6e863d868a621594df2a8abe072b5d4766e7137)

diff --git a/Doc/library/urllib.parse.rst b/Doc/library/urllib.parse.rst
index 499b2110c46f9d84b623d24609df80f0068512a0..6f722a88975c5151fb8f241d90d94d79abb73663 100644 (file)
--- a/Doc/library/urllib.parse.rst
+++ b/Doc/library/urllib.parse.rst
@@ -117,6 +117,9 @@ or on combining URL components into a URL string.
    See section :ref:`urlparse-result-object` for more information on the result
    object.
 
+   Unmatched square brackets in the :attr:`netloc` attribute will raise a
+   :exc:`ValueError`.
+
    .. versionchanged:: 3.2
       Added IPv6 URL parsing capabilities.
 
@@ -230,6 +233,9 @@ or on combining URL components into a URL string.
    See section :ref:`urlparse-result-object` for more information on the result
    object.
 
+   Unmatched square brackets in the :attr:`netloc` attribute will raise a
+   :exc:`ValueError`.
+
 
 .. function:: urlunsplit(parts)