GNU bug report logs - #4605
Description of `buffer-swap-text' is vague and inadequate.

Previous Next

Full log

Message #5 received at submit <at> emacsbugs.donarmstrong.com (full text, mbox):

From: Alan Mackenzie <acm <at> muc.de>
To: Stefan Monnier <monnier <at> iro.umontreal.ca>, bug-gnu-emacs <at> gnu.org
Subject: Description of `buffer-swap-text' is vague and inadequate.
Date: Thu, 1 Oct 2009 09:48:54 +0000

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).

Previous Next

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