Subject: bug#27927: closed (Re: bug#27927: 25.2; Doc string of `region-extract-function')

From: [email-masked] (GNU bug Tracking System)
Date: Sat, 05 Aug 2017 08:06:02 +0000

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 [email-masked].

-- 
27927: http://debbugs.gnu.org/cgi/bugreport.cgi?bug=27927
GNU Bug Tracking System
Contact [email-masked] with problems

Subject: Re: bug#27927: 25.2; Doc string of `region-extract-function'
From: Eli Zaretskii <[email-masked]>
To: Drew Adams <[email-masked]>
Cc: [email-masked]
Date: Sat, 05 Aug 2017 11:05:17 +0300
List-Id: <debbugs-submit.debbugs.gnu.org>

> Date: Wed, 2 Aug 2017 15:46:15 -0700 (PDT)
> From: Drew Adams <[email-masked]>
> 
> 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.

Subject: 25.2; Doc string of `region-extract-function'
From: Drew Adams <[email-masked]>
To: [email-masked]
Date: Wed, 2 Aug 2017 15:46:15 -0700 (PDT)
List-Id: <debbugs-submit.debbugs.gnu.org>

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''