Issue #21593: Clarify that re.search() returns the first match

diff --git a/Doc/library/re.rst b/Doc/library/re.rst
index 82beba1534e40036d219a9ab6bc0e41d21f5ca4a..ceb795976d539e73d4462e0c7768b0023bccf635 100644 (file)
--- a/Doc/library/re.rst
+++ b/Doc/library/re.rst
@@ -811,8 +811,8 @@ attributes:
 
 .. method:: regex.search(string[, pos[, endpos]])
 
-   Scan through *string* looking for a location where this regular expression
-   produces a match, and return a corresponding :ref:`match object
+   Scan through *string* looking for the first location where this regular
+   expression produces a match, and return a corresponding :ref:`match object
    <match-objects>`.  Return ``None`` if no position in the string matches the
    pattern; note that this is different from finding a zero-length match at some
    point in the string.