GNU bug report logs - #27927
25.2; Doc string of `region-extract-function'

Previous Next

Full log

View this message in rfc822 format

From: help-debbugs <at> gnu.org (GNU bug Tracking System)
To: Drew Adams <drew.adams <at> oracle.com>
Subject: bug#27927: closed (Re: bug#27927: 25.2; Doc string of
 `region-extract-function')
Date: Sat, 05 Aug 2017 08:06:02 +0000

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

Your bug report

#27927: 25.2; Doc string of `region-extract-function'

which was filed against the emacs package, has been closed.

The explanation is attached below, along with your original report.
If you require more details, please reply to 27927 <at> debbugs.gnu.org.

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

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

From: Eli Zaretskii <eliz <at> gnu.org>
To: Drew Adams <drew.adams <at> oracle.com>
Cc: 27927-done <at> debbugs.gnu.org
Subject: Re: bug#27927: 25.2; Doc string of `region-extract-function'
Date: Sat, 05 Aug 2017 11:05:17 +0300

> Date: Wed, 2 Aug 2017 15:46:15 -0700 (PDT)
> From: Drew Adams <drew.adams <at> oracle.com>
> 
> This doc string now reads a bit like a kludge was added to what was
> there before.  There is nothing that should now favor the meaning of the
> argument as "delete".

Actually, there is: the call to filter-buffer-substring.  But I don't
think that's strong enough, so I fixed the doc string.

Thanks.

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

From: Drew Adams <drew.adams <at> oracle.com>
To: bug-gnu-emacs <at> gnu.org
Subject: 25.2; Doc string of `region-extract-function'
Date: Wed, 2 Aug 2017 15:46:15 -0700 (PDT)

This doc string now reads a bit like a kludge was added to what was
there before.  There is nothing that should now favor the meaning of the
argument as "delete".  The parameter should be renamed from DELETE to
just ACTION or ARG (or something else).

"If DELETE is `delete-only'...
 If DELETE is nil...
 If DELETE is `bounds', then don't delete, but..."

Change that to something like

"If ACTION is `delete-only'...
 If ACTION is nil...
 If ACTION is `bounds'...

In GNU Emacs 25.2.1 (x86_64-w64-mingw32)
 of 2017-04-24 built on LAPHROAIG
Windowing system distributor 'Microsoft Corp.', version 6.1.7601
Configured using:
 'configure --without-dbus --without-compress-install 'CFLAGS=-O2
 -static -g3''

Previous Next

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