From: Senthil Kumaran <skumaran@gatech.edu>
Date: Tue, 16 May 2017 05:41:07 +0000 (-0700)
Subject:  bpo-29651 - Cover edge case of square brackets in urllib docs (#1128) (#1596)
X-Git-Tag: v3.6.2rc1~156
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=75b8a54bcad70806d9dcbbe20786f4d9092ab39c;p=python

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

(cherry picked from commit f6e863d868a621594df2a8abe072b5d4766e7137)
---

diff --git a/Doc/library/urllib.parse.rst b/Doc/library/urllib.parse.rst
index 676321b46a..1cc69e62e6 100644
--- a/Doc/library/urllib.parse.rst
+++ b/Doc/library/urllib.parse.rst
@@ -118,6 +118,9 @@ or on combining URL components into a URL string.
    an invalid port is specified in the URL.  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.
 
@@ -236,6 +239,9 @@ or on combining URL components into a URL string.
    an invalid port is specified in the URL.  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.6
       Out-of-range port numbers now raise :exc:`ValueError`, instead of
       returning :const:`None`.