Commit 7bef426b authored by Xue Fuqiao's avatar Xue Fuqiao
Browse files

Advertise using `kill-new' and `kill-append' in Lisp programs.

* lisp/simple.el (copy-region-as-kill, kill-ring-save): Advertise using
`kill-new' and `kill-append' in Lisp programs.
parent 86837e81
......@@ -109,6 +109,8 @@ number of characters. If the numeric argument is omitted or one, they
delete all the text in the region if it is active (@pxref{Using
Region}).
@c FIXME: `cycle-spacing' should be documented, too. (Maybe not in
@c this node, tho.) --xfq
@kindex M-\
@findex delete-horizontal-space
@kindex M-SPC
......
......@@ -779,6 +779,7 @@ is deleted. If point is on a nonblank line, the command deletes all
blank lines immediately following it.
A blank line is defined as a line containing only tabs and spaces.
@c and the Newline character?
@code{delete-blank-lines} returns @code{nil}.
@end deffn
......
......@@ -23,6 +23,11 @@
New functions.
(image-animate-timeout): Respect image :speed property.
2013-08-16 Xue Fuqiao <xfq.free@gmail.com>
* simple.el (copy-region-as-kill, kill-ring-save): Advertise using
`kill-new' and `kill-append' in Lisp programs.
2013-08-15 Stefan Monnier <monnier@iro.umontreal.ca>
* emacs-lisp/debug.el (debugger-setup-buffer): Put point on the
......
......@@ -3622,7 +3622,10 @@ In Transient Mark mode, deactivate the mark.
If `interprogram-cut-function' is non-nil, also save the text for a window
system cut and paste.
This command's old key binding has been given to `kill-ring-save'."
This command's old key binding has been given to `kill-ring-save'.
Do not use this function in Lisp programs, use `kill-new' or
`kill-append' instead."
(interactive "r")
(if (eq last-command 'kill-region)
(kill-append (filter-buffer-substring beg end) (< end beg))
......@@ -3640,7 +3643,10 @@ If you want to append the killed line to the last killed text,
use \\[append-next-kill] before \\[kill-ring-save].
This command is similar to `copy-region-as-kill', except that it gives
visual feedback indicating the extent of the region being copied."
visual feedback indicating the extent of the region being copied.
Do not use this function in Lisp programs, use `kill-new' or
`kill-append' instead."
(interactive "r")
(copy-region-as-kill beg end)
;; This use of called-interactively-p is correct because the code it
......
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment