whatsnew: expand re.fullmatch entry with the motivation for the feature.
authorR David Murray <rdmurray@bitdance.com>
Mon, 10 Mar 2014 00:52:28 +0000 (20:52 -0400)
committerR David Murray <rdmurray@bitdance.com>
Mon, 10 Mar 2014 00:52:28 +0000 (20:52 -0400)
Doc/whatsnew/3.4.rst

index 9e87b42b7cfc2427653f5951013e991a4516cef3..33461ebf5b904a133dcc1edf8507bf10f139eb23 100644 (file)
@@ -1172,9 +1172,12 @@ affect the behaviour of :func:`help`.
 re
 --
 
-Added :func:`re.fullmatch` function and :meth:`regex.fullmatch` method,
-which anchor the pattern at both ends of the string to match.
-(Contributed by Matthew Barnett in :issue:`16203`.)
+New :func:`~re.fullmatch` function and :meth:`.regex.fullmatch` method anchor
+the pattern at both ends of the string to match.  This provides a way to be
+explicit about the goal of the match, which avoids a class of subtle bugs where
+``$`` characters get lost during code changes or the addition of alternatives
+to an existing regular expression.  (Contributed by Matthew Barnett in
+:issue:`16203`.)
 
 The repr of :ref:`regex objects <re-objects>` now includes the pattern
 and the flags; the repr of :ref:`match objects <match-objects>` now