From: Chong Yidong <cyd@gnu.org>
Date: Tue, 17 Dec 2013 15:57:38 +0000 (+0800)
Subject: * killing.texi (Appending Kills): Note that append-next-kill can prepend the kill.
X-Git-Tag: emacs-24.3.90~173^2^2~42^2~45^2~387^2~369
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=9718dea2e16ce975d2cda02985ed2349f2d7a085;p=emacs.git

* killing.texi (Appending Kills): Note that append-next-kill can prepend the kill.
---

diff --git a/doc/emacs/ChangeLog b/doc/emacs/ChangeLog
index c765d479385..c5330da779b 100644
--- a/doc/emacs/ChangeLog
+++ b/doc/emacs/ChangeLog
@@ -1,3 +1,8 @@
+2013-12-17  Chong Yidong  <cyd@gnu.org>
+
+	* killing.texi (Appending Kills): Note that append-next-kill can
+	prepend the kill.
+
 2013-12-12  Eli Zaretskii  <eliz@gnu.org>
 
 	* mule.texi (File Name Coding): Document file-name encoding
diff --git a/doc/emacs/killing.texi b/doc/emacs/killing.texi
index 30b3a2c5ff0..5f2b5aa6605 100644
--- a/doc/emacs/killing.texi
+++ b/doc/emacs/killing.texi
@@ -417,13 +417,15 @@ killed it.
 @kindex C-M-w
 @findex append-next-kill
   If a kill command is separated from the last kill command by other
-commands (not just numeric arguments), it starts a new entry on the kill
-ring.  But you can force it to append by first typing the command
-@kbd{C-M-w} (@code{append-next-kill}) right before it.  The @kbd{C-M-w}
-tells the following command, if it is a kill command, to append the text
-it kills to the last killed text, instead of starting a new entry.  With
-@kbd{C-M-w}, you can kill several separated pieces of text and
-accumulate them to be yanked back in one place.
+commands (not just numeric arguments), it starts a new entry on the
+kill ring.  But you can force it to combine with the last killed text,
+by typing @kbd{C-M-w} (@code{append-next-kill}) right beforehand.  The
+@kbd{C-M-w} tells its following command, if it is a kill command, to
+treat the kill as part of the sequence of previous kills.  As usual,
+the kill is appended to the previous killed text if the command kills
+forward, and prepended if the command kills backward.  In this way,
+you can kill several separated pieces of text and accumulate them to
+be yanked back in one place.
 
   A kill command following @kbd{M-w} (@code{kill-ring-save}) does not
 append to the text that @kbd{M-w} copied into the kill ring.