* simple.el (append-next-kill): Doc fix (Bug#15995, Bug#16016).

diff --git a/lisp/ChangeLog b/lisp/ChangeLog
index 43185a2acb28a4263e9efb48714138870eebc898..3a86fff5e5013150f63390f842458c9f6e2bde6e 100644 (file)
--- a/lisp/ChangeLog
+++ b/lisp/ChangeLog
@@ -1,3 +1,7 @@
+2013-12-18  Chong Yidong  <cyd@gnu.org>
+
+       * simple.el (append-next-kill): Doc fix (Bug#15995, Bug#16016).
+
 2013-12-18  Glenn Morris  <rgm@gnu.org>
 
        * mail/emacsbug.el (report-emacs-bug):

diff --git a/lisp/simple.el b/lisp/simple.el
index 412d75f922114e35b3a2f33e96932a2cbee98a9b..61068efce59191ebbe473d1e49ec1dd634bc28b0 100644 (file)
--- a/lisp/simple.el
+++ b/lisp/simple.el
@@ -3764,7 +3764,17 @@ of this sample text; it defaults to 40."
                   (buffer-substring-no-properties mark (+ mark len))))))))
 
 (defun append-next-kill (&optional interactive)
-  "Cause following command, if it kills, to append to previous kill.
+  "Cause following command, if it kills, to add to previous kill.
+If the next command kills forward from point, the kill is
+appended to the previous killed text.  If the command kills
+backward, the kill is prepended.  Kill commands that act on the
+region, such as `kill-region', are regarded as killing forward if
+point is after mark, and killing backward if point is before
+mark.
+
+If the next command is not a kill command, `append-next-kill' has
+no effect.
+
 The argument is used for internal purposes; do not supply one."
   (interactive "p")
   ;; We don't use (interactive-p), since that breaks kbd macros.