GNU bug report logs - #23884
24.5; `(query)-replace-regexp` doc: be clearer about \N

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#23884: closed (24.5; `(query)-replace-regexp` doc: be clearer
 about \N)
Date: Sat, 02 Jul 2016 15:07:02 +0000

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

Your message dated Sat, 02 Jul 2016 18:06:09 +0300
with message-id <83lh1krsf2.fsf <at> gnu.org>
and subject line Re: bug#23884: 24.5; `(query)-replace-regexp` doc: be clearer about \N
has caused the debbugs.gnu.org bug report #23884,
regarding 24.5; `(query)-replace-regexp` doc: be clearer about \N
to be marked as done.

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


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

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

From: Drew Adams <drew.adams <at> oracle.com>
To: bug-gnu-emacs <at> gnu.org
Subject: 24.5; `(query)-replace-regexp` doc: be clearer about \N
Date: Sat, 2 Jul 2016 07:36:23 -0700 (PDT)

Please make it clear what N is in \N in a replacement pattern.  State
that \0 matches the entire input pattern, rather than the first
subgroup.  Users of Emacs regexps might be used to this, but it doesn't
hurt to call it out explicitly in this doc (both manual and doc
strings).

Here is proof that at least one user, who was trying to use this feature
normally, and seems to be quite competent, tried to use \0 to match the
first subgroup:

http://emacs.stackexchange.com/q/24329/105

In GNU Emacs 24.5.1 (i686-pc-mingw32)
 of 2015-04-11 on LEG570
Windowing system distributor `Microsoft Corp.', version 6.1.7601
Configured using:
 `configure --prefix=/c/usr --host=i686-pc-mingw32'

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

From: Eli Zaretskii <eliz <at> gnu.org>
To: Drew Adams <drew.adams <at> oracle.com>
Cc: 23884-done <at> debbugs.gnu.org
Subject: Re: bug#23884: 24.5; `(query)-replace-regexp` doc: be clearer about \N
Date: Sat, 02 Jul 2016 18:06:09 +0300

> Date: Sat, 2 Jul 2016 07:36:23 -0700 (PDT)
> From: Drew Adams <drew.adams <at> oracle.com>
> 
> Please make it clear what N is in \N in a replacement pattern.  State
> that \0 matches the entire input pattern, rather than the first
> subgroup.  Users of Emacs regexps might be used to this, but it doesn't
> hurt to call it out explicitly in this doc (both manual and doc
> strings).
> 
> Here is proof that at least one user, who was trying to use this feature
> normally, and seems to be quite competent, tried to use \0 to match the
> first subgroup:
> 
> http://emacs.stackexchange.com/q/24329/105

Whole generations of programmers were brain-washed with the zero-based
counting, and with the idea that reading the documentation is not
necessary.

Fixed.

Previous Next

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