Added a note and examples to explain that re.split does not split on an

empty pattern match. (issue 852532).

diff --git a/Doc/library/re.rst b/Doc/library/re.rst
index d5abcdd2a270a2930bf43316b5e9d85a33081b6a..e01a8cc72627b7424c073a3b1e795d2dc09d9cee 100644 (file)
--- a/Doc/library/re.rst
+++ b/Doc/library/re.rst
@@ -544,6 +544,13 @@ form.
       >>> re.split('\W+', 'Words, words, words.', 1)
       ['Words', 'words, words.']
 
+   Note that *split* will never split a string on an empty pattern match.
+   For example ::
+
+      >>> re.split('x*', 'foo')
+      ['foo']
+      >>> re.split("(?m)^$", "foo\n\nbar\n")
+      ['foo\n\nbar\n']
 
 .. function:: findall(pattern, string[, flags])