From 0d8b7acbb3dd5af4b7cb7174920ca510a9c4eeac Mon Sep 17 00:00:00 2001 From: Eli Zaretskii Date: Wed, 12 Apr 2006 13:40:23 +0000 Subject: [PATCH] (Regexp Backslash, Regexp Replace): Add index entries for ``back reference'' and mention the term itself in the text. --- man/ChangeLog | 6 ++++++ man/search.texi | 12 +++++++----- 2 files changed, 13 insertions(+), 5 deletions(-) diff --git a/man/ChangeLog b/man/ChangeLog index e084c37976..c99c487ee3 100644 --- a/man/ChangeLog +++ b/man/ChangeLog @@ -1,3 +1,9 @@ +2006-04-12 Eli Zaretskii + + * search.texi (Regexp Backslash, Regexp Replace): Add index + entries for ``back reference'' and mention the term itself in the + text. + 2006-04-11 Richard Stallman * custom.texi (Safe File Variables): diff --git a/man/search.texi b/man/search.texi index a38f56e3f2..ab10944509 100644 --- a/man/search.texi +++ b/man/search.texi @@ -750,8 +750,9 @@ can add groups for syntactic purposes without interfering with the numbering of the groups that are meant to be referred to. @item \@var{d} +@cindex back reference, in regexp matches the same text that matched the @var{d}th occurrence of a -@samp{\( @dots{} \)} construct. +@samp{\( @dots{} \)} construct (a.k.a.@: @dfn{back reference}). After the end of a @samp{\( @dots{} \)} construct, the matcher remembers the beginning and end of the text matched by that construct. Then, @@ -1002,15 +1003,16 @@ any match for a specified pattern. Replace every match for @var{regexp} with @var{newstring}. @end table +@cindex back reference, in regexp replacement In @code{replace-regexp}, the @var{newstring} need not be constant: it can refer to all or part of what is matched by the @var{regexp}. @samp{\&} in @var{newstring} stands for the entire match being replaced. @samp{\@var{d}} in @var{newstring}, where @var{d} is a digit, stands for whatever matched the @var{d}th parenthesized -grouping in @var{regexp}. @samp{\#} refers to the count of -replacements already made in this command, as a decimal number. In -the first replacement, @samp{\#} stands for @samp{0}; in the second, -for @samp{1}; and so on. For example, +grouping in @var{regexp} (a.k.a.@: ``back reference''). @samp{\#} +refers to the count of replacements already made in this command, as a +decimal number. In the first replacement, @samp{\#} stands for +@samp{0}; in the second, for @samp{1}; and so on. For example, @example M-x replace-regexp @key{RET} c[ad]+r @key{RET} \&-safe @key{RET} -- 2.39.2