# HG changeset patch
# User Juri Linkov <juri@jurta.org>
# Date 1194731441 0
# Node ID a2d2fe78ace5d1ce1019529fae6ecbb6e5229661
# Parent  a673ba5311a4b2362663943e3f0594d036819d66
(Replacing Match): Describe new `match-substitute-replacement'.

diff -r a673ba5311a4 -r a2d2fe78ace5 doc/lispref/searching.texi
--- a/doc/lispref/searching.texi	Sat Nov 10 21:49:19 2007 +0000
+++ b/doc/lispref/searching.texi	Sat Nov 10 21:50:41 2007 +0000
@@ -1260,6 +1260,16 @@
 just the text that matched @samp{\(ba*r\)}.
 @end defun
 
+@defun match-substitute-replacement replacement &optional fixedcase literal string subexp
+This function returns the text that would be inserted into the buffer
+by @code{replace-match}, but without modifying the buffer.  It is
+useful if you want to present the user with actual replacement result,
+with constructs like @samp{\@var{n}} or @samp{\&} substituted with
+matched groups.  Arguments @var{replacement} and optional
+@var{fixedcase}, @var{literal}, @var{string} and @var{subexp} have the
+same meaning as for @code{replace-match}.
+@end defun
+
 @node Simple Match Data
 @subsection Simple Match Data Access