From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Alan Mackenzie Newsgroups: gmane.emacs.bugs Subject: bug#4605: Description of `buffer-swap-text' is vague and inadequate. Date: Thu, 1 Oct 2009 09:48:54 +0000 Message-ID: <20091001094854.GB4599@muc.de> Reply-To: Alan Mackenzie , 4605@emacsbugs.donarmstrong.com NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: ger.gmane.org 1254392212 25944 80.91.229.12 (1 Oct 2009 10:16:52 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Thu, 1 Oct 2009 10:16:52 +0000 (UTC) To: Stefan Monnier , bug-gnu-emacs@gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Thu Oct 01 12:16:45 2009 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by lo.gmane.org with esmtp (Exim 4.50) id 1MtIiH-0002bY-45 for geb-bug-gnu-emacs@m.gmane.org; Thu, 01 Oct 2009 12:16:41 +0200 Original-Received: from localhost ([127.0.0.1]:43714 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1MtIiG-0000j4-FU for geb-bug-gnu-emacs@m.gmane.org; Thu, 01 Oct 2009 06:16:40 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1MtIZA-0001V2-Tt for bug-gnu-emacs@gnu.org; Thu, 01 Oct 2009 06:07:17 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1MtIZ5-0001Qb-2z for bug-gnu-emacs@gnu.org; Thu, 01 Oct 2009 06:07:15 -0400 Original-Received: from [199.232.76.173] (port=38276 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1MtIZ4-0001QQ-Qp for bug-gnu-emacs@gnu.org; Thu, 01 Oct 2009 06:07:10 -0400 Original-Received: from rzlab.ucr.edu ([138.23.92.77]:36212) by monty-python.gnu.org with esmtps (TLS-1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1MtIZ4-0001jO-0h for bug-gnu-emacs@gnu.org; Thu, 01 Oct 2009 06:07:10 -0400 Original-Received: from rzlab.ucr.edu (rzlab.ucr.edu [127.0.0.1]) by rzlab.ucr.edu (8.14.3/8.14.3/Debian-5) with ESMTP id n91A7745002417; Thu, 1 Oct 2009 03:07:07 -0700 Original-Received: (from debbugs@localhost) by rzlab.ucr.edu (8.14.3/8.14.3/Submit) id n919t8Hj032295; Thu, 1 Oct 2009 02:55:08 -0700 Resent-Date: Thu, 1 Oct 2009 02:55:08 -0700 X-Loop: owner@emacsbugs.donarmstrong.com Resent-From: Alan Mackenzie Resent-To: bug-submit-list@donarmstrong.com Resent-CC: Emacs Bugs 2Resent-Date: Thu, 01 Oct 2009 09:55:07 +0000 Resent-Message-ID: Resent-Sender: owner@emacsbugs.donarmstrong.com X-Emacs-PR-Message: report 4605 X-Emacs-PR-Package: emacs X-Emacs-PR-Keywords: Original-Received: via spool by submit@emacsbugs.donarmstrong.com id=B.125439031631389 (code B ref -1); Thu, 01 Oct 2009 09:55:07 +0000 Original-Received: (at submit) by emacsbugs.donarmstrong.com; 1 Oct 2009 09:45:16 +0000 X-Spam-Bayes: score:0.5 Bayes not run. spammytokens:Tokens not available. hammytokens:Tokens not available. Original-Received: from lists.gnu.org (lists.gnu.org [199.232.76.165]) by rzlab.ucr.edu (8.14.3/8.14.3/Debian-5) with ESMTP id n919jDer031285 for ; Thu, 1 Oct 2009 02:45:16 -0700 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1MtIDp-0003CO-EI for bug-gnu-emacs@gnu.org; Thu, 01 Oct 2009 05:45:13 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1MtIDk-0003A7-5p for bug-gnu-emacs@gnu.org; Thu, 01 Oct 2009 05:45:12 -0400 Original-Received: from [199.232.76.173] (port=33150 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1MtIDj-0003A2-Rl for bug-gnu-emacs@gnu.org; Thu, 01 Oct 2009 05:45:07 -0400 Original-Received: from colin.muc.de ([193.149.48.1]:1427 helo=mail.muc.de) by monty-python.gnu.org with esmtps (TLS-1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1MtIDj-0006OX-DL for bug-gnu-emacs@gnu.org; Thu, 01 Oct 2009 05:45:07 -0400 Original-Received: (qmail 99997 invoked by uid 3782); 1 Oct 2009 09:45:01 -0000 Original-Received: from acm.muc.de (pD9E53DEE.dip.t-dialin.net [217.229.61.238]) by colin2.muc.de (tmda-ofmipd) with ESMTP; Thu, 01 Oct 2009 11:45:00 +0200 Original-Received: (qmail 5041 invoked by uid 1000); 1 Oct 2009 09:48:54 -0000 Content-Disposition: inline User-Agent: Mutt/1.5.9i X-Delivery-Agent: TMDA/1.1.5 (Fettercairn) X-Primary-Address: acm@muc.de X-detected-operating-system: by monty-python.gnu.org: FreeBSD 4.6-4.9 X-detected-operating-system: by monty-python.gnu.org: GNU/Linux 2.6 (newer, 2) Resent-Date: Thu, 01 Oct 2009 06:07:15 -0400 X-BeenThere: bug-gnu-emacs@gnu.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:31612 Archived-At: Hi, Stefan, Hi, Emacs! The Elisp manual page "Swapping Text", says that `buffer-swap-text' "swaps text between the current buffer and its argument BUFFER." This tells me nothing. I'd have to read the source (or maybe try it out) to find out what this function does. What does "swap" mean here? How much text is "swapped". What does "between" mean? A naive guess would suggest this command takes a bit of text out of buffer A and dumps it into buffer B, simultaneously moving a bit of B into A. There is also no entry in .../src/ChangeLog (or ChangeLog.10, ...) marking the introduction of this command. -- Alan Mackenzie (Nuremberg, Germany).