diff --git a/Doc/library/re.rst b/Doc/library/re.rst index 05db89d060b..c9466aff074 100644 --- a/Doc/library/re.rst +++ b/Doc/library/re.rst @@ -575,10 +575,11 @@ form. .. function:: findall(pattern, string[, flags]) Return all non-overlapping matches of *pattern* in *string*, as a list of - strings. If one or more groups are present in the pattern, return a list of - groups; this will be a list of tuples if the pattern has more than one group. - Empty matches are included in the result unless they touch the beginning of - another match. + strings. The *string* is scanned left-to-right, and matches are returned in + the order found. If one or more groups are present in the pattern, return a + list of groups; this will be a list of tuples if the pattern has more than + one group. Empty matches are included in the result unless they touch the + beginning of another match. .. versionadded:: 1.5.2 @@ -589,8 +590,10 @@ form. .. function:: finditer(pattern, string[, flags]) Return an :term:`iterator` yielding :class:`MatchObject` instances over all - non-overlapping matches for the RE *pattern* in *string*. Empty matches are - included in the result unless they touch the beginning of another match. + non-overlapping matches for the RE *pattern* in *string*. The *string* is + scanned left-to-right, and matches are returned in the order found. Empty + matches are included in the result unless they touch the beginning of another + match. .. versionadded:: 2.2