[3.6] Added effect of re.ASCII and reworded slightly (GH-1782) (#3313)

(cherry picked from commit c9d6dbc2900ace9564b8f67e63617be747355c6b)

diff --git a/Doc/library/re.rst b/Doc/library/re.rst
index 7a51abdc983f634460c0abba91aca8bfe323c338..56fc4ed2c9420d804d05b1cbdca27a34fd48209a 100644 (file)
--- a/Doc/library/re.rst
+++ b/Doc/library/re.rst
@@ -542,9 +542,11 @@ form.
 .. data:: I
           IGNORECASE
 
-   Perform case-insensitive matching; expressions like ``[A-Z]`` will match
-   lowercase letters, too.  This is not affected by the current locale
-   and works for Unicode characters as expected.
+   Perform case-insensitive matching; expressions like ``[A-Z]`` will also
+   match lowercase letters.  The current locale does not change the effect of
+   this flag.  Full Unicode matching (such as ``Ü`` matching ``ü``) also
+   works unless the :const:`re.ASCII` flag is also used to disable non-ASCII
+   matches.
 
 
 .. data:: L