# HG changeset patch # User Eli Zaretskii # Date 1144849198 0 # Node ID fbf2a5887b3722552ad046c7c0f352882cd1161a # Parent d5a08c9d58ddf01268b4c9bd7589d94dd3199477 (Regexp Backslash, Regexp Replace): Add index entries for ``back reference'' and mention the term itself in the text. diff -r d5a08c9d58dd -r fbf2a5887b37 man/search.texi --- a/man/search.texi Wed Apr 12 12:31:05 2006 +0000 +++ b/man/search.texi Wed Apr 12 13:39:58 2006 +0000 @@ -750,8 +750,9 @@ 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 @@ 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}