From unknown Sun Jun 22 22:41:46 2025 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable MIME-Version: 1.0 X-Mailer: MIME-tools 5.509 (Entity 5.509) Content-Type: text/plain; charset=utf-8 From: bug#21315 <21315@debbugs.gnu.org> To: bug#21315 <21315@debbugs.gnu.org> Subject: Status: 25.0.50; doc of `kill-ring-save', `copy-region-as-kill' - bad Reply-To: bug#21315 <21315@debbugs.gnu.org> Date: Mon, 23 Jun 2025 05:41:46 +0000 retitle 21315 25.0.50; doc of `kill-ring-save', `copy-region-as-kill' - bad reassign 21315 emacs submitter 21315 Drew Adams severity 21315 minor thanks From debbugs-submit-bounces@debbugs.gnu.org Fri Aug 21 13:18:07 2015 Received: (at submit) by debbugs.gnu.org; 21 Aug 2015 17:18:07 +0000 Received: from localhost ([127.0.0.1]:34721 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1ZSpx8-0005G3-W1 for submit@debbugs.gnu.org; Fri, 21 Aug 2015 13:18:07 -0400 Received: from eggs.gnu.org ([208.118.235.92]:37821) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1ZSpx6-0005Fu-5W for submit@debbugs.gnu.org; Fri, 21 Aug 2015 13:18:04 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1ZSpx5-0004mf-3h for submit@debbugs.gnu.org; Fri, 21 Aug 2015 13:18:03 -0400 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=0.8 required=5.0 tests=BAYES_50 autolearn=disabled version=3.3.2 Received: from lists.gnu.org ([2001:4830:134:3::11]:49797) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ZSpx5-0004mZ-1h for submit@debbugs.gnu.org; Fri, 21 Aug 2015 13:18:03 -0400 Received: from eggs.gnu.org ([2001:4830:134:3::10]:47815) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ZSpx4-0007EU-3n for bug-gnu-emacs@gnu.org; Fri, 21 Aug 2015 13:18:02 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1ZSpx1-0004lv-Ds for bug-gnu-emacs@gnu.org; Fri, 21 Aug 2015 13:18:02 -0400 Received: from userp1040.oracle.com ([156.151.31.81]:25083) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ZSpx1-0004lo-6y for bug-gnu-emacs@gnu.org; Fri, 21 Aug 2015 13:17:59 -0400 Received: from userv0022.oracle.com (userv0022.oracle.com [156.151.31.74]) by userp1040.oracle.com (Sentrion-MTA-4.3.2/Sentrion-MTA-4.3.2) with ESMTP id t7LHHw10026684 (version=TLSv1 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK) for ; Fri, 21 Aug 2015 17:17:58 GMT Received: from aserv0121.oracle.com (aserv0121.oracle.com [141.146.126.235]) by userv0022.oracle.com (8.13.8/8.13.8) with ESMTP id t7LHHvpe023858 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=FAIL) for ; Fri, 21 Aug 2015 17:17:58 GMT Received: from abhmp0012.oracle.com (abhmp0012.oracle.com [141.146.116.18]) by aserv0121.oracle.com (8.13.8/8.13.8) with ESMTP id t7LHHvpH022280 for ; Fri, 21 Aug 2015 17:17:57 GMT MIME-Version: 1.0 Message-ID: Date: Fri, 21 Aug 2015 10:17:56 -0700 (PDT) From: Drew Adams To: bug-gnu-emacs@gnu.org Subject: 25.0.50; doc of `kill-ring-save', `copy-region-as-kill' - bad X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9 (901082) [OL 12.0.6691.5000 (x86)] Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable X-Source-IP: userv0022.oracle.com [156.151.31.74] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.4.x-2.6.x [generic] X-detected-operating-system: by eggs.gnu.org: Error: Malformed IPv6 address (bad octet value). X-Received-From: 2001:4830:134:3::11 X-Spam-Score: -4.0 (----) X-Debbugs-Envelope-To: submit X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -4.0 (----) In Emacs 24.4 you changed not only the signature of these commands but also their interactive behavior, by adding optional arg REGION and giving users control over it with the prefix arg. Unfortunately, the doc for this new behavior is horribly inadequate. 1. The Emacs manual says nothing about the new behavior. It should cover it. 2. The doc strings are awful in this regard. They say only "The optional argument REGION if non-nil, indicates that we're not just copying some text between BEG and END, but we're copying the region." That's worse than saying nothing - a complete cop-out. If the doc is going to say something like "we're copying the region" and if that phrase is expected to mean anything then the doc needs to say what it means by that. Describe the user-observable behavior difference between using a prefix arg and not using it. Currently, the use of a prefix arg is not even mentioned. As bad as the description of parameter REGION is, it is not even connected with the use of a prefix arg. 3. The command is not documented at all in the Elisp manual. It need not be, but the current state is that a user has no real information about this at all, and that is not good. 4. I find nothing in NEW for Emacs 24.4 (when this was released) about this. User-observable behavior changes like this should be documented there. Developers should not be allowed to commit program changes like this without updating the doc appropriately. Yes, leader resources are scarce, and people are overworked. But it's too bad, as it fosters bad habits, unless the person who committed the code change happens to be the one who fixes this doc bug, and can thus learn from the mistake. In GNU Emacs 25.0.50.1 (i686-pc-mingw32) of 2015-07-31 on LEG570 Bzr revision: 8d332aeccab2208e6c6bd434738565e6abf12043 Windowing system distributor `Microsoft Corp.', version 6.1.7601 Configured using: `configure --host=3Di686-pc-mingw32 --enable-checking=3Dyes,glyphs' From debbugs-submit-bounces@debbugs.gnu.org Fri Dec 04 13:06:12 2015 Received: (at 21315) by debbugs.gnu.org; 4 Dec 2015 18:06:12 +0000 Received: from localhost ([127.0.0.1]:39335 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1a4ukF-0003WQ-Ly for submit@debbugs.gnu.org; Fri, 04 Dec 2015 13:06:11 -0500 Received: from aserp1040.oracle.com ([141.146.126.69]:31759) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1a4ukD-0003WH-Fo for 21315@debbugs.gnu.org; Fri, 04 Dec 2015 13:06:10 -0500 Received: from userv0021.oracle.com (userv0021.oracle.com [156.151.31.71]) by aserp1040.oracle.com (Sentrion-MTA-4.3.2/Sentrion-MTA-4.3.2) with ESMTP id tB4I67AJ022506 (version=TLSv1 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK) for <21315@debbugs.gnu.org>; Fri, 4 Dec 2015 18:06:08 GMT Received: from aserv0122.oracle.com (aserv0122.oracle.com [141.146.126.236]) by userv0021.oracle.com (8.13.8/8.13.8) with ESMTP id tB4I67n8000634 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=FAIL) for <21315@debbugs.gnu.org>; Fri, 4 Dec 2015 18:06:07 GMT Received: from abhmp0012.oracle.com (abhmp0012.oracle.com [141.146.116.18]) by aserv0122.oracle.com (8.13.8/8.13.8) with ESMTP id tB4I67lY000456 for <21315@debbugs.gnu.org>; Fri, 4 Dec 2015 18:06:07 GMT MIME-Version: 1.0 Message-ID: <0fc80688-9028-4715-b2d9-a4bce4439a3b@default> Date: Fri, 4 Dec 2015 10:06:05 -0800 (PST) From: Drew Adams To: 21315@debbugs.gnu.org Subject: RE: bug#21315: 25.0.50; doc of `kill-ring-save', `copy-region-as-kill' - bad References: In-Reply-To: X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9 (901082) [OL 12.0.6691.5000 (x86)] Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable X-Source-IP: userv0021.oracle.com [156.151.31.71] X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 21315 X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -2.3 (--) ping At least make clear that what is said about REGION is only for calls from Lisp. REGION is always non-nil when used interactively. From debbugs-submit-bounces@debbugs.gnu.org Sat Dec 05 18:22:38 2015 Received: (at 21315) by debbugs.gnu.org; 5 Dec 2015 23:22:38 +0000 Received: from localhost ([127.0.0.1]:40165 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1a5MA2-0000ix-9n for submit@debbugs.gnu.org; Sat, 05 Dec 2015 18:22:38 -0500 Received: from sub3.mail.dreamhost.com ([69.163.253.7]:50784 helo=homiemail-a15.g.dreamhost.com) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1a5MA0-0000io-7i for 21315@debbugs.gnu.org; Sat, 05 Dec 2015 18:22:36 -0500 Received: from homiemail-a15.g.dreamhost.com (localhost [127.0.0.1]) by homiemail-a15.g.dreamhost.com (Postfix) with ESMTP id 919EC76C069; Sat, 5 Dec 2015 15:22:35 -0800 (PST) Received: from localhost.linkov.net (m91-129-116-187.cust.tele2.ee [91.129.116.187]) (Authenticated sender: jurta@jurta.org) by homiemail-a15.g.dreamhost.com (Postfix) with ESMTPA id 8284F76C065; Sat, 5 Dec 2015 15:22:34 -0800 (PST) From: Juri Linkov To: Drew Adams Subject: Re: bug#21315: 25.0.50; doc of `kill-ring-save', `copy-region-as-kill' - bad Organization: LINKOV.NET References: <0fc80688-9028-4715-b2d9-a4bce4439a3b@default> Date: Sun, 06 Dec 2015 01:12:32 +0200 In-Reply-To: <0fc80688-9028-4715-b2d9-a4bce4439a3b@default> (Drew Adams's message of "Fri, 4 Dec 2015 10:06:05 -0800 (PST)") Message-ID: <87y4d8cwwv.fsf@mail.linkov.net> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/25.1.50 (x86_64-pc-linux-gnu) MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: -0.7 (/) X-Debbugs-Envelope-To: 21315 Cc: 21315@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -0.7 (/) > ping > > At least make clear that what is said about REGION is only > for calls from Lisp. REGION is always non-nil when used > interactively. Maybe REGION should be non-nil only when used on a non-contiguous (rectangular) region? From debbugs-submit-bounces@debbugs.gnu.org Sat Dec 05 21:14:01 2015 Received: (at 21315) by debbugs.gnu.org; 6 Dec 2015 02:14:01 +0000 Received: from localhost ([127.0.0.1]:40212 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1a5Ops-0004uB-Nu for submit@debbugs.gnu.org; Sat, 05 Dec 2015 21:14:00 -0500 Received: from userp1040.oracle.com ([156.151.31.81]:40690) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1a5OpY-0004th-6F for 21315@debbugs.gnu.org; Sat, 05 Dec 2015 21:13:59 -0500 Received: from userv0022.oracle.com (userv0022.oracle.com [156.151.31.74]) by userp1040.oracle.com (Sentrion-MTA-4.3.2/Sentrion-MTA-4.3.2) with ESMTP id tB62DcnM015212 (version=TLSv1 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Sun, 6 Dec 2015 02:13:38 GMT Received: from userv0121.oracle.com (userv0121.oracle.com [156.151.31.72]) by userv0022.oracle.com (8.13.8/8.13.8) with ESMTP id tB62Db5H031105 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=FAIL); Sun, 6 Dec 2015 02:13:37 GMT Received: from abhmp0017.oracle.com (abhmp0017.oracle.com [141.146.116.23]) by userv0121.oracle.com (8.13.8/8.13.8) with ESMTP id tB62DaHk012852; Sun, 6 Dec 2015 02:13:36 GMT MIME-Version: 1.0 Message-ID: Date: Sat, 5 Dec 2015 18:13:37 -0800 (PST) From: Drew Adams To: Juri Linkov Subject: RE: bug#21315: 25.0.50; doc of `kill-ring-save', `copy-region-as-kill' - bad References: <0fc80688-9028-4715-b2d9-a4bce4439a3b@default> <87y4d8cwwv.fsf@mail.linkov.net> In-Reply-To: <87y4d8cwwv.fsf@mail.linkov.net> X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9 (901082) [OL 12.0.6691.5000 (x86)] Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable X-Source-IP: userv0022.oracle.com [156.151.31.74] X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 21315 Cc: 21315@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -2.3 (--) > > At least make clear that what is said about REGION is only > > for calls from Lisp. REGION is always non-nil when used > > interactively. >=20 > Maybe REGION should be non-nil only when used on a non-contiguous > (rectangular) region? Maybe; dunno. The doc is not clear; that's all I can tell. From debbugs-submit-bounces@debbugs.gnu.org Sun Dec 06 11:15:35 2015 Received: (at 21315) by debbugs.gnu.org; 6 Dec 2015 16:15:35 +0000 Received: from localhost ([127.0.0.1]:40915 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1a5byI-0002lb-NU for submit@debbugs.gnu.org; Sun, 06 Dec 2015 11:15:34 -0500 Received: from mtaout24.012.net.il ([80.179.55.180]:46708) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1a5bxx-0002l5-M2 for 21315@debbugs.gnu.org; Sun, 06 Dec 2015 11:15:32 -0500 Received: from conversion-daemon.mtaout24.012.net.il by mtaout24.012.net.il (HyperSendmail v2007.08) id <0NYY009001QLUO00@mtaout24.012.net.il> for 21315@debbugs.gnu.org; Sun, 06 Dec 2015 18:08:00 +0200 (IST) Received: from HOME-C4E4A596F7 ([84.94.185.246]) by mtaout24.012.net.il (HyperSendmail v2007.08) with ESMTPA id <0NYY006GE25CL040@mtaout24.012.net.il>; Sun, 06 Dec 2015 18:08:00 +0200 (IST) Date: Sun, 06 Dec 2015 18:15:05 +0200 From: Eli Zaretskii Subject: Re: bug#21315: 25.0.50; doc of `kill-ring-save', `copy-region-as-kill' - bad In-reply-to: X-012-Sender: halo1@inter.net.il To: Drew Adams Message-id: <83si3feepi.fsf@gnu.org> References: <0fc80688-9028-4715-b2d9-a4bce4439a3b@default> <87y4d8cwwv.fsf@mail.linkov.net> X-Spam-Score: 0.9 (/) X-Debbugs-Envelope-To: 21315 Cc: 21315@debbugs.gnu.org, juri@linkov.net X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list Reply-To: Eli Zaretskii List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: 0.9 (/) > Date: Sat, 5 Dec 2015 18:13:37 -0800 (PST) > From: Drew Adams > Cc: 21315@debbugs.gnu.org > > > > At least make clear that what is said about REGION is only > > > for calls from Lisp. REGION is always non-nil when used > > > interactively. > > > > Maybe REGION should be non-nil only when used on a non-contiguous > > (rectangular) region? > > Maybe; dunno. The doc is not clear; that's all I can tell. Would it become clear if instead of this: The optional argument REGION if non-nil, indicates that we're not just copying some text between BEG and END, but we're copying the region. it would say this: The optional argument REGION non-nil means to ignore BEG and END and copy the region instead. Also, we should tell that this distinction is only relevant to invoking these functions from Lisp programs, not interactively. As for the argument, AFAICT it makes no difference in interactive usage. kill-region make it very clear: (interactive (list (mark) (point) 'region)) Does documenting the above clarify the issue? From debbugs-submit-bounces@debbugs.gnu.org Sun Dec 06 11:16:05 2015 Received: (at 21315) by debbugs.gnu.org; 6 Dec 2015 16:16:05 +0000 Received: from localhost ([127.0.0.1]:40919 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1a5byn-0002ms-Fk for submit@debbugs.gnu.org; Sun, 06 Dec 2015 11:16:05 -0500 Received: from mtaout29.012.net.il ([80.179.55.185]:50447) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1a5byl-0002mj-R9 for 21315@debbugs.gnu.org; Sun, 06 Dec 2015 11:16:04 -0500 Received: from conversion-daemon.mtaout29.012.net.il by mtaout29.012.net.il (HyperSendmail v2007.08) id <0NYY00C0025LL200@mtaout29.012.net.il> for 21315@debbugs.gnu.org; Sun, 06 Dec 2015 18:15:35 +0200 (IST) Received: from HOME-C4E4A596F7 ([84.94.185.246]) by mtaout29.012.net.il (HyperSendmail v2007.08) with ESMTPA id <0NYY006I22HYOC60@mtaout29.012.net.il>; Sun, 06 Dec 2015 18:15:34 +0200 (IST) Date: Sun, 06 Dec 2015 18:15:30 +0200 From: Eli Zaretskii Subject: Re: bug#21315: 25.0.50; doc of `kill-ring-save', `copy-region-as-kill' - bad In-reply-to: <87y4d8cwwv.fsf@mail.linkov.net> X-012-Sender: halo1@inter.net.il To: Juri Linkov Message-id: <83r3izeeot.fsf@gnu.org> References: <0fc80688-9028-4715-b2d9-a4bce4439a3b@default> <87y4d8cwwv.fsf@mail.linkov.net> X-Spam-Score: 0.9 (/) X-Debbugs-Envelope-To: 21315 Cc: 21315@debbugs.gnu.org, drew.adams@oracle.com X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list Reply-To: Eli Zaretskii List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: 0.9 (/) > From: Juri Linkov > Date: Sun, 06 Dec 2015 01:12:32 +0200 > Cc: 21315@debbugs.gnu.org > > > ping > > > > At least make clear that what is said about REGION is only > > for calls from Lisp. REGION is always non-nil when used > > interactively. > > Maybe REGION should be non-nil only when used on a non-contiguous > (rectangular) region? How do you see that? From debbugs-submit-bounces@debbugs.gnu.org Sun Dec 06 11:55:08 2015 Received: (at 21315) by debbugs.gnu.org; 6 Dec 2015 16:55:09 +0000 Received: from localhost ([127.0.0.1]:40924 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1a5caa-0003k2-Lq for submit@debbugs.gnu.org; Sun, 06 Dec 2015 11:55:08 -0500 Received: from userp1040.oracle.com ([156.151.31.81]:29418) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1a5caH-0003jH-3n for 21315@debbugs.gnu.org; Sun, 06 Dec 2015 11:55:07 -0500 Received: from userv0021.oracle.com (userv0021.oracle.com [156.151.31.71]) by userp1040.oracle.com (Sentrion-MTA-4.3.2/Sentrion-MTA-4.3.2) with ESMTP id tB6Gslpu004178 (version=TLSv1 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Sun, 6 Dec 2015 16:54:47 GMT Received: from aserv0122.oracle.com (aserv0122.oracle.com [141.146.126.236]) by userv0021.oracle.com (8.13.8/8.13.8) with ESMTP id tB6GskTH024024 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=FAIL); Sun, 6 Dec 2015 16:54:47 GMT Received: from abhmp0015.oracle.com (abhmp0015.oracle.com [141.146.116.21]) by aserv0122.oracle.com (8.13.8/8.13.8) with ESMTP id tB6GskIP030105; Sun, 6 Dec 2015 16:54:46 GMT MIME-Version: 1.0 Message-ID: <92143779-adfc-46ac-ac0d-2ba02174bb1a@default> Date: Sun, 6 Dec 2015 08:54:44 -0800 (PST) From: Drew Adams To: Eli Zaretskii , Drew Adams Subject: RE: bug#21315: 25.0.50; doc of `kill-ring-save', `copy-region-as-kill' - bad References: <> <<0fc80688-9028-4715-b2d9-a4bce4439a3b@default>> <<87y4d8cwwv.fsf@mail.linkov.net>> <> <<83si3feepi.fsf@gnu.org>> In-Reply-To: <<83si3feepi.fsf@gnu.org>> X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9 (901082) [OL 12.0.6691.5000 (x86)] Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable X-Source-IP: userv0021.oracle.com [156.151.31.71] X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 21315 Cc: 21315@debbugs.gnu.org, juri@linkov.net X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -2.3 (--) > say this: > The optional argument REGION non-nil means to ignore BEG and END and > copy the region instead. Yes. (But I think we usually phrase that as: "Non-nil optional argument REGION means...".) > Also, we should tell that this distinction is only relevant to > invoking these functions from Lisp programs, not interactively. Yes. From Lisp, non-nil optional argument REGION means... > As for the argument, AFAICT it makes no difference in interactive > usage. Yes, it is always non-nil interactively: `prefix-numeric-value' never returns nil. > Does documenting the above clarify the issue? Yes, I think so. Thx. From debbugs-submit-bounces@debbugs.gnu.org Mon Dec 07 11:23:33 2015 Received: (at 21315-done) by debbugs.gnu.org; 7 Dec 2015 16:23:33 +0000 Received: from localhost ([127.0.0.1]:41877 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1a5yZZ-0006dV-68 for submit@debbugs.gnu.org; Mon, 07 Dec 2015 11:23:33 -0500 Received: from mtaout27.012.net.il ([80.179.55.183]:54600) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1a5yZE-0006d4-GG for 21315-done@debbugs.gnu.org; Mon, 07 Dec 2015 11:23:31 -0500 Received: from conversion-daemon.mtaout27.012.net.il by mtaout27.012.net.il (HyperSendmail v2007.08) id <0NYZ00300X50UU00@mtaout27.012.net.il> for 21315-done@debbugs.gnu.org; Mon, 07 Dec 2015 18:18:20 +0200 (IST) Received: from HOME-C4E4A596F7 ([84.94.185.246]) by mtaout27.012.net.il (HyperSendmail v2007.08) with ESMTPA id <0NYZ002MCXAKG610@mtaout27.012.net.il>; Mon, 07 Dec 2015 18:18:20 +0200 (IST) Date: Mon, 07 Dec 2015 18:23:06 +0200 From: Eli Zaretskii Subject: Re: bug#21315: 25.0.50; doc of `kill-ring-save', `copy-region-as-kill' - bad In-reply-to: <92143779-adfc-46ac-ac0d-2ba02174bb1a@default> X-012-Sender: halo1@inter.net.il To: Drew Adams Message-id: <83a8pmdy8l.fsf@gnu.org> References: <0fc80688-9028-4715-b2d9-a4bce4439a3b@default> <87y4d8cwwv.fsf@mail.linkov.net> <83si3feepi.fsf@gnu.org> <92143779-adfc-46ac-ac0d-2ba02174bb1a@default> X-Spam-Score: 0.9 (/) X-Debbugs-Envelope-To: 21315-done Cc: 21315-done@debbugs.gnu.org, juri@linkov.net X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list Reply-To: Eli Zaretskii List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: 0.9 (/) > Date: Sun, 6 Dec 2015 08:54:44 -0800 (PST) > From: Drew Adams > Cc: juri@linkov.net, 21315@debbugs.gnu.org > > > say this: > > The optional argument REGION non-nil means to ignore BEG and END and > > copy the region instead. > > Yes. > > (But I think we usually phrase that as: "Non-nil optional argument > REGION means...".) > > > Also, we should tell that this distinction is only relevant to > > invoking these functions from Lisp programs, not interactively. > > Yes. > > From Lisp, non-nil optional argument REGION means... > > > As for the argument, AFAICT it makes no difference in interactive > > usage. > > Yes, it is always non-nil interactively: `prefix-numeric-value' > never returns nil. > > > Does documenting the above clarify the issue? > > Yes, I think so. Thx. Thanks, I made all the changes. I also added a reference to filter-buffer-substring in these doc strings, something that should have been done almost 11 years ago. The ELisp manual is also updated. From debbugs-submit-bounces@debbugs.gnu.org Mon Dec 07 19:51:40 2015 Received: (at 21315) by debbugs.gnu.org; 8 Dec 2015 00:51:40 +0000 Received: from localhost ([127.0.0.1]:42178 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1a66VG-00050n-Fm for submit@debbugs.gnu.org; Mon, 07 Dec 2015 19:51:39 -0500 Received: from sub3.mail.dreamhost.com ([69.163.253.7]:33292 helo=homiemail-a22.g.dreamhost.com) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1a66Uy-00050G-RL for 21315@debbugs.gnu.org; Mon, 07 Dec 2015 19:51:35 -0500 Received: from homiemail-a22.g.dreamhost.com (localhost [127.0.0.1]) by homiemail-a22.g.dreamhost.com (Postfix) with ESMTP id 48F131A8063; Mon, 7 Dec 2015 16:51:20 -0800 (PST) Received: from localhost.linkov.net (m83-180-31-224.cust.tele2.ee [83.180.31.224]) (Authenticated sender: jurta@jurta.org) by homiemail-a22.g.dreamhost.com (Postfix) with ESMTPA id 266321A805F; Mon, 7 Dec 2015 16:51:18 -0800 (PST) From: Juri Linkov To: Eli Zaretskii Subject: Re: bug#21315: 25.0.50; doc of `kill-ring-save', `copy-region-as-kill' - bad Organization: LINKOV.NET References: <0fc80688-9028-4715-b2d9-a4bce4439a3b@default> <87y4d8cwwv.fsf@mail.linkov.net> <83r3izeeot.fsf@gnu.org> Date: Tue, 08 Dec 2015 02:49:32 +0200 In-Reply-To: <83r3izeeot.fsf@gnu.org> (Eli Zaretskii's message of "Sun, 06 Dec 2015 18:15:30 +0200") Message-ID: <878u55sr1f.fsf@mail.linkov.net> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/25.1.50 (x86_64-pc-linux-gnu) MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: -0.7 (/) X-Debbugs-Envelope-To: 21315 Cc: 21315@debbugs.gnu.org, drew.adams@oracle.com X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -0.7 (/) >> > At least make clear that what is said about REGION is only >> > for calls from Lisp. REGION is always non-nil when used >> > interactively. >> >> Maybe REGION should be non-nil only when used on a non-contiguous >> (rectangular) region? > > How do you see that? I thought this arg should have the same meaning as in other rectangular commands, but let's discuss this on the corresponding subject in emacs-devel. From unknown Sun Jun 22 22:41:46 2025 Received: (at fakecontrol) by fakecontrolmessage; To: internal_control@debbugs.gnu.org From: Debbugs Internal Request Subject: Internal Control Message-Id: bug archived. Date: Tue, 05 Jan 2016 12:24:03 +0000 User-Agent: Fakemail v42.6.9 # This is a fake control message. # # The action: # bug archived. thanks # This fakemail brought to you by your local debbugs # administrator