changeset 70741:0e29340d15dc

(Simple Match Data): Warn about match data being set anew by every search.
author Eli Zaretskii <eliz@gnu.org>
date Fri, 19 May 2006 19:47:14 +0000
parents f263eba56074
children 6d812049e04c
files lispref/searching.texi
diffstat 1 files changed, 6 insertions(+), 0 deletions(-) [+]
line wrap: on
line diff
--- a/lispref/searching.texi	Fri May 19 19:29:36 2006 +0000
+++ b/lispref/searching.texi	Fri May 19 19:47:14 2006 +0000
@@ -1264,6 +1264,12 @@
 expressions can have subexpressions---after a simple string search, the
 only information available is about the entire match.
 
+  Every successful search sets the match data.  Therefore, you should
+query the match data immediately after searching, before calling any
+other function that might perform another search.  Alternatively, you
+may save and restore the match data (@pxref{Saving Match Data}) around
+the call to functions that could perform another search.
+
   A search which fails may or may not alter the match data.  In the
 past, a failing search did not do this, but we may change it in the
 future.  So don't try to rely on the value of the match data after