comparison man/killing.texi @ 68510:80b042d12556

Minor clarifications. Refer to "graphical" terminals, rather than window systems.

68509:ab50d02721ae

Delete next character (@code{delete-char}).  If your keyboard has a
@key{DELETE} function key (usually located in the edit keypad), Emacs
binds it to @code{delete-char} as well.
@item @key{DEL}
@itemx @key{BS}
Delete previous character (@code{delete-backward-char}).  Some keyboards
refer to this key as a ``backspace key'' and label it with a left arrow.
@item M-\
Delete spaces and tabs around point (@code{delete-horizontal-space}).
@item M-@key{SPC}
Delete spaces and tabs around point, leaving one space
(@code{just-one-space}).

kill instead, since they can erase more than one character this way.

@kindex BACKSPACE
@kindex BS
@kindex DELETE
  Every keyboard has a large key, labeled @key{DEL}, @key{BACKSPACE},
@key{BS} or @key{DELETE}, which is a short distance above the
@key{RET} or @key{ENTER} key and is normally used for erasing what you
have typed.  Regardless of the actual name on the key, in Emacs it is
equivalent to @key{DEL}---or it should be.

  Many keyboards (including standard PC keyboards) have a
@key{BACKSPACE} key a short ways above @key{RET} or @key{ENTER}, and a
@key{DELETE} key elsewhere.  In that case, the @key{BACKSPACE} key is
@key{DEL}, and the @key{DELETE} key is equivalent to @kbd{C-d}---or it

and @kbd{M-d} (@pxref{Words}); balanced expressions, with @kbd{C-M-k}
(@pxref{Expressions}); and sentences, with @kbd{C-x @key{DEL}} and
@kbd{M-k} (@pxref{Sentences}).@refill

@node Graphical Kill
@subsection Killing on Graphical Terminals

  On multi-window terminals, the most recent kill done in Emacs is
also the primary selection, if it is more recent than any selection
you made in another program.  This means that the paste commands of
other applications with separate windows copy the text that you killed
in Emacs.  In addition, Emacs yank commands treat other applications'
selections as part of the kill ring, so you can yank them into Emacs.

@cindex Delete Selection mode
@cindex mode, Delete Selection
@findex delete-selection-mode
  Many window systems follow the convention that insertion while text
is selected deletes the selected text.  You can make Emacs behave this
way by enabling Delete Selection mode, with @kbd{M-x
delete-selection-mode}, or using Custom.  Another effect of this mode
is that @key{DEL}, @kbd{C-d} and some other keys, when a selection
exists, will kill the whole selection.  It also enables Transient Mark
mode (@pxref{Transient Mark}).

@node Yanking, Accumulating Text, Killing, Top

(@code{kill-ring-save}).  Some systems call this ``copying''.
@item C-M-w
Append next kill to last batch of killed text (@code{append-next-kill}).
@end table

  On window systems, if there is a current selection in some other
application, and you selected it more recently than you killed any
text in Emacs, @kbd{C-y} copies the selection instead of text
killed within Emacs.

@menu
* Kill Ring::		Where killed text is stored.  Basic yanking.
* Appending Kills::	Several kills in a row all yank together.
* Earlier Kills::	Yanking something killed some time ago.

  Note that ``killing'' a rectangle is not killing in the usual sense; the
rectangle is not stored in the kill ring, but in a special place that
can only record the most recent rectangle killed.  This is because yanking
a rectangle is so different from yanking linear text that different yank
commands have to be used and yank-popping is hard to make sense of.

@kindex C-x r y
@findex yank-rectangle
  To yank the last killed rectangle, type @kbd{C-x r y}
(@code{yank-rectangle}).  Yanking a rectangle is the opposite of killing

compatible with the Common User Access (CUA) system used in many other
applications.  @kbd{C-x} means cut (kill), @kbd{C-c} copy, @kbd{C-v}
paste (yank), and @kbd{C-z} undo.  Standard Emacs commands like
@kbd{C-x C-c} still work, because @kbd{C-x} and @kbd{C-c} only take
effect when the mark is active (and the region is highlighted).
However, if you don't want these bindings at all, set
@code{cua-enable-cua-keys} to @code{nil}.

  In CUA mode, using @kbd{Shift} together with the movement keys
activates and highlights the region over which they move.  The
standard (unshifted) movement keys deactivate the mark, and typed text
replaces the active region as in Delete-Selection mode
(@pxref{Graphical Kill}).

  To run a command like @kbd{C-x C-f} while the mark is active, use
one of the following methods: either hold @kbd{Shift} together with
the prefix key, e.g. @kbd{S-C-x C-f}, or quickly type the prefix key
twice, e.g. @kbd{C-x C-x C-f}.

@cindex rectangle highlighting
  CUA mode provides enhanced rectangle support with visible
rectangle highlighting.  Use @kbd{C-RET} to start a rectangle,
extend it using the movement commands, and cut or copy it using

