From: Richard M. Stallman <rms@gnu.org>
Date: Tue, 8 Aug 1995 20:08:09 +0000 (+0000)
Subject: Add subexp arg to replace-match.
X-Git-Tag: emacs-19.34~3055
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=d544c776f62b54b76f55e61f00bda00a3cc4f489;p=emacs.git

Add subexp arg to replace-match.
---

diff --git a/lispref/searching.texi b/lispref/searching.texi
index 073c1ae212a..9c8c37e08d3 100644
--- a/lispref/searching.texi
+++ b/lispref/searching.texi
@@ -1079,7 +1079,7 @@ character of the buffer counts as 1.)
 @var{replacement}.
 
 @cindex case in replacements
-@defun replace-match replacement &optional fixedcase literal string
+@defun replace-match replacement &optional fixedcase literal string subexp
 This function replaces the text in the buffer (or in @var{string}) that
 was matched by the last search.  It replaces that text with
 @var{replacement}.
@@ -1127,6 +1127,12 @@ Subexpressions are those expressions grouped inside @samp{\(@dots{}\)}.
 @cindex @samp{\} in replacement
 @samp{\\} stands for a single @samp{\} in the replacement text.
 @end table
+
+If @var{subexp} is non-@code{nil}, that says to replace just
+subexpression number @var{subexp} of the regexp that was matched, not
+the entire match.  For example, after matching @samp{foo \(ba*r\)},
+calling @code{replace-match} with 1 as @var{subexp} means to replace
+just the text that matched @samp{\(ba*r\)}.
 @end defun
 
 @node Entire Match Data