From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.bugs Subject: bug#21315: 25.0.50; doc of `kill-ring-save', `copy-region-as-kill' - bad Date: Sun, 06 Dec 2015 18:15:05 +0200 Message-ID: <83si3feepi.fsf@gnu.org> References: <0fc80688-9028-4715-b2d9-a4bce4439a3b@default> <87y4d8cwwv.fsf@mail.linkov.net> Reply-To: Eli Zaretskii NNTP-Posting-Host: plane.gmane.org X-Trace: ger.gmane.org 1449418584 10273 80.91.229.3 (6 Dec 2015 16:16:24 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sun, 6 Dec 2015 16:16:24 +0000 (UTC) Cc: 21315@debbugs.gnu.org, juri@linkov.net To: Drew Adams Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sun Dec 06 17:16:12 2015 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1a5bys-0005u7-TI for geb-bug-gnu-emacs@m.gmane.org; Sun, 06 Dec 2015 17:16:11 +0100 Original-Received: from localhost ([::1]:50247 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1a5bys-0002gl-8m for geb-bug-gnu-emacs@m.gmane.org; Sun, 06 Dec 2015 11:16:10 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:52691) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1a5byn-0002fl-Vg for bug-gnu-emacs@gnu.org; Sun, 06 Dec 2015 11:16:06 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1a5byk-0007ta-Pp for bug-gnu-emacs@gnu.org; Sun, 06 Dec 2015 11:16:05 -0500 Original-Received: from debbugs.gnu.org ([208.118.235.43]:51207) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1a5byk-0007tQ-M9 for bug-gnu-emacs@gnu.org; Sun, 06 Dec 2015 11:16:02 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.80) (envelope-from ) id 1a5byj-0002mO-Vl for bug-gnu-emacs@gnu.org; Sun, 06 Dec 2015 11:16:02 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sun, 06 Dec 2015 16:16:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 21315 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Original-Received: via spool by 21315-submit@debbugs.gnu.org id=B21315.144941853510644 (code B ref 21315); Sun, 06 Dec 2015 16:16:01 +0000 Original-Received: (at 21315) by debbugs.gnu.org; 6 Dec 2015 16:15:35 +0000 Original-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 Original-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 Original-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) Original-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) In-reply-to: X-012-Sender: halo1@inter.net.il X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.x X-Received-From: 208.118.235.43 X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:109691 Archived-At: > 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?