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

2 files changed, 15 insertions, 1 deletions

diff --git a/lisp/ChangeLog b/lisp/ChangeLog
index 43185a2acb2..3a86fff5e50 100644
--- 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 412d75f9221..61068efce59 100644
--- 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.