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 d5abcdd..e01a8cc 100644
--- a/Doc/library/re.rst
+++ b/Doc/library/re.rst
@@ -544,6 +544,13 @@
>>> 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])