[Emacs-diffs] /srv/bzr/emacs/trunk r104910: * searching.texi (Match Data): Note that match data can be

[Lars Magne Ingebrigtsen]

------------------------------------------------------------
revno: 104910
fixes bug(s): http://debbugs.gnu.org/2499
author: Tobias C. Rittweiler <address@hidden>
committer: Lars Magne Ingebrigtsen <address@hidden>
branch nick: trunk
timestamp: Sun 2011-07-03 20:44:53 +0200
message:
  * searching.texi (Match Data): Note that match data can be
  overwritten by most functions.
modified:
  doc/lispref/ChangeLog
  doc/lispref/searching.texi

=== modified file 'doc/lispref/ChangeLog'
--- a/doc/lispref/ChangeLog     2011-07-03 13:02:43 +0000
+++ b/doc/lispref/ChangeLog     2011-07-03 18:44:53 +0000
@@ -1,3 +1,8 @@
+2011-07-03  Tobias C. Rittweiler  <address@hidden>  (tiny change)
+
+       * searching.texi (Match Data): Note that match data can be
+       overwritten by most functions (bug#2499).
+
 2011-07-03  Lars Magne Ingebrigtsen  <address@hidden>
 
        * strings.texi (Formatting Strings): Clarify what the "-" and "0"

=== modified file 'doc/lispref/searching.texi'
--- a/doc/lispref/searching.texi        2011-01-25 04:08:28 +0000
+++ b/doc/lispref/searching.texi        2011-07-03 18:44:53 +0000
@@ -1207,6 +1207,12 @@
 can't avoid another intervening search, you must save and restore the
 match data around it, to prevent it from being overwritten.
 
+  Notice that all functions are allowed to overwrite the match data
+unless they're explicitly documented not to do so.  A consequence is
+that functions that are run implictly in the background
+(@pxref{Timers}, and @ref{Idle Timers}) should likely save and restore
+the match data explicitly.
+
 @menu
 * Replacing Match::       Replacing a substring that was matched.
 * Simple Match Data::     Accessing single items of match data,