[Emacs-diffs] Changes to emacs/lispref/searching.texi

[Richard M . Stallman]

Index: emacs/lispref/searching.texi
diff -c emacs/lispref/searching.texi:1.65 emacs/lispref/searching.texi:1.66
*** emacs/lispref/searching.texi:1.65   Thu Aug 11 19:47:37 2005
--- emacs/lispref/searching.texi        Thu Aug 25 11:05:31 2005
***************
*** 1147,1152 ****
--- 1147,1171 ----
  @section Search and Replace
  @cindex replacement
  
+ @defun replace-regexp-in-string regexp rep string &optional fixedcase literal 
subexp start
+ This function copies @var{string} and searches it for matches for
+ @var{regexp}, and replaces them with @var{rep}.  It returns the
+ modified copy.  If @var{start} is address@hidden, the search for
+ matches starts at that index in @var{string}, so matches starting
+ before that index are not changed.
+ 
+ This function uses @code{replace-match} to do the replacement, and it
+ passes the optional arguments @var{fixedcase}, @var{literal} and
+ @var{subexp} along to @code{replace-match}.
+ 
+ Instead of a string, @var{rep} can be a function.  In that case,
+ @code{replace-regexp-in-string} calls @var{rep} for each match,
+ passing the text of the match as its sole argument.  It collects the
+ value @var{rep} returns and passes that to @code{replace-match} as the
+ replacement string.  The match-data at this point are the result
+ of matching @var{regexp} against a substring of @var{string}.
+ @end defun
+ 
  @defun perform-replace from-string replacements query-flag regexp-flag 
delimited-flag &optional repeat-count map start end
  This function is the guts of @code{query-replace} and related
  commands.  It searches for occurrences of @var{from-string} in the