comparison man/killing.texi @ 36162:f657bb5a6cf5

Rewrite kill-read-only-ok, Delete Selection mode, replace-rectangle.

36161:f6ba7a00b9e1

@c This is part of the Emacs manual.
@c Copyright (C) 1985,86,87,93,94,95,97,2000 Free Software Foundation, Inc.
@c See file emacs.texi for copying conditions.
@iftex
@chapter Killing and Moving Text

  @dfn{Killing} means erasing text and copying it into the @dfn{kill

can use the @kbd{C-x u} (@code{undo}) command to undo it
(@pxref{Undo}).

@vindex kill-read-only-ok
@cindex read-only text, killing
  By default, Emacs does not allow to kill text in read-only buffers.
Setting the variable @code{kill-read-only-ok} to a non-@code{nil} value
overrides that.  To alert you to the fact that you killed read-only
text, Emacs prints a message to that effect in the echo area.

  When @code{kill-read-only-ok} is @code{nil}, Emacs beeps if you try to
kill text in a read-only buffers, but it puts the text you wanted to
kill into the kill ring anyway.  This means you can use kill commands to
copy text from read-only buffers.

  The delete commands include @kbd{C-d} (@code{delete-char}) and
@key{DEL} (@code{delete-backward-char}), which delete only one character at
a time, and those commands that delete only spaces or newlines.  Commands
that can destroy significant amounts of nontrivial data generally kill.

and @samp{delete} to say which they do.

@cindex Delete Selection mode
@cindex mode, Delete Selection
@findex delete-selection-mode
You can arrange for selected text to be killed when you insert something
and replaced by what you insert; this is the way many text interfaces
work.  To do this turn on Delete Selection mode. with @kbd{M-x
delete-selection-mode} or using Custom.  Also in Delete Selection mode
@key{DEL}, @kbd{C-d} and some other keys will just kill the whole
selection and Transient Mark mode is turned on (@pxref{Transient Mark}).

@menu
* Deletion::            Commands for deleting small amounts of text and
                          blank areas.
* Killing by Lines::    How to kill entire lines of text at one time.

Delete whitespace in each of the lines on the specified rectangle,
starting from the left edge column of the rectangle.
@item C-x r t @var{string} @key{RET}
Insert @var{string} on each line of the region-rectangle
(@code{string-rectangle}).
@end table

  The rectangle operations fall into two classes: commands deleting and
inserting rectangles, and commands for blank rectangles.

edge of the rectangle.  The right edge of the rectangle does not make
any difference to this command.

@kindex C-x r t
@findex string-rectangle
The command @kbd{C-x r t} (@code{M-x string-rectangle}) inserts a
string on each line of the region-rectangle before the rectangle,
shifting text right.

@findex replace-rectangle
The command @kbd{M-x replace-rectangle} is similar, but replaces the
original rectangle.  The string's width need not be the same as the
width of the rectangle.  If the string's width is less, the text after
the rectangle shifts left; if the string is wider than the rectangle,
the text after the rectangle shifts right.

36162:f657bb5a6cf5

@c This is part of the Emacs manual.
@c Copyright (C) 1985,86,87,93,94,95,97,00,2001 Free Software Foundation, Inc.
@c See file emacs.texi for copying conditions.
@iftex
@chapter Killing and Moving Text

  @dfn{Killing} means erasing text and copying it into the @dfn{kill

can use the @kbd{C-x u} (@code{undo}) command to undo it
(@pxref{Undo}).

@vindex kill-read-only-ok
@cindex read-only text, killing
  You cannot kill read-only text, since such text does not allow any
kind of modification.  But some users like to use the kill commands to
copy read-only text into the kill ring, without actually changing it.
If you set the variable @code{kill-read-only-ok} to a non-@code{nil}
value, the kill commands work specially in a read-only buffer: they
move over text, and copy it to the kill ring, without actually
deleting it from the buffer.  When this happens, a message in the echo
area tells you what is happening.

  The delete commands include @kbd{C-d} (@code{delete-char}) and
@key{DEL} (@code{delete-backward-char}), which delete only one character at
a time, and those commands that delete only spaces or newlines.  Commands
that can destroy significant amounts of nontrivial data generally kill.

and @samp{delete} to say which they do.

@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}).

@menu
* Deletion::            Commands for deleting small amounts of text and
                          blank areas.
* Killing by Lines::    How to kill entire lines of text at one time.

Delete whitespace in each of the lines on the specified rectangle,
starting from the left edge column of the rectangle.
@item C-x r t @var{string} @key{RET}
Insert @var{string} on each line of the region-rectangle
(@code{string-rectangle}).
@item M-x replace-rectangle @key{RET} @var{string} @key{RET}
Replaces each line of the region-rectangle with @var{string}
(@code{string-rectangle}).
@end table

  The rectangle operations fall into two classes: commands deleting and
inserting rectangles, and commands for blank rectangles.

edge of the rectangle.  The right edge of the rectangle does not make
any difference to this command.

@kindex C-x r t
@findex string-rectangle
  The command @kbd{C-x r t} (@code{M-x string-rectangle}) inserts a
string on each line of the region-rectangle before the rectangle,
shifting text right.

@findex replace-rectangle
  The command @kbd{M-x replace-rectangle} is similar to @kbd{C-x r t},
but replaces the original rectangle.  The string's width need not be
the same as the width of the rectangle.  If the string's width is
less, the text after the rectangle shifts left; if the string is wider
than the rectangle, the text after the rectangle shifts right.