# HG changeset patch
# User Eli Zaretskii <eliz@gnu.org>
# Date 1148068034 0
# Node ID 0e29340d15dc8fa2898e46cc074d3abf7104d181
# Parent  f263eba5607446eb1356a6660f0547c8ed58968a
(Simple Match Data): Warn about match data being set anew by every search.

diff -r f263eba56074 -r 0e29340d15dc lispref/searching.texi
--- 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