GNU bug report logs - #21995
Documentation omission for regular expressions

Previous Next

Full log

View this message in rfc822 format

From: help-debbugs <at> gnu.org (GNU bug Tracking System)
To: Eli Zaretskii <eliz <at> gnu.org>
Cc: tracker <at> debbugs.gnu.org
Subject: bug#21995: closed (Documentation omission for regular expressions)
Date: Mon, 23 Nov 2015 17:03:01 +0000

[Message part 1 (text/plain, inline)]

Your message dated Mon, 23 Nov 2015 19:02:21 +0200
with message-id <83610s1wf6.fsf <at> gnu.org>
and subject line Re: bug#21995: Documentation omission for regular expressions
has caused the debbugs.gnu.org bug report #21995,
regarding Documentation omission for regular expressions
to be marked as done.

(If you believe you have received this mail in error, please contact
help-debbugs <at> gnu.org.)


-- 
21995: http://debbugs.gnu.org/cgi/bugreport.cgi?bug=21995
GNU Bug Tracking System
Contact help-debbugs <at> gnu.org with problems

[Message part 2 (message/rfc822, inline)]

From: jan <rtm443x <at> googlemail.com>
To: bug-gnu-emacs <at> gnu.org
Subject: Documentation omission for regular expressions
Date: Mon, 23 Nov 2015 12:16:59 +0000

Hi,
\& used as a replacement will substitute in the entire matched
pattern.  For example, given text

hello

and search regexp  \(.\)  with replacement  \&\&  you get

hheelloo

I have not been able to find this \& option in the regular expression
part of the emacs manual.

jan

(Emacs 24.5.1 running on Windows 2008 R2)

[Message part 3 (message/rfc822, inline)]

From: Eli Zaretskii <eliz <at> gnu.org>
To: jan <rtm443x <at> googlemail.com>
Cc: 21995-done <at> debbugs.gnu.org
Subject: Re: bug#21995: Documentation omission for regular expressions
Date: Mon, 23 Nov 2015 19:02:21 +0200

> Date: Mon, 23 Nov 2015 12:16:59 +0000
> From: jan <rtm443x <at> googlemail.com>
> 
> \& used as a replacement will substitute in the entire matched
> pattern.  For example, given text
> 
> hello
> 
> and search regexp  \(.\)  with replacement  \&\&  you get
> 
> hheelloo
> 
> I have not been able to find this \& option in the regular expression
> part of the emacs manual.

It's described in the node "Regexp Replace" (since it's only relevant
to replacing a matched regexp).  Quote:

  `M-x replace-regexp <RET> REGEXP <RET> NEWSTRING <RET>'
       Replace every match for REGEXP with NEWSTRING.

     In `replace-regexp', the NEWSTRING need not be constant: it can
  refer to all or part of what is matched by the REGEXP.  `\&' in
  NEWSTRING stands for the entire match being replaced.  `\D' in
  NEWSTRING, where D is a digit, stands for whatever matched the Dth
  parenthesized grouping in REGEXP.  (This is called a "back reference".)
  `\#' refers to the count of replacements already made in this command,
  as a decimal number.  In the first replacement, `\#' stands for `0'; in
  the second, for `1'; and so on.  For example,

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.