68510:80b042d12556

Delete next character (@code{delete-char}).  If your keyboard has a
@key{DELETE} function key (usually located in the edit keypad), Emacs
binds it to @code{delete-char} as well.
@item @key{DEL}
@itemx @key{BS}
Delete previous character (@code{delete-backward-char}).
@item M-\
Delete spaces and tabs around point (@code{delete-horizontal-space}).
@item M-@key{SPC}
Delete spaces and tabs around point, leaving one space
(@code{just-one-space}).

kill instead, since they can erase more than one character this way.

@kindex BACKSPACE
@kindex BS
@kindex DELETE
  Every keyboard has a large key which is a short distance above the
@key{RET} or @key{ENTER} key and is normally used for erasing what you
have typed.  It may be labeled @key{DEL}, @key{BACKSPACE}, @key{BS},
@key{DELETE}, or even with a left arrow.  Regardless of the label on
the key, in Emacs it called @key{DEL}, and it should delete one
character backwards.

  Many keyboards (including standard PC keyboards) have a
@key{BACKSPACE} key a short ways above @key{RET} or @key{ENTER}, and a
@key{DELETE} key elsewhere.  In that case, the @key{BACKSPACE} key is
@key{DEL}, and the @key{DELETE} key is equivalent to @kbd{C-d}---or it

and @kbd{M-d} (@pxref{Words}); balanced expressions, with @kbd{C-M-k}
(@pxref{Expressions}); and sentences, with @kbd{C-x @key{DEL}} and
@kbd{M-k} (@pxref{Sentences}).@refill

@node Graphical Kill
@subsection Killing on Graphical Displays

  On graphical displays with window systems, the most recent kill done
in Emacs is also the primary selection, if it is more recent than any
selection you made in another program.  This means that the paste
commands of other window-based applications copy the text that you
killed in Emacs.  In addition, Emacs yank commands treat other
applications' selections as part of the kill ring, so you can yank
them into Emacs.

@cindex Delete Selection mode
@cindex mode, Delete Selection
@findex delete-selection-mode
  Many window systems follow the convention that insertion while text
is selected deletes the selected text.  You can make Emacs behave this
way by enabling Delete Selection mode---with @kbd{M-x
delete-selection-mode} or using Custom.  Another effect of this mode
is that @key{DEL}, @kbd{C-d} and some other keys, when a selection
exists, will kill the whole selection.  It also enables Transient Mark
mode (@pxref{Transient Mark}).

@node Yanking, Accumulating Text, Killing, Top

(@code{kill-ring-save}).  Some systems call this ``copying''.
@item C-M-w
Append next kill to last batch of killed text (@code{append-next-kill}).
@end table

  On graphical displays with window systems, if there is a current
selection in some other application, and you selected it more recently
than you killed any text in Emacs, @kbd{C-y} copies the selection
instead of text killed within Emacs.

@menu
* Kill Ring::		Where killed text is stored.  Basic yanking.
* Appending Kills::	Several kills in a row all yank together.
* Earlier Kills::	Yanking something killed some time ago.

  Note that ``killing'' a rectangle is not killing in the usual sense; the
rectangle is not stored in the kill ring, but in a special place that
can only record the most recent rectangle killed.  This is because yanking
a rectangle is so different from yanking linear text that different yank
commands have to be used.  It is hard to define yank-popping for rectangles,
so we do not try.

@kindex C-x r y
@findex yank-rectangle
  To yank the last killed rectangle, type @kbd{C-x r y}
(@code{yank-rectangle}).  Yanking a rectangle is the opposite of killing

compatible with the Common User Access (CUA) system used in many other
applications.  @kbd{C-x} means cut (kill), @kbd{C-c} copy, @kbd{C-v}
paste (yank), and @kbd{C-z} undo.  Standard Emacs commands like
@kbd{C-x C-c} still work, because @kbd{C-x} and @kbd{C-c} only take
effect when the mark is active (and the region is highlighted).
However, if you don't want to override these bindings Emacs at all, set
@code{cua-enable-cua-keys} to @code{nil}.

  In CUA mode, using @kbd{Shift} together with the movement keys
activates and highlights the region over which they move.  The
standard (unshifted) movement keys deactivate the mark, and typed text
replaces the active region as in Delete-Selection mode
(@pxref{Graphical Kill}).

  To enter an Emacs command like @kbd{C-x C-f} while the mark is
active, use one of the following methods: either hold @kbd{Shift}
together with the prefix key, e.g. @kbd{S-C-x C-f}, or quickly type
the prefix key twice, e.g. @kbd{C-x C-x C-f}.

@cindex rectangle highlighting
  CUA mode provides enhanced rectangle support with visible
rectangle highlighting.  Use @kbd{C-RET} to start a rectangle,
extend it using the movement commands, and cut or copy it using