annotate man/killing.texi @ 72428:608323e2c0e3

*** empty log message ***
author Nick Roberts <nickrob@snap.net.nz>
date Thu, 17 Aug 2006 11:44:05 +0000
parents c7e4f78b81a6
children e282f9062d8d 858cb33ae39d
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1 @c This is part of the Emacs manual.
64890
3723093a21fd Update years in copyright notice; nfc.
Thien-Thi Nguyen <ttn@gnuvola.org>
parents: 62330
diff changeset
2 @c Copyright (C) 1985, 1986, 1987, 1993, 1994, 1995, 1997, 2000, 2001,
68639
dc2d5a6655a3 Update years in copyright notice; nfc.
Thien-Thi Nguyen <ttn@gnuvola.org>
parents: 68510
diff changeset
3 @c 2002, 2003, 2004, 2005, 2006 Free Software Foundation, Inc.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
4 @c See file emacs.texi for copying conditions.
59272
2d8dd256436f (Killing): Reorganize section.
Richard M. Stallman <rms@gnu.org>
parents: 56899
diff changeset
5
2d8dd256436f (Killing): Reorganize section.
Richard M. Stallman <rms@gnu.org>
parents: 56899
diff changeset
6 @node Killing, Yanking, Mark, Top
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
7 @chapter Killing and Moving Text
Dave Love <fx@gnu.org>
parents:
diff changeset
8
56810
24bffa640391 Adapt sectioning in Info to the node structure.
Luc Teirlinck <teirllm@auburn.edu>
parents: 56692
diff changeset
9 @ifnottex
24bffa640391 Adapt sectioning in Info to the node structure.
Luc Teirlinck <teirllm@auburn.edu>
parents: 56692
diff changeset
10 @raisesections
24bffa640391 Adapt sectioning in Info to the node structure.
Luc Teirlinck <teirllm@auburn.edu>
parents: 56692
diff changeset
11 @end ifnottex
24bffa640391 Adapt sectioning in Info to the node structure.
Luc Teirlinck <teirllm@auburn.edu>
parents: 56692
diff changeset
12
59272
2d8dd256436f (Killing): Reorganize section.
Richard M. Stallman <rms@gnu.org>
parents: 56899
diff changeset
13 @dfn{Killing} means erasing text and copying it into the @dfn{kill
2d8dd256436f (Killing): Reorganize section.
Richard M. Stallman <rms@gnu.org>
parents: 56899
diff changeset
14 ring}, from which you can bring it back into the buffer by
2d8dd256436f (Killing): Reorganize section.
Richard M. Stallman <rms@gnu.org>
parents: 56899
diff changeset
15 @dfn{yanking} it. (Some systems use the terms ``cutting'' and
2d8dd256436f (Killing): Reorganize section.
Richard M. Stallman <rms@gnu.org>
parents: 56899
diff changeset
16 ``pasting'' for these operations.) This is the most common way of
2d8dd256436f (Killing): Reorganize section.
Richard M. Stallman <rms@gnu.org>
parents: 56899
diff changeset
17 moving or copying text within Emacs. Killing and yanking is very safe
2d8dd256436f (Killing): Reorganize section.
Richard M. Stallman <rms@gnu.org>
parents: 56899
diff changeset
18 because Emacs remembers several recent kills, not just the last one.
2d8dd256436f (Killing): Reorganize section.
Richard M. Stallman <rms@gnu.org>
parents: 56899
diff changeset
19 It is versatile, because the many commands for killing syntactic units
2d8dd256436f (Killing): Reorganize section.
Richard M. Stallman <rms@gnu.org>
parents: 56899
diff changeset
20 can also be used for moving those units. But there are other ways of
2d8dd256436f (Killing): Reorganize section.
Richard M. Stallman <rms@gnu.org>
parents: 56899
diff changeset
21 copying text for special purposes.
2d8dd256436f (Killing): Reorganize section.
Richard M. Stallman <rms@gnu.org>
parents: 56899
diff changeset
22
2d8dd256436f (Killing): Reorganize section.
Richard M. Stallman <rms@gnu.org>
parents: 56899
diff changeset
23 @iftex
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
24 @section Deletion and Killing
59272
2d8dd256436f (Killing): Reorganize section.
Richard M. Stallman <rms@gnu.org>
parents: 56899
diff changeset
25 @end iftex
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
26
Dave Love <fx@gnu.org>
parents:
diff changeset
27 @cindex killing text
Dave Love <fx@gnu.org>
parents:
diff changeset
28 @cindex cutting text
Dave Love <fx@gnu.org>
parents:
diff changeset
29 @cindex deletion
59272
2d8dd256436f (Killing): Reorganize section.
Richard M. Stallman <rms@gnu.org>
parents: 56899
diff changeset
30 Most commands which erase text from the buffer save it in the kill
2d8dd256436f (Killing): Reorganize section.
Richard M. Stallman <rms@gnu.org>
parents: 56899
diff changeset
31 ring. These commands are known as @dfn{kill} commands. The commands
2d8dd256436f (Killing): Reorganize section.
Richard M. Stallman <rms@gnu.org>
parents: 56899
diff changeset
32 that erase text but do not save it in the kill ring are known as
2d8dd256436f (Killing): Reorganize section.
Richard M. Stallman <rms@gnu.org>
parents: 56899
diff changeset
33 @dfn{delete} commands. The @kbd{C-x u} (@code{undo}) command
2d8dd256436f (Killing): Reorganize section.
Richard M. Stallman <rms@gnu.org>
parents: 56899
diff changeset
34 (@pxref{Undo}) can undo both kill and delete commands; the importance
2d8dd256436f (Killing): Reorganize section.
Richard M. Stallman <rms@gnu.org>
parents: 56899
diff changeset
35 of the kill ring is that you can also yank the text in a different
2d8dd256436f (Killing): Reorganize section.
Richard M. Stallman <rms@gnu.org>
parents: 56899
diff changeset
36 place or places. Emacs has only one kill ring for all buffers, so you
2d8dd256436f (Killing): Reorganize section.
Richard M. Stallman <rms@gnu.org>
parents: 56899
diff changeset
37 can kill text in one buffer and yank it in another buffer.
2d8dd256436f (Killing): Reorganize section.
Richard M. Stallman <rms@gnu.org>
parents: 56899
diff changeset
38
2d8dd256436f (Killing): Reorganize section.
Richard M. Stallman <rms@gnu.org>
parents: 56899
diff changeset
39 The delete commands include @kbd{C-d} (@code{delete-char}) and
2d8dd256436f (Killing): Reorganize section.
Richard M. Stallman <rms@gnu.org>
parents: 56899
diff changeset
40 @key{DEL} (@code{delete-backward-char}), which delete only one
2d8dd256436f (Killing): Reorganize section.
Richard M. Stallman <rms@gnu.org>
parents: 56899
diff changeset
41 character at a time, and those commands that delete only spaces or
2d8dd256436f (Killing): Reorganize section.
Richard M. Stallman <rms@gnu.org>
parents: 56899
diff changeset
42 newlines. Commands that can erase significant amounts of nontrivial
2d8dd256436f (Killing): Reorganize section.
Richard M. Stallman <rms@gnu.org>
parents: 56899
diff changeset
43 data generally do a kill operation instead. The commands' names and
2d8dd256436f (Killing): Reorganize section.
Richard M. Stallman <rms@gnu.org>
parents: 56899
diff changeset
44 individual descriptions use the words @samp{kill} and @samp{delete} to
2d8dd256436f (Killing): Reorganize section.
Richard M. Stallman <rms@gnu.org>
parents: 56899
diff changeset
45 say which kind of operation they perform.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
46
30771
e9948dd313fa (Killing): Document kill-read-only-ok.
Eli Zaretskii <eliz@gnu.org>
parents: 27749
diff changeset
47 @vindex kill-read-only-ok
e9948dd313fa (Killing): Document kill-read-only-ok.
Eli Zaretskii <eliz@gnu.org>
parents: 27749
diff changeset
48 @cindex read-only text, killing
36162
f657bb5a6cf5 Rewrite kill-read-only-ok, Delete Selection mode, replace-rectangle.
Richard M. Stallman <rms@gnu.org>
parents: 35918
diff changeset
49 You cannot kill read-only text, since such text does not allow any
f657bb5a6cf5 Rewrite kill-read-only-ok, Delete Selection mode, replace-rectangle.
Richard M. Stallman <rms@gnu.org>
parents: 35918
diff changeset
50 kind of modification. But some users like to use the kill commands to
f657bb5a6cf5 Rewrite kill-read-only-ok, Delete Selection mode, replace-rectangle.
Richard M. Stallman <rms@gnu.org>
parents: 35918
diff changeset
51 copy read-only text into the kill ring, without actually changing it.
56899
36c1c98acd4b (Killing): Correct description of kill commands in read-only buffer.
Luc Teirlinck <teirllm@auburn.edu>
parents: 56810
diff changeset
52 Therefore, the kill commands work specially in a read-only buffer:
36c1c98acd4b (Killing): Correct description of kill commands in read-only buffer.
Luc Teirlinck <teirllm@auburn.edu>
parents: 56810
diff changeset
53 they move over text, and copy it to the kill ring, without actually
59272
2d8dd256436f (Killing): Reorganize section.
Richard M. Stallman <rms@gnu.org>
parents: 56899
diff changeset
54 deleting it from the buffer. Normally, kill commands beep and display
2d8dd256436f (Killing): Reorganize section.
Richard M. Stallman <rms@gnu.org>
parents: 56899
diff changeset
55 an error message when this happens. But if you set the variable
2d8dd256436f (Killing): Reorganize section.
Richard M. Stallman <rms@gnu.org>
parents: 56899
diff changeset
56 @code{kill-read-only-ok} to a non-@code{nil} value, they just print a
2d8dd256436f (Killing): Reorganize section.
Richard M. Stallman <rms@gnu.org>
parents: 56899
diff changeset
57 message in the echo area to explain why the text has not been erased.
30865
fb3d8e6e0497 delete-selection-mode
Dave Love <fx@gnu.org>
parents: 30771
diff changeset
58
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
59 @menu
Dave Love <fx@gnu.org>
parents:
diff changeset
60 * Deletion:: Commands for deleting small amounts of text and
Dave Love <fx@gnu.org>
parents:
diff changeset
61 blank areas.
Dave Love <fx@gnu.org>
parents:
diff changeset
62 * Killing by Lines:: How to kill entire lines of text at one time.
Dave Love <fx@gnu.org>
parents:
diff changeset
63 * Other Kill Commands:: Commands to kill large regions of text and
49600
23a1cea22d13 Trailing whitespace deleted.
Juanma Barranquero <lekktu@gmail.com>
parents: 49330
diff changeset
64 syntactic units such as words and sentences.
70360
f6892919e3c9 (Killing): Say "graphical displays".
Richard M. Stallman <rms@gnu.org>
parents: 69828
diff changeset
65 * Graphical Kill:: The kill ring on graphical displays:
59272
2d8dd256436f (Killing): Reorganize section.
Richard M. Stallman <rms@gnu.org>
parents: 56899
diff changeset
66 yanking between applications.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
67 @end menu
Dave Love <fx@gnu.org>
parents:
diff changeset
68
37486
d7bf0f33e402 Add @need before Deletion node.
Richard M. Stallman <rms@gnu.org>
parents: 37447
diff changeset
69 @need 1500
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
70 @node Deletion
Dave Love <fx@gnu.org>
parents:
diff changeset
71 @subsection Deletion
Dave Love <fx@gnu.org>
parents:
diff changeset
72 @findex delete-backward-char
Dave Love <fx@gnu.org>
parents:
diff changeset
73 @findex delete-char
Dave Love <fx@gnu.org>
parents:
diff changeset
74
37887
1ebd03c6b468 Add some intro text in node Deletion.
Richard M. Stallman <rms@gnu.org>
parents: 37585
diff changeset
75 Deletion means erasing text and not saving it in the kill ring. For
1ebd03c6b468 Add some intro text in node Deletion.
Richard M. Stallman <rms@gnu.org>
parents: 37585
diff changeset
76 the most part, the Emacs commands that delete text are those that
1ebd03c6b468 Add some intro text in node Deletion.
Richard M. Stallman <rms@gnu.org>
parents: 37585
diff changeset
77 erase just one character or only whitespace.
1ebd03c6b468 Add some intro text in node Deletion.
Richard M. Stallman <rms@gnu.org>
parents: 37585
diff changeset
78
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
79 @table @kbd
Dave Love <fx@gnu.org>
parents:
diff changeset
80 @item C-d
68260
da161b813076 (Deletion): Upcase @key argument.
Richard M. Stallman <rms@gnu.org>
parents: 67605
diff changeset
81 @itemx @key{DELETE}
36657
0ee33338bb24 (Deletion): Mention the Delete vs Backspace keys. Document
Eli Zaretskii <eliz@gnu.org>
parents: 36162
diff changeset
82 Delete next character (@code{delete-char}). If your keyboard has a
68260
da161b813076 (Deletion): Upcase @key argument.
Richard M. Stallman <rms@gnu.org>
parents: 67605
diff changeset
83 @key{DELETE} function key (usually located in the edit keypad), Emacs
36657
0ee33338bb24 (Deletion): Mention the Delete vs Backspace keys. Document
Eli Zaretskii <eliz@gnu.org>
parents: 36162
diff changeset
84 binds it to @code{delete-char} as well.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
85 @item @key{DEL}
36657
0ee33338bb24 (Deletion): Mention the Delete vs Backspace keys. Document
Eli Zaretskii <eliz@gnu.org>
parents: 36162
diff changeset
86 @itemx @key{BS}
68510
80b042d12556 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 68260
diff changeset
87 Delete previous character (@code{delete-backward-char}).
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
88 @item M-\
Dave Love <fx@gnu.org>
parents:
diff changeset
89 Delete spaces and tabs around point (@code{delete-horizontal-space}).
Dave Love <fx@gnu.org>
parents:
diff changeset
90 @item M-@key{SPC}
Dave Love <fx@gnu.org>
parents:
diff changeset
91 Delete spaces and tabs around point, leaving one space
Dave Love <fx@gnu.org>
parents:
diff changeset
92 (@code{just-one-space}).
Dave Love <fx@gnu.org>
parents:
diff changeset
93 @item C-x C-o
Dave Love <fx@gnu.org>
parents:
diff changeset
94 Delete blank lines around the current line (@code{delete-blank-lines}).
Dave Love <fx@gnu.org>
parents:
diff changeset
95 @item M-^
Dave Love <fx@gnu.org>
parents:
diff changeset
96 Join two lines by deleting the intervening newline, along with any
Dave Love <fx@gnu.org>
parents:
diff changeset
97 indentation following it (@code{delete-indentation}).
Dave Love <fx@gnu.org>
parents:
diff changeset
98 @end table
Dave Love <fx@gnu.org>
parents:
diff changeset
99
36725
640fb21a2098 Clarify the text for BACKSPACE vs DELETE.
Richard M. Stallman <rms@gnu.org>
parents: 36720
diff changeset
100 @kindex DEL
640fb21a2098 Clarify the text for BACKSPACE vs DELETE.
Richard M. Stallman <rms@gnu.org>
parents: 36720
diff changeset
101 @kindex C-d
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
102 The most basic delete commands are @kbd{C-d} (@code{delete-char}) and
Dave Love <fx@gnu.org>
parents:
diff changeset
103 @key{DEL} (@code{delete-backward-char}). @kbd{C-d} deletes the
Dave Love <fx@gnu.org>
parents:
diff changeset
104 character after point, the one the cursor is ``on top of.'' This
Dave Love <fx@gnu.org>
parents:
diff changeset
105 doesn't move point. @key{DEL} deletes the character before the cursor,
Dave Love <fx@gnu.org>
parents:
diff changeset
106 and moves point back. You can delete newlines like any other characters
Dave Love <fx@gnu.org>
parents:
diff changeset
107 in the buffer; deleting a newline joins two lines. Actually, @kbd{C-d}
Dave Love <fx@gnu.org>
parents:
diff changeset
108 and @key{DEL} aren't always delete commands; when given arguments, they
Dave Love <fx@gnu.org>
parents:
diff changeset
109 kill instead, since they can erase more than one character this way.
Dave Love <fx@gnu.org>
parents:
diff changeset
110
36725
640fb21a2098 Clarify the text for BACKSPACE vs DELETE.
Richard M. Stallman <rms@gnu.org>
parents: 36720
diff changeset
111 @kindex BACKSPACE
640fb21a2098 Clarify the text for BACKSPACE vs DELETE.
Richard M. Stallman <rms@gnu.org>
parents: 36720
diff changeset
112 @kindex BS
640fb21a2098 Clarify the text for BACKSPACE vs DELETE.
Richard M. Stallman <rms@gnu.org>
parents: 36720
diff changeset
113 @kindex DELETE
68510
80b042d12556 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 68260
diff changeset
114 Every keyboard has a large key which is a short distance above the
36725
640fb21a2098 Clarify the text for BACKSPACE vs DELETE.
Richard M. Stallman <rms@gnu.org>
parents: 36720
diff changeset
115 @key{RET} or @key{ENTER} key and is normally used for erasing what you
68510
80b042d12556 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 68260
diff changeset
116 have typed. It may be labeled @key{DEL}, @key{BACKSPACE}, @key{BS},
80b042d12556 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 68260
diff changeset
117 @key{DELETE}, or even with a left arrow. Regardless of the label on
80b042d12556 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 68260
diff changeset
118 the key, in Emacs it called @key{DEL}, and it should delete one
80b042d12556 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 68260
diff changeset
119 character backwards.
36725
640fb21a2098 Clarify the text for BACKSPACE vs DELETE.
Richard M. Stallman <rms@gnu.org>
parents: 36720
diff changeset
120
37357
ad563f9185fb Minor clarifications of BACKSPACE vs DEL.
Richard M. Stallman <rms@gnu.org>
parents: 37124
diff changeset
121 Many keyboards (including standard PC keyboards) have a
ad563f9185fb Minor clarifications of BACKSPACE vs DEL.
Richard M. Stallman <rms@gnu.org>
parents: 37124
diff changeset
122 @key{BACKSPACE} key a short ways above @key{RET} or @key{ENTER}, and a
ad563f9185fb Minor clarifications of BACKSPACE vs DEL.
Richard M. Stallman <rms@gnu.org>
parents: 37124
diff changeset
123 @key{DELETE} key elsewhere. In that case, the @key{BACKSPACE} key is
ad563f9185fb Minor clarifications of BACKSPACE vs DEL.
Richard M. Stallman <rms@gnu.org>
parents: 37124
diff changeset
124 @key{DEL}, and the @key{DELETE} key is equivalent to @kbd{C-d}---or it
ad563f9185fb Minor clarifications of BACKSPACE vs DEL.
Richard M. Stallman <rms@gnu.org>
parents: 37124
diff changeset
125 should be.
36725
640fb21a2098 Clarify the text for BACKSPACE vs DELETE.
Richard M. Stallman <rms@gnu.org>
parents: 36720
diff changeset
126
640fb21a2098 Clarify the text for BACKSPACE vs DELETE.
Richard M. Stallman <rms@gnu.org>
parents: 36720
diff changeset
127 Why do we say ``or it should be''? When Emacs starts up using a
68708
c0833efdd110 "Graphical display", not window system.
Richard M. Stallman <rms@gnu.org>
parents: 68639
diff changeset
128 graphical display, it determines automatically which key or keys should be
38461
23f63206a867 Proofreading fixes from Chris Green <chris_e_green@yahoo.com>.
Eli Zaretskii <eliz@gnu.org>
parents: 38415
diff changeset
129 equivalent to @key{DEL}. As a result, @key{BACKSPACE} and/or @key{DELETE}
36789
f71fe44b07ea Simplify the discussion of DEL. Refer to `DEL Gets Help' node
Richard M. Stallman <rms@gnu.org>
parents: 36725
diff changeset
130 keys normally do the right things. But in some unusual cases Emacs
f71fe44b07ea Simplify the discussion of DEL. Refer to `DEL Gets Help' node
Richard M. Stallman <rms@gnu.org>
parents: 36725
diff changeset
131 gets the wrong information from the system. If these keys don't do
37357
ad563f9185fb Minor clarifications of BACKSPACE vs DEL.
Richard M. Stallman <rms@gnu.org>
parents: 37124
diff changeset
132 what they ought to do, you need to tell Emacs which key to use for
38767
5889c45fd6ad Change the name of the "DEL Doesn't Delete" node to "DEL Does Not Delete",
Eli Zaretskii <eliz@gnu.org>
parents: 38745
diff changeset
133 @key{DEL}. @xref{DEL Does Not Delete}, for how to do this.
36725
640fb21a2098 Clarify the text for BACKSPACE vs DELETE.
Richard M. Stallman <rms@gnu.org>
parents: 36720
diff changeset
134
36789
f71fe44b07ea Simplify the discussion of DEL. Refer to `DEL Gets Help' node
Richard M. Stallman <rms@gnu.org>
parents: 36725
diff changeset
135 @findex normal-erase-is-backspace-mode
37357
ad563f9185fb Minor clarifications of BACKSPACE vs DEL.
Richard M. Stallman <rms@gnu.org>
parents: 37124
diff changeset
136 On most text-only terminals, Emacs cannot tell which keys the
ad563f9185fb Minor clarifications of BACKSPACE vs DEL.
Richard M. Stallman <rms@gnu.org>
parents: 37124
diff changeset
137 keyboard really has, so it follows a uniform plan which may or may not
52979
3649390c0f91 Replace @sc{ascii} and ASCII with @acronym{ASCII}.
Eli Zaretskii <eliz@gnu.org>
parents: 52401
diff changeset
138 fit your keyboard. The uniform plan is that the @acronym{ASCII} @key{DEL}
3649390c0f91 Replace @sc{ascii} and ASCII with @acronym{ASCII}.
Eli Zaretskii <eliz@gnu.org>
parents: 52401
diff changeset
139 character deletes, and the @acronym{ASCII} @key{BS} (backspace) character asks
37357
ad563f9185fb Minor clarifications of BACKSPACE vs DEL.
Richard M. Stallman <rms@gnu.org>
parents: 37124
diff changeset
140 for help (it is the same as @kbd{C-h}). If this is not right for your
38745
5464ee1ba8e2 Minor cleanups.
Richard M. Stallman <rms@gnu.org>
parents: 38481
diff changeset
141 keyboard, such as if you find that the key which ought to delete backwards
38767
5889c45fd6ad Change the name of the "DEL Doesn't Delete" node to "DEL Does Not Delete",
Eli Zaretskii <eliz@gnu.org>
parents: 38745
diff changeset
142 enters Help instead, see @ref{DEL Does Not Delete}.
36657
0ee33338bb24 (Deletion): Mention the Delete vs Backspace keys. Document
Eli Zaretskii <eliz@gnu.org>
parents: 36162
diff changeset
143
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
144 @kindex M-\
Dave Love <fx@gnu.org>
parents:
diff changeset
145 @findex delete-horizontal-space
Dave Love <fx@gnu.org>
parents:
diff changeset
146 @kindex M-SPC
Dave Love <fx@gnu.org>
parents:
diff changeset
147 @findex just-one-space
Dave Love <fx@gnu.org>
parents:
diff changeset
148 The other delete commands are those which delete only whitespace
Dave Love <fx@gnu.org>
parents:
diff changeset
149 characters: spaces, tabs and newlines. @kbd{M-\}
Dave Love <fx@gnu.org>
parents:
diff changeset
150 (@code{delete-horizontal-space}) deletes all the spaces and tab
Dave Love <fx@gnu.org>
parents:
diff changeset
151 characters before and after point. @kbd{M-@key{SPC}}
Dave Love <fx@gnu.org>
parents:
diff changeset
152 (@code{just-one-space}) does likewise but leaves a single space after
Dave Love <fx@gnu.org>
parents:
diff changeset
153 point, regardless of the number of spaces that existed previously (even
60795
45dee811cbe6 (Deletion): Document numeric argument for just-one-space.
Richard M. Stallman <rms@gnu.org>
parents: 59951
diff changeset
154 if there were none before). With a numeric argument @var{n}, it
45dee811cbe6 (Deletion): Document numeric argument for just-one-space.
Richard M. Stallman <rms@gnu.org>
parents: 59951
diff changeset
155 leaves @var{n} spaces after point.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
156
Dave Love <fx@gnu.org>
parents:
diff changeset
157 @kbd{C-x C-o} (@code{delete-blank-lines}) deletes all blank lines
Dave Love <fx@gnu.org>
parents:
diff changeset
158 after the current line. If the current line is blank, it deletes all
Dave Love <fx@gnu.org>
parents:
diff changeset
159 blank lines preceding the current line as well (leaving one blank line,
62330
747b2c665140 (Deletion): Complete description of `C-x C-o'.
Luc Teirlinck <teirllm@auburn.edu>
parents: 60795
diff changeset
160 the current line). On a solitary blank line, it deletes that line.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
161
Dave Love <fx@gnu.org>
parents:
diff changeset
162 @kbd{M-^} (@code{delete-indentation}) joins the current line and the
Dave Love <fx@gnu.org>
parents:
diff changeset
163 previous line, by deleting a newline and all surrounding spaces, usually
Dave Love <fx@gnu.org>
parents:
diff changeset
164 leaving a single space. @xref{Indentation,M-^}.
Dave Love <fx@gnu.org>
parents:
diff changeset
165
Dave Love <fx@gnu.org>
parents:
diff changeset
166 @node Killing by Lines
Dave Love <fx@gnu.org>
parents:
diff changeset
167 @subsection Killing by Lines
Dave Love <fx@gnu.org>
parents:
diff changeset
168
Dave Love <fx@gnu.org>
parents:
diff changeset
169 @table @kbd
Dave Love <fx@gnu.org>
parents:
diff changeset
170 @item C-k
Dave Love <fx@gnu.org>
parents:
diff changeset
171 Kill rest of line or one or more lines (@code{kill-line}).
67605
d16a1283eb9b (Killing by Lines): Document `kill-whole-line' function.
Eli Zaretskii <eliz@gnu.org>
parents: 67434
diff changeset
172 @item C-S-backspace
d16a1283eb9b (Killing by Lines): Document `kill-whole-line' function.
Eli Zaretskii <eliz@gnu.org>
parents: 67434
diff changeset
173 Kill an entire line at once (@code{kill-whole-line})
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
174 @end table
Dave Love <fx@gnu.org>
parents:
diff changeset
175
Dave Love <fx@gnu.org>
parents:
diff changeset
176 @kindex C-k
Dave Love <fx@gnu.org>
parents:
diff changeset
177 @findex kill-line
Dave Love <fx@gnu.org>
parents:
diff changeset
178 The simplest kill command is @kbd{C-k}. If given at the beginning of
Dave Love <fx@gnu.org>
parents:
diff changeset
179 a line, it kills all the text on the line, leaving it blank. When used
Dave Love <fx@gnu.org>
parents:
diff changeset
180 on a blank line, it kills the whole line including its newline. To kill
Dave Love <fx@gnu.org>
parents:
diff changeset
181 an entire non-blank line, go to the beginning and type @kbd{C-k} twice.
Dave Love <fx@gnu.org>
parents:
diff changeset
182
Dave Love <fx@gnu.org>
parents:
diff changeset
183 More generally, @kbd{C-k} kills from point up to the end of the line,
Dave Love <fx@gnu.org>
parents:
diff changeset
184 unless it is at the end of a line. In that case it kills the newline
Dave Love <fx@gnu.org>
parents:
diff changeset
185 following point, thus merging the next line into the current one.
Dave Love <fx@gnu.org>
parents:
diff changeset
186 Spaces and tabs that you can't see at the end of the line are ignored
Dave Love <fx@gnu.org>
parents:
diff changeset
187 when deciding which case applies, so if point appears to be at the end
Dave Love <fx@gnu.org>
parents:
diff changeset
188 of the line, you can be sure @kbd{C-k} will kill the newline.
Dave Love <fx@gnu.org>
parents:
diff changeset
189
Dave Love <fx@gnu.org>
parents:
diff changeset
190 When @kbd{C-k} is given a positive argument, it kills that many lines
Dave Love <fx@gnu.org>
parents:
diff changeset
191 and the newlines that follow them (however, text on the current line
38461
23f63206a867 Proofreading fixes from Chris Green <chris_e_green@yahoo.com>.
Eli Zaretskii <eliz@gnu.org>
parents: 38415
diff changeset
192 before point is not killed). With a negative argument @minus{}@var{n}, it
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
193 kills @var{n} lines preceding the current line (together with the text
Dave Love <fx@gnu.org>
parents:
diff changeset
194 on the current line before point). Thus, @kbd{C-u - 2 C-k} at the front
Dave Love <fx@gnu.org>
parents:
diff changeset
195 of a line kills the two previous lines.
Dave Love <fx@gnu.org>
parents:
diff changeset
196
Dave Love <fx@gnu.org>
parents:
diff changeset
197 @kbd{C-k} with an argument of zero kills the text before point on the
Dave Love <fx@gnu.org>
parents:
diff changeset
198 current line.
Dave Love <fx@gnu.org>
parents:
diff changeset
199
Dave Love <fx@gnu.org>
parents:
diff changeset
200 @vindex kill-whole-line
Dave Love <fx@gnu.org>
parents:
diff changeset
201 If the variable @code{kill-whole-line} is non-@code{nil}, @kbd{C-k} at
Dave Love <fx@gnu.org>
parents:
diff changeset
202 the very beginning of a line kills the entire line including the
Dave Love <fx@gnu.org>
parents:
diff changeset
203 following newline. This variable is normally @code{nil}.
Dave Love <fx@gnu.org>
parents:
diff changeset
204
67605
d16a1283eb9b (Killing by Lines): Document `kill-whole-line' function.
Eli Zaretskii <eliz@gnu.org>
parents: 67434
diff changeset
205 @kindex C-S-backspace
d16a1283eb9b (Killing by Lines): Document `kill-whole-line' function.
Eli Zaretskii <eliz@gnu.org>
parents: 67434
diff changeset
206 @findex kill-whole-line
d16a1283eb9b (Killing by Lines): Document `kill-whole-line' function.
Eli Zaretskii <eliz@gnu.org>
parents: 67434
diff changeset
207 @kbd{C-S-backspace} (@code{kill-whole-line}) will kill a whole line
d16a1283eb9b (Killing by Lines): Document `kill-whole-line' function.
Eli Zaretskii <eliz@gnu.org>
parents: 67434
diff changeset
208 including its newline regardless of the position of point within the
d16a1283eb9b (Killing by Lines): Document `kill-whole-line' function.
Eli Zaretskii <eliz@gnu.org>
parents: 67434
diff changeset
209 line. Note that many character terminals will prevent you from typing
d16a1283eb9b (Killing by Lines): Document `kill-whole-line' function.
Eli Zaretskii <eliz@gnu.org>
parents: 67434
diff changeset
210 the key sequence @kbd{C-S-backspace}.
d16a1283eb9b (Killing by Lines): Document `kill-whole-line' function.
Eli Zaretskii <eliz@gnu.org>
parents: 67434
diff changeset
211
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
212 @node Other Kill Commands
Dave Love <fx@gnu.org>
parents:
diff changeset
213 @subsection Other Kill Commands
Dave Love <fx@gnu.org>
parents:
diff changeset
214 @findex kill-region
Dave Love <fx@gnu.org>
parents:
diff changeset
215 @kindex C-w
Dave Love <fx@gnu.org>
parents:
diff changeset
216
Dave Love <fx@gnu.org>
parents:
diff changeset
217 @table @kbd
Dave Love <fx@gnu.org>
parents:
diff changeset
218 @item C-w
Dave Love <fx@gnu.org>
parents:
diff changeset
219 Kill region (from point to the mark) (@code{kill-region}).
Dave Love <fx@gnu.org>
parents:
diff changeset
220 @item M-d
Dave Love <fx@gnu.org>
parents:
diff changeset
221 Kill word (@code{kill-word}). @xref{Words}.
Dave Love <fx@gnu.org>
parents:
diff changeset
222 @item M-@key{DEL}
Dave Love <fx@gnu.org>
parents:
diff changeset
223 Kill word backwards (@code{backward-kill-word}).
Dave Love <fx@gnu.org>
parents:
diff changeset
224 @item C-x @key{DEL}
Dave Love <fx@gnu.org>
parents:
diff changeset
225 Kill back to beginning of sentence (@code{backward-kill-sentence}).
Dave Love <fx@gnu.org>
parents:
diff changeset
226 @xref{Sentences}.
Dave Love <fx@gnu.org>
parents:
diff changeset
227 @item M-k
Dave Love <fx@gnu.org>
parents:
diff changeset
228 Kill to end of sentence (@code{kill-sentence}).
Dave Love <fx@gnu.org>
parents:
diff changeset
229 @item C-M-k
38206
b13ab91e3dd8 Say "expression" instead of "sexp". Update xref, Sexps -> Expressions.
Richard M. Stallman <rms@gnu.org>
parents: 37887
diff changeset
230 Kill the following balanced expression (@code{kill-sexp}). @xref{Expressions}.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
231 @item M-z @var{char}
Dave Love <fx@gnu.org>
parents:
diff changeset
232 Kill through the next occurrence of @var{char} (@code{zap-to-char}).
Dave Love <fx@gnu.org>
parents:
diff changeset
233 @end table
Dave Love <fx@gnu.org>
parents:
diff changeset
234
59951
c2c2b868b75f (Other Kill Commands): Cleanup.
Richard M. Stallman <rms@gnu.org>
parents: 59284
diff changeset
235 The most general kill command is @kbd{C-w} (@code{kill-region}),
c2c2b868b75f (Other Kill Commands): Cleanup.
Richard M. Stallman <rms@gnu.org>
parents: 59284
diff changeset
236 which kills everything between point and the mark. With this command,
c2c2b868b75f (Other Kill Commands): Cleanup.
Richard M. Stallman <rms@gnu.org>
parents: 59284
diff changeset
237 you can kill any contiguous sequence of characters, if you first set
c2c2b868b75f (Other Kill Commands): Cleanup.
Richard M. Stallman <rms@gnu.org>
parents: 59284
diff changeset
238 the region around them.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
239
Dave Love <fx@gnu.org>
parents:
diff changeset
240 @kindex M-z
Dave Love <fx@gnu.org>
parents:
diff changeset
241 @findex zap-to-char
Dave Love <fx@gnu.org>
parents:
diff changeset
242 A convenient way of killing is combined with searching: @kbd{M-z}
Dave Love <fx@gnu.org>
parents:
diff changeset
243 (@code{zap-to-char}) reads a character and kills from point up to (and
Dave Love <fx@gnu.org>
parents:
diff changeset
244 including) the next occurrence of that character in the buffer. A
Dave Love <fx@gnu.org>
parents:
diff changeset
245 numeric argument acts as a repeat count. A negative argument means to
Dave Love <fx@gnu.org>
parents:
diff changeset
246 search backward and kill text before point.
Dave Love <fx@gnu.org>
parents:
diff changeset
247
38206
b13ab91e3dd8 Say "expression" instead of "sexp". Update xref, Sexps -> Expressions.
Richard M. Stallman <rms@gnu.org>
parents: 37887
diff changeset
248 Other syntactic units can be killed: words, with @kbd{M-@key{DEL}}
b13ab91e3dd8 Say "expression" instead of "sexp". Update xref, Sexps -> Expressions.
Richard M. Stallman <rms@gnu.org>
parents: 37887
diff changeset
249 and @kbd{M-d} (@pxref{Words}); balanced expressions, with @kbd{C-M-k}
b13ab91e3dd8 Say "expression" instead of "sexp". Update xref, Sexps -> Expressions.
Richard M. Stallman <rms@gnu.org>
parents: 37887
diff changeset
250 (@pxref{Expressions}); and sentences, with @kbd{C-x @key{DEL}} and
b13ab91e3dd8 Say "expression" instead of "sexp". Update xref, Sexps -> Expressions.
Richard M. Stallman <rms@gnu.org>
parents: 37887
diff changeset
251 @kbd{M-k} (@pxref{Sentences}).@refill
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
252
59284
54ff1fbcac20 (Graphical Kill): Move up under node Killing,
Andreas Schwab <schwab@suse.de>
parents: 59272
diff changeset
253 @node Graphical Kill
68510
80b042d12556 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 68260
diff changeset
254 @subsection Killing on Graphical Displays
59284
54ff1fbcac20 (Graphical Kill): Move up under node Killing,
Andreas Schwab <schwab@suse.de>
parents: 59272
diff changeset
255
68510
80b042d12556 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 68260
diff changeset
256 On graphical displays with window systems, the most recent kill done
80b042d12556 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 68260
diff changeset
257 in Emacs is also the primary selection, if it is more recent than any
80b042d12556 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 68260
diff changeset
258 selection you made in another program. This means that the paste
80b042d12556 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 68260
diff changeset
259 commands of other window-based applications copy the text that you
80b042d12556 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 68260
diff changeset
260 killed in Emacs. In addition, Emacs yank commands treat other
80b042d12556 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 68260
diff changeset
261 applications' selections as part of the kill ring, so you can yank
80b042d12556 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 68260
diff changeset
262 them into Emacs.
59284
54ff1fbcac20 (Graphical Kill): Move up under node Killing,
Andreas Schwab <schwab@suse.de>
parents: 59272
diff changeset
263
54ff1fbcac20 (Graphical Kill): Move up under node Killing,
Andreas Schwab <schwab@suse.de>
parents: 59272
diff changeset
264 @cindex Delete Selection mode
54ff1fbcac20 (Graphical Kill): Move up under node Killing,
Andreas Schwab <schwab@suse.de>
parents: 59272
diff changeset
265 @cindex mode, Delete Selection
54ff1fbcac20 (Graphical Kill): Move up under node Killing,
Andreas Schwab <schwab@suse.de>
parents: 59272
diff changeset
266 @findex delete-selection-mode
68708
c0833efdd110 "Graphical display", not window system.
Richard M. Stallman <rms@gnu.org>
parents: 68639
diff changeset
267 Many graphical applications follow the convention that insertion while text
59284
54ff1fbcac20 (Graphical Kill): Move up under node Killing,
Andreas Schwab <schwab@suse.de>
parents: 59272
diff changeset
268 is selected deletes the selected text. You can make Emacs behave this
68510
80b042d12556 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 68260
diff changeset
269 way by enabling Delete Selection mode---with @kbd{M-x
80b042d12556 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 68260
diff changeset
270 delete-selection-mode} or using Custom. Another effect of this mode
59284
54ff1fbcac20 (Graphical Kill): Move up under node Killing,
Andreas Schwab <schwab@suse.de>
parents: 59272
diff changeset
271 is that @key{DEL}, @kbd{C-d} and some other keys, when a selection
54ff1fbcac20 (Graphical Kill): Move up under node Killing,
Andreas Schwab <schwab@suse.de>
parents: 59272
diff changeset
272 exists, will kill the whole selection. It also enables Transient Mark
54ff1fbcac20 (Graphical Kill): Move up under node Killing,
Andreas Schwab <schwab@suse.de>
parents: 59272
diff changeset
273 mode (@pxref{Transient Mark}).
54ff1fbcac20 (Graphical Kill): Move up under node Killing,
Andreas Schwab <schwab@suse.de>
parents: 59272
diff changeset
274
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
275 @node Yanking, Accumulating Text, Killing, Top
Dave Love <fx@gnu.org>
parents:
diff changeset
276 @section Yanking
Dave Love <fx@gnu.org>
parents:
diff changeset
277 @cindex moving text
Dave Love <fx@gnu.org>
parents:
diff changeset
278 @cindex copying text
Dave Love <fx@gnu.org>
parents:
diff changeset
279 @cindex kill ring
Dave Love <fx@gnu.org>
parents:
diff changeset
280 @cindex yanking
Dave Love <fx@gnu.org>
parents:
diff changeset
281 @cindex pasting
Dave Love <fx@gnu.org>
parents:
diff changeset
282
Dave Love <fx@gnu.org>
parents:
diff changeset
283 @dfn{Yanking} means reinserting text previously killed. This is what
Dave Love <fx@gnu.org>
parents:
diff changeset
284 some systems call ``pasting.'' The usual way to move or copy text is to
56692
ccb70b8731b4 (Yanking, Killing): Minor cleanups.
Richard M. Stallman <rms@gnu.org>
parents: 52979
diff changeset
285 kill it and then yank it elsewhere one or more times. This is very safe
ccb70b8731b4 (Yanking, Killing): Minor cleanups.
Richard M. Stallman <rms@gnu.org>
parents: 52979
diff changeset
286 because Emacs remembers many recent kills, not just the last one.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
287
Dave Love <fx@gnu.org>
parents:
diff changeset
288 @table @kbd
Dave Love <fx@gnu.org>
parents:
diff changeset
289 @item C-y
Dave Love <fx@gnu.org>
parents:
diff changeset
290 Yank last killed text (@code{yank}).
Dave Love <fx@gnu.org>
parents:
diff changeset
291 @item M-y
Dave Love <fx@gnu.org>
parents:
diff changeset
292 Replace text just yanked with an earlier batch of killed text
Dave Love <fx@gnu.org>
parents:
diff changeset
293 (@code{yank-pop}).
Dave Love <fx@gnu.org>
parents:
diff changeset
294 @item M-w
Dave Love <fx@gnu.org>
parents:
diff changeset
295 Save region as last killed text without actually killing it
72101
c7e4f78b81a6 Move periods and commas inside quotes.
Richard M. Stallman <rms@gnu.org>
parents: 71751
diff changeset
296 (@code{kill-ring-save}). Some systems call this ``copying.''
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
297 @item C-M-w
Dave Love <fx@gnu.org>
parents:
diff changeset
298 Append next kill to last batch of killed text (@code{append-next-kill}).
Dave Love <fx@gnu.org>
parents:
diff changeset
299 @end table
Dave Love <fx@gnu.org>
parents:
diff changeset
300
68510
80b042d12556 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 68260
diff changeset
301 On graphical displays with window systems, if there is a current
80b042d12556 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 68260
diff changeset
302 selection in some other application, and you selected it more recently
80b042d12556 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 68260
diff changeset
303 than you killed any text in Emacs, @kbd{C-y} copies the selection
80b042d12556 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 68260
diff changeset
304 instead of text killed within Emacs.
46037
7af49c69e77b Mention that kill commands communicate with other apps,
Richard M. Stallman <rms@gnu.org>
parents: 39264
diff changeset
305
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
306 @menu
Dave Love <fx@gnu.org>
parents:
diff changeset
307 * Kill Ring:: Where killed text is stored. Basic yanking.
Dave Love <fx@gnu.org>
parents:
diff changeset
308 * Appending Kills:: Several kills in a row all yank together.
Dave Love <fx@gnu.org>
parents:
diff changeset
309 * Earlier Kills:: Yanking something killed some time ago.
Dave Love <fx@gnu.org>
parents:
diff changeset
310 @end menu
Dave Love <fx@gnu.org>
parents:
diff changeset
311
Dave Love <fx@gnu.org>
parents:
diff changeset
312 @node Kill Ring
Dave Love <fx@gnu.org>
parents:
diff changeset
313 @subsection The Kill Ring
Dave Love <fx@gnu.org>
parents:
diff changeset
314
Dave Love <fx@gnu.org>
parents:
diff changeset
315 All killed text is recorded in the @dfn{kill ring}, a list of blocks of
Dave Love <fx@gnu.org>
parents:
diff changeset
316 text that have been killed. There is only one kill ring, shared by all
Dave Love <fx@gnu.org>
parents:
diff changeset
317 buffers, so you can kill text in one buffer and yank it in another buffer.
Dave Love <fx@gnu.org>
parents:
diff changeset
318 This is the usual way to move text from one file to another.
Dave Love <fx@gnu.org>
parents:
diff changeset
319 (@xref{Accumulating Text}, for some other ways.)
Dave Love <fx@gnu.org>
parents:
diff changeset
320
Dave Love <fx@gnu.org>
parents:
diff changeset
321 @kindex C-y
Dave Love <fx@gnu.org>
parents:
diff changeset
322 @findex yank
Dave Love <fx@gnu.org>
parents:
diff changeset
323 The command @kbd{C-y} (@code{yank}) reinserts the text of the most recent
Dave Love <fx@gnu.org>
parents:
diff changeset
324 kill. It leaves the cursor at the end of the text. It sets the mark at
Dave Love <fx@gnu.org>
parents:
diff changeset
325 the beginning of the text. @xref{Mark}.
Dave Love <fx@gnu.org>
parents:
diff changeset
326
Dave Love <fx@gnu.org>
parents:
diff changeset
327 @kbd{C-u C-y} leaves the cursor in front of the text, and sets the
Dave Love <fx@gnu.org>
parents:
diff changeset
328 mark after it. This happens only if the argument is specified with just
Dave Love <fx@gnu.org>
parents:
diff changeset
329 a @kbd{C-u}, precisely. Any other sort of argument, including @kbd{C-u}
Dave Love <fx@gnu.org>
parents:
diff changeset
330 and digits, specifies an earlier kill to yank (@pxref{Earlier Kills}).
Dave Love <fx@gnu.org>
parents:
diff changeset
331
46241
0ed85ef15043 Describe yank-excluded-properties.
Richard M. Stallman <rms@gnu.org>
parents: 46037
diff changeset
332 @cindex yanking and text properties
0ed85ef15043 Describe yank-excluded-properties.
Richard M. Stallman <rms@gnu.org>
parents: 46037
diff changeset
333 @vindex yank-excluded-properties
0ed85ef15043 Describe yank-excluded-properties.
Richard M. Stallman <rms@gnu.org>
parents: 46037
diff changeset
334 The yank commands discard certain text properties from the text that
47200
617a371d38f2 Fix typo.
Richard M. Stallman <rms@gnu.org>
parents: 46241
diff changeset
335 is yanked, those that might lead to annoying results. For instance,
46241
0ed85ef15043 Describe yank-excluded-properties.
Richard M. Stallman <rms@gnu.org>
parents: 46037
diff changeset
336 they discard text properties that respond to the mouse or specify key
0ed85ef15043 Describe yank-excluded-properties.
Richard M. Stallman <rms@gnu.org>
parents: 46037
diff changeset
337 bindings. The variable @code{yank-excluded-properties} specifies the
0ed85ef15043 Describe yank-excluded-properties.
Richard M. Stallman <rms@gnu.org>
parents: 46037
diff changeset
338 properties to discard. Yanking of register contents and rectangles
0ed85ef15043 Describe yank-excluded-properties.
Richard M. Stallman <rms@gnu.org>
parents: 46037
diff changeset
339 also discard these properties.
0ed85ef15043 Describe yank-excluded-properties.
Richard M. Stallman <rms@gnu.org>
parents: 46037
diff changeset
340
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
341 @kindex M-w
Dave Love <fx@gnu.org>
parents:
diff changeset
342 @findex kill-ring-save
Dave Love <fx@gnu.org>
parents:
diff changeset
343 To copy a block of text, you can use @kbd{M-w}
Dave Love <fx@gnu.org>
parents:
diff changeset
344 (@code{kill-ring-save}), which copies the region into the kill ring
Dave Love <fx@gnu.org>
parents:
diff changeset
345 without removing it from the buffer. This is approximately equivalent
Dave Love <fx@gnu.org>
parents:
diff changeset
346 to @kbd{C-w} followed by @kbd{C-x u}, except that @kbd{M-w} does not
Dave Love <fx@gnu.org>
parents:
diff changeset
347 alter the undo history and does not temporarily change the screen.
Dave Love <fx@gnu.org>
parents:
diff changeset
348
Dave Love <fx@gnu.org>
parents:
diff changeset
349 @node Appending Kills
Dave Love <fx@gnu.org>
parents:
diff changeset
350 @subsection Appending Kills
Dave Love <fx@gnu.org>
parents:
diff changeset
351
Dave Love <fx@gnu.org>
parents:
diff changeset
352 @cindex appending kills in the ring
Dave Love <fx@gnu.org>
parents:
diff changeset
353 @cindex television
Dave Love <fx@gnu.org>
parents:
diff changeset
354 Normally, each kill command pushes a new entry onto the kill ring.
Dave Love <fx@gnu.org>
parents:
diff changeset
355 However, two or more kill commands in a row combine their text into a
Dave Love <fx@gnu.org>
parents:
diff changeset
356 single entry, so that a single @kbd{C-y} yanks all the text as a unit,
Dave Love <fx@gnu.org>
parents:
diff changeset
357 just as it was before it was killed.
Dave Love <fx@gnu.org>
parents:
diff changeset
358
Dave Love <fx@gnu.org>
parents:
diff changeset
359 Thus, if you want to yank text as a unit, you need not kill all of it
Dave Love <fx@gnu.org>
parents:
diff changeset
360 with one command; you can keep killing line after line, or word after
Dave Love <fx@gnu.org>
parents:
diff changeset
361 word, until you have killed it all, and you can still get it all back at
Dave Love <fx@gnu.org>
parents:
diff changeset
362 once.
Dave Love <fx@gnu.org>
parents:
diff changeset
363
Dave Love <fx@gnu.org>
parents:
diff changeset
364 Commands that kill forward from point add onto the end of the previous
Dave Love <fx@gnu.org>
parents:
diff changeset
365 killed text. Commands that kill backward from point add text onto the
Dave Love <fx@gnu.org>
parents:
diff changeset
366 beginning. This way, any sequence of mixed forward and backward kill
Dave Love <fx@gnu.org>
parents:
diff changeset
367 commands puts all the killed text into one entry without rearrangement.
Dave Love <fx@gnu.org>
parents:
diff changeset
368 Numeric arguments do not break the sequence of appending kills. For
Dave Love <fx@gnu.org>
parents:
diff changeset
369 example, suppose the buffer contains this text:
Dave Love <fx@gnu.org>
parents:
diff changeset
370
Dave Love <fx@gnu.org>
parents:
diff changeset
371 @example
Dave Love <fx@gnu.org>
parents:
diff changeset
372 This is a line @point{}of sample text.
Dave Love <fx@gnu.org>
parents:
diff changeset
373 @end example
Dave Love <fx@gnu.org>
parents:
diff changeset
374
Dave Love <fx@gnu.org>
parents:
diff changeset
375 @noindent
Dave Love <fx@gnu.org>
parents:
diff changeset
376 with point shown by @point{}. If you type @kbd{M-d M-@key{DEL} M-d
Dave Love <fx@gnu.org>
parents:
diff changeset
377 M-@key{DEL}}, killing alternately forward and backward, you end up with
Dave Love <fx@gnu.org>
parents:
diff changeset
378 @samp{a line of sample} as one entry in the kill ring, and @samp{This
38461
23f63206a867 Proofreading fixes from Chris Green <chris_e_green@yahoo.com>.
Eli Zaretskii <eliz@gnu.org>
parents: 38415
diff changeset
379 is@ @ text.} in the buffer. (Note the double space between @samp{is}
23f63206a867 Proofreading fixes from Chris Green <chris_e_green@yahoo.com>.
Eli Zaretskii <eliz@gnu.org>
parents: 38415
diff changeset
380 and @samp{text}, which you can clean up with @kbd{M-@key{SPC}} or
23f63206a867 Proofreading fixes from Chris Green <chris_e_green@yahoo.com>.
Eli Zaretskii <eliz@gnu.org>
parents: 38415
diff changeset
381 @kbd{M-q}.)
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
382
Dave Love <fx@gnu.org>
parents:
diff changeset
383 Another way to kill the same text is to move back two words with
Dave Love <fx@gnu.org>
parents:
diff changeset
384 @kbd{M-b M-b}, then kill all four words forward with @kbd{C-u M-d}.
Dave Love <fx@gnu.org>
parents:
diff changeset
385 This produces exactly the same results in the buffer and in the kill
Dave Love <fx@gnu.org>
parents:
diff changeset
386 ring. @kbd{M-f M-f C-u M-@key{DEL}} kills the same text, all going
Dave Love <fx@gnu.org>
parents:
diff changeset
387 backward; once again, the result is the same. The text in the kill ring
Dave Love <fx@gnu.org>
parents:
diff changeset
388 entry always has the same order that it had in the buffer before you
Dave Love <fx@gnu.org>
parents:
diff changeset
389 killed it.
Dave Love <fx@gnu.org>
parents:
diff changeset
390
Dave Love <fx@gnu.org>
parents:
diff changeset
391 @kindex C-M-w
Dave Love <fx@gnu.org>
parents:
diff changeset
392 @findex append-next-kill
Dave Love <fx@gnu.org>
parents:
diff changeset
393 If a kill command is separated from the last kill command by other
Dave Love <fx@gnu.org>
parents:
diff changeset
394 commands (not just numeric arguments), it starts a new entry on the kill
Dave Love <fx@gnu.org>
parents:
diff changeset
395 ring. But you can force it to append by first typing the command
Dave Love <fx@gnu.org>
parents:
diff changeset
396 @kbd{C-M-w} (@code{append-next-kill}) right before it. The @kbd{C-M-w}
Dave Love <fx@gnu.org>
parents:
diff changeset
397 tells the following command, if it is a kill command, to append the text
Dave Love <fx@gnu.org>
parents:
diff changeset
398 it kills to the last killed text, instead of starting a new entry. With
Dave Love <fx@gnu.org>
parents:
diff changeset
399 @kbd{C-M-w}, you can kill several separated pieces of text and
Dave Love <fx@gnu.org>
parents:
diff changeset
400 accumulate them to be yanked back in one place.@refill
Dave Love <fx@gnu.org>
parents:
diff changeset
401
Dave Love <fx@gnu.org>
parents:
diff changeset
402 A kill command following @kbd{M-w} does not append to the text that
Dave Love <fx@gnu.org>
parents:
diff changeset
403 @kbd{M-w} copied into the kill ring.
Dave Love <fx@gnu.org>
parents:
diff changeset
404
Dave Love <fx@gnu.org>
parents:
diff changeset
405 @node Earlier Kills
Dave Love <fx@gnu.org>
parents:
diff changeset
406 @subsection Yanking Earlier Kills
Dave Love <fx@gnu.org>
parents:
diff changeset
407
Dave Love <fx@gnu.org>
parents:
diff changeset
408 @cindex yanking previous kills
Dave Love <fx@gnu.org>
parents:
diff changeset
409 @kindex M-y
Dave Love <fx@gnu.org>
parents:
diff changeset
410 @findex yank-pop
Dave Love <fx@gnu.org>
parents:
diff changeset
411 To recover killed text that is no longer the most recent kill, use the
Dave Love <fx@gnu.org>
parents:
diff changeset
412 @kbd{M-y} command (@code{yank-pop}). It takes the text previously
Dave Love <fx@gnu.org>
parents:
diff changeset
413 yanked and replaces it with the text from an earlier kill. So, to
Dave Love <fx@gnu.org>
parents:
diff changeset
414 recover the text of the next-to-the-last kill, first use @kbd{C-y} to
Dave Love <fx@gnu.org>
parents:
diff changeset
415 yank the last kill, and then use @kbd{M-y} to replace it with the
Dave Love <fx@gnu.org>
parents:
diff changeset
416 previous kill. @kbd{M-y} is allowed only after a @kbd{C-y} or another
Dave Love <fx@gnu.org>
parents:
diff changeset
417 @kbd{M-y}.
Dave Love <fx@gnu.org>
parents:
diff changeset
418
Dave Love <fx@gnu.org>
parents:
diff changeset
419 You can understand @kbd{M-y} in terms of a ``last yank'' pointer which
Dave Love <fx@gnu.org>
parents:
diff changeset
420 points at an entry in the kill ring. Each time you kill, the ``last
Dave Love <fx@gnu.org>
parents:
diff changeset
421 yank'' pointer moves to the newly made entry at the front of the ring.
Dave Love <fx@gnu.org>
parents:
diff changeset
422 @kbd{C-y} yanks the entry which the ``last yank'' pointer points to.
Dave Love <fx@gnu.org>
parents:
diff changeset
423 @kbd{M-y} moves the ``last yank'' pointer to a different entry, and the
Dave Love <fx@gnu.org>
parents:
diff changeset
424 text in the buffer changes to match. Enough @kbd{M-y} commands can move
Dave Love <fx@gnu.org>
parents:
diff changeset
425 the pointer to any entry in the ring, so you can get any entry into the
Dave Love <fx@gnu.org>
parents:
diff changeset
426 buffer. Eventually the pointer reaches the end of the ring; the next
38461
23f63206a867 Proofreading fixes from Chris Green <chris_e_green@yahoo.com>.
Eli Zaretskii <eliz@gnu.org>
parents: 38415
diff changeset
427 @kbd{M-y} loops back around to the first entry again.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
428
Dave Love <fx@gnu.org>
parents:
diff changeset
429 @kbd{M-y} moves the ``last yank'' pointer around the ring, but it does
Dave Love <fx@gnu.org>
parents:
diff changeset
430 not change the order of the entries in the ring, which always runs from
Dave Love <fx@gnu.org>
parents:
diff changeset
431 the most recent kill at the front to the oldest one still remembered.
Dave Love <fx@gnu.org>
parents:
diff changeset
432
Dave Love <fx@gnu.org>
parents:
diff changeset
433 @kbd{M-y} can take a numeric argument, which tells it how many entries
Dave Love <fx@gnu.org>
parents:
diff changeset
434 to advance the ``last yank'' pointer by. A negative argument moves the
Dave Love <fx@gnu.org>
parents:
diff changeset
435 pointer toward the front of the ring; from the front of the ring, it
Dave Love <fx@gnu.org>
parents:
diff changeset
436 moves ``around'' to the last entry and continues forward from there.
Dave Love <fx@gnu.org>
parents:
diff changeset
437
Dave Love <fx@gnu.org>
parents:
diff changeset
438 Once the text you are looking for is brought into the buffer, you can
Dave Love <fx@gnu.org>
parents:
diff changeset
439 stop doing @kbd{M-y} commands and it will stay there. It's just a copy
Dave Love <fx@gnu.org>
parents:
diff changeset
440 of the kill ring entry, so editing it in the buffer does not change
Dave Love <fx@gnu.org>
parents:
diff changeset
441 what's in the ring. As long as no new killing is done, the ``last
Dave Love <fx@gnu.org>
parents:
diff changeset
442 yank'' pointer remains at the same place in the kill ring, so repeating
Dave Love <fx@gnu.org>
parents:
diff changeset
443 @kbd{C-y} will yank another copy of the same previous kill.
Dave Love <fx@gnu.org>
parents:
diff changeset
444
38745
5464ee1ba8e2 Minor cleanups.
Richard M. Stallman <rms@gnu.org>
parents: 38481
diff changeset
445 If you know how many @kbd{M-y} commands it would take to find the
5464ee1ba8e2 Minor cleanups.
Richard M. Stallman <rms@gnu.org>
parents: 38481
diff changeset
446 text you want, you can yank that text in one step using @kbd{C-y} with
5464ee1ba8e2 Minor cleanups.
Richard M. Stallman <rms@gnu.org>
parents: 38481
diff changeset
447 a numeric argument. @kbd{C-y} with an argument restores the text from
5464ee1ba8e2 Minor cleanups.
Richard M. Stallman <rms@gnu.org>
parents: 38481
diff changeset
448 the specified kill ring entry, counting back from the most recent as
5464ee1ba8e2 Minor cleanups.
Richard M. Stallman <rms@gnu.org>
parents: 38481
diff changeset
449 1. Thus, @kbd{C-u 2 C-y} gets the next-to-the-last block of killed
5464ee1ba8e2 Minor cleanups.
Richard M. Stallman <rms@gnu.org>
parents: 38481
diff changeset
450 text---it is equivalent to @kbd{C-y M-y}. @kbd{C-y} with a numeric
5464ee1ba8e2 Minor cleanups.
Richard M. Stallman <rms@gnu.org>
parents: 38481
diff changeset
451 argument starts counting from the ``last yank'' pointer, and sets the
5464ee1ba8e2 Minor cleanups.
Richard M. Stallman <rms@gnu.org>
parents: 38481
diff changeset
452 ``last yank'' pointer to the entry that it yanks.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
453
Dave Love <fx@gnu.org>
parents:
diff changeset
454 @vindex kill-ring-max
Dave Love <fx@gnu.org>
parents:
diff changeset
455 The length of the kill ring is controlled by the variable
Dave Love <fx@gnu.org>
parents:
diff changeset
456 @code{kill-ring-max}; no more than that many blocks of killed text are
Dave Love <fx@gnu.org>
parents:
diff changeset
457 saved.
Dave Love <fx@gnu.org>
parents:
diff changeset
458
Dave Love <fx@gnu.org>
parents:
diff changeset
459 @vindex kill-ring
Dave Love <fx@gnu.org>
parents:
diff changeset
460 The actual contents of the kill ring are stored in a variable named
Dave Love <fx@gnu.org>
parents:
diff changeset
461 @code{kill-ring}; you can view the entire contents of the kill ring with
Dave Love <fx@gnu.org>
parents:
diff changeset
462 the command @kbd{C-h v kill-ring}.
Dave Love <fx@gnu.org>
parents:
diff changeset
463
Dave Love <fx@gnu.org>
parents:
diff changeset
464 @node Accumulating Text, Rectangles, Yanking, Top
Dave Love <fx@gnu.org>
parents:
diff changeset
465 @section Accumulating Text
Dave Love <fx@gnu.org>
parents:
diff changeset
466 @findex append-to-buffer
Dave Love <fx@gnu.org>
parents:
diff changeset
467 @findex prepend-to-buffer
Dave Love <fx@gnu.org>
parents:
diff changeset
468 @findex copy-to-buffer
Dave Love <fx@gnu.org>
parents:
diff changeset
469 @findex append-to-file
Dave Love <fx@gnu.org>
parents:
diff changeset
470
Dave Love <fx@gnu.org>
parents:
diff changeset
471 @cindex accumulating scattered text
Dave Love <fx@gnu.org>
parents:
diff changeset
472 Usually we copy or move text by killing it and yanking it, but there
59951
c2c2b868b75f (Other Kill Commands): Cleanup.
Richard M. Stallman <rms@gnu.org>
parents: 59284
diff changeset
473 are other convenient methods for copying one block of text in many
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
474 places, or for copying many scattered blocks of text into one place. To
Dave Love <fx@gnu.org>
parents:
diff changeset
475 copy one block to many places, store it in a register
Dave Love <fx@gnu.org>
parents:
diff changeset
476 (@pxref{Registers}). Here we describe the commands to accumulate
Dave Love <fx@gnu.org>
parents:
diff changeset
477 scattered pieces of text into a buffer or into a file.
Dave Love <fx@gnu.org>
parents:
diff changeset
478
Dave Love <fx@gnu.org>
parents:
diff changeset
479 @table @kbd
Dave Love <fx@gnu.org>
parents:
diff changeset
480 @item M-x append-to-buffer
38745
5464ee1ba8e2 Minor cleanups.
Richard M. Stallman <rms@gnu.org>
parents: 38481
diff changeset
481 Append region to the contents of a specified buffer.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
482 @item M-x prepend-to-buffer
38745
5464ee1ba8e2 Minor cleanups.
Richard M. Stallman <rms@gnu.org>
parents: 38481
diff changeset
483 Prepend region to the contents of a specified buffer.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
484 @item M-x copy-to-buffer
38461
23f63206a867 Proofreading fixes from Chris Green <chris_e_green@yahoo.com>.
Eli Zaretskii <eliz@gnu.org>
parents: 38415
diff changeset
485 Copy region into a specified buffer, deleting that buffer's old contents.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
486 @item M-x insert-buffer
38745
5464ee1ba8e2 Minor cleanups.
Richard M. Stallman <rms@gnu.org>
parents: 38481
diff changeset
487 Insert the contents of a specified buffer into current buffer at point.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
488 @item M-x append-to-file
38745
5464ee1ba8e2 Minor cleanups.
Richard M. Stallman <rms@gnu.org>
parents: 38481
diff changeset
489 Append region to the contents of a specified file, at the end.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
490 @end table
Dave Love <fx@gnu.org>
parents:
diff changeset
491
Dave Love <fx@gnu.org>
parents:
diff changeset
492 To accumulate text into a buffer, use @kbd{M-x append-to-buffer}.
Dave Love <fx@gnu.org>
parents:
diff changeset
493 This reads a buffer name, then inserts a copy of the region into the
Dave Love <fx@gnu.org>
parents:
diff changeset
494 buffer specified. If you specify a nonexistent buffer,
Dave Love <fx@gnu.org>
parents:
diff changeset
495 @code{append-to-buffer} creates the buffer. The text is inserted
Dave Love <fx@gnu.org>
parents:
diff changeset
496 wherever point is in that buffer. If you have been using the buffer for
Dave Love <fx@gnu.org>
parents:
diff changeset
497 editing, the copied text goes into the middle of the text of the buffer,
38461
23f63206a867 Proofreading fixes from Chris Green <chris_e_green@yahoo.com>.
Eli Zaretskii <eliz@gnu.org>
parents: 38415
diff changeset
498 starting from wherever point happens to be at that moment.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
499
Dave Love <fx@gnu.org>
parents:
diff changeset
500 Point in that buffer is left at the end of the copied text, so
Dave Love <fx@gnu.org>
parents:
diff changeset
501 successive uses of @code{append-to-buffer} accumulate the text in the
Dave Love <fx@gnu.org>
parents:
diff changeset
502 specified buffer in the same order as they were copied. Strictly
Dave Love <fx@gnu.org>
parents:
diff changeset
503 speaking, @code{append-to-buffer} does not always append to the text
Dave Love <fx@gnu.org>
parents:
diff changeset
504 already in the buffer---it appends only if point in that buffer is at the end.
Dave Love <fx@gnu.org>
parents:
diff changeset
505 However, if @code{append-to-buffer} is the only command you use to alter
Dave Love <fx@gnu.org>
parents:
diff changeset
506 a buffer, then point is always at the end.
Dave Love <fx@gnu.org>
parents:
diff changeset
507
Dave Love <fx@gnu.org>
parents:
diff changeset
508 @kbd{M-x prepend-to-buffer} is just like @code{append-to-buffer}
Dave Love <fx@gnu.org>
parents:
diff changeset
509 except that point in the other buffer is left before the copied text, so
Dave Love <fx@gnu.org>
parents:
diff changeset
510 successive prependings add text in reverse order. @kbd{M-x
38461
23f63206a867 Proofreading fixes from Chris Green <chris_e_green@yahoo.com>.
Eli Zaretskii <eliz@gnu.org>
parents: 38415
diff changeset
511 copy-to-buffer} is similar, except that any existing text in the other
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
512 buffer is deleted, so the buffer is left containing just the text newly
Dave Love <fx@gnu.org>
parents:
diff changeset
513 copied into it.
Dave Love <fx@gnu.org>
parents:
diff changeset
514
38415
80b960104fbd Minor clarification about insert-buffer.
Richard M. Stallman <rms@gnu.org>
parents: 38206
diff changeset
515 To retrieve the accumulated text from another buffer, use the
80b960104fbd Minor clarification about insert-buffer.
Richard M. Stallman <rms@gnu.org>
parents: 38206
diff changeset
516 command @kbd{M-x insert-buffer}; this too takes @var{buffername} as an
80b960104fbd Minor clarification about insert-buffer.
Richard M. Stallman <rms@gnu.org>
parents: 38206
diff changeset
517 argument. It inserts a copy of the whole text in buffer
38745
5464ee1ba8e2 Minor cleanups.
Richard M. Stallman <rms@gnu.org>
parents: 38481
diff changeset
518 @var{buffername} into the current buffer at point, and sets the mark
38415
80b960104fbd Minor clarification about insert-buffer.
Richard M. Stallman <rms@gnu.org>
parents: 38206
diff changeset
519 after the inserted text. Alternatively, you can select the other
80b960104fbd Minor clarification about insert-buffer.
Richard M. Stallman <rms@gnu.org>
parents: 38206
diff changeset
520 buffer for editing, then copy text from it by killing.
80b960104fbd Minor clarification about insert-buffer.
Richard M. Stallman <rms@gnu.org>
parents: 38206
diff changeset
521 @xref{Buffers}, for background information on buffers.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
522
Dave Love <fx@gnu.org>
parents:
diff changeset
523 Instead of accumulating text within Emacs, in a buffer, you can append
Dave Love <fx@gnu.org>
parents:
diff changeset
524 text directly into a file with @kbd{M-x append-to-file}, which takes
Dave Love <fx@gnu.org>
parents:
diff changeset
525 @var{filename} as an argument. It adds the text of the region to the end
Dave Love <fx@gnu.org>
parents:
diff changeset
526 of the specified file. The file is changed immediately on disk.
Dave Love <fx@gnu.org>
parents:
diff changeset
527
Dave Love <fx@gnu.org>
parents:
diff changeset
528 You should use @code{append-to-file} only with files that are
Dave Love <fx@gnu.org>
parents:
diff changeset
529 @emph{not} being visited in Emacs. Using it on a file that you are
Dave Love <fx@gnu.org>
parents:
diff changeset
530 editing in Emacs would change the file behind Emacs's back, which
Dave Love <fx@gnu.org>
parents:
diff changeset
531 can lead to losing some of your editing.
Dave Love <fx@gnu.org>
parents:
diff changeset
532
66782
e30f43430f3c * killing.texi (CUA Bindings): New node. Moved here from
Kim F. Storm <storm@cua.dk>
parents: 64890
diff changeset
533 @node Rectangles, CUA Bindings, Accumulating Text, Top
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
534 @section Rectangles
Dave Love <fx@gnu.org>
parents:
diff changeset
535 @cindex rectangle
Dave Love <fx@gnu.org>
parents:
diff changeset
536 @cindex columns (and rectangles)
Dave Love <fx@gnu.org>
parents:
diff changeset
537 @cindex killing rectangular areas of text
Dave Love <fx@gnu.org>
parents:
diff changeset
538
Dave Love <fx@gnu.org>
parents:
diff changeset
539 The rectangle commands operate on rectangular areas of the text: all
Dave Love <fx@gnu.org>
parents:
diff changeset
540 the characters between a certain pair of columns, in a certain range of
Dave Love <fx@gnu.org>
parents:
diff changeset
541 lines. Commands are provided to kill rectangles, yank killed rectangles,
Dave Love <fx@gnu.org>
parents:
diff changeset
542 clear them out, fill them with blanks or text, or delete them. Rectangle
Dave Love <fx@gnu.org>
parents:
diff changeset
543 commands are useful with text in multicolumn formats, and for changing
Dave Love <fx@gnu.org>
parents:
diff changeset
544 text into or out of such formats.
Dave Love <fx@gnu.org>
parents:
diff changeset
545
69828
4d337f37e313 (Rectangles): Add index entry for marking a rectangle.
Eli Zaretskii <eliz@gnu.org>
parents: 68708
diff changeset
546 @cindex mark rectangle
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
547 When you must specify a rectangle for a command to work on, you do it
Dave Love <fx@gnu.org>
parents:
diff changeset
548 by putting the mark at one corner and point at the opposite corner. The
Dave Love <fx@gnu.org>
parents:
diff changeset
549 rectangle thus specified is called the @dfn{region-rectangle} because
38461
23f63206a867 Proofreading fixes from Chris Green <chris_e_green@yahoo.com>.
Eli Zaretskii <eliz@gnu.org>
parents: 38415
diff changeset
550 you control it in much the same way as the region is controlled. But
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
551 remember that a given combination of point and mark values can be
Dave Love <fx@gnu.org>
parents:
diff changeset
552 interpreted either as a region or as a rectangle, depending on the
Dave Love <fx@gnu.org>
parents:
diff changeset
553 command that uses them.
Dave Love <fx@gnu.org>
parents:
diff changeset
554
Dave Love <fx@gnu.org>
parents:
diff changeset
555 If point and the mark are in the same column, the rectangle they
Dave Love <fx@gnu.org>
parents:
diff changeset
556 delimit is empty. If they are in the same line, the rectangle is one
Dave Love <fx@gnu.org>
parents:
diff changeset
557 line high. This asymmetry between lines and columns comes about
Dave Love <fx@gnu.org>
parents:
diff changeset
558 because point (and likewise the mark) is between two columns, but within
Dave Love <fx@gnu.org>
parents:
diff changeset
559 a line.
Dave Love <fx@gnu.org>
parents:
diff changeset
560
Dave Love <fx@gnu.org>
parents:
diff changeset
561 @table @kbd
Dave Love <fx@gnu.org>
parents:
diff changeset
562 @item C-x r k
49600
23a1cea22d13 Trailing whitespace deleted.
Juanma Barranquero <lekktu@gmail.com>
parents: 49330
diff changeset
563 Kill the text of the region-rectangle, saving its contents as the
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
564 ``last killed rectangle'' (@code{kill-rectangle}).
Dave Love <fx@gnu.org>
parents:
diff changeset
565 @item C-x r d
Dave Love <fx@gnu.org>
parents:
diff changeset
566 Delete the text of the region-rectangle (@code{delete-rectangle}).
Dave Love <fx@gnu.org>
parents:
diff changeset
567 @item C-x r y
Dave Love <fx@gnu.org>
parents:
diff changeset
568 Yank the last killed rectangle with its upper left corner at point
Dave Love <fx@gnu.org>
parents:
diff changeset
569 (@code{yank-rectangle}).
Dave Love <fx@gnu.org>
parents:
diff changeset
570 @item C-x r o
Dave Love <fx@gnu.org>
parents:
diff changeset
571 Insert blank space to fill the space of the region-rectangle
Dave Love <fx@gnu.org>
parents:
diff changeset
572 (@code{open-rectangle}). This pushes the previous contents of the
Dave Love <fx@gnu.org>
parents:
diff changeset
573 region-rectangle rightward.
49330
99f721b3f74e (Rectangles): Document C-x c r.
Richard M. Stallman <rms@gnu.org>
parents: 47200
diff changeset
574 @item C-x r c
99f721b3f74e (Rectangles): Document C-x c r.
Richard M. Stallman <rms@gnu.org>
parents: 47200
diff changeset
575 Clear the region-rectangle by replacing its contents with spaces
99f721b3f74e (Rectangles): Document C-x c r.
Richard M. Stallman <rms@gnu.org>
parents: 47200
diff changeset
576 (@code{clear-rectangle}).
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
577 @item M-x delete-whitespace-rectangle
Dave Love <fx@gnu.org>
parents:
diff changeset
578 Delete whitespace in each of the lines on the specified rectangle,
Dave Love <fx@gnu.org>
parents:
diff changeset
579 starting from the left edge column of the rectangle.
27749
986871288b53 *** empty log message ***
Gerd Moellmann <gerd@gnu.org>
parents: 25829
diff changeset
580 @item C-x r t @var{string} @key{RET}
37447
0bc52782144f Adapt to the change of string-rectangle back to 20.x behaviour.
Gerd Moellmann <gerd@gnu.org>
parents: 37357
diff changeset
581 Replace rectangle contents with @var{string} on each line.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
582 (@code{string-rectangle}).
37447
0bc52782144f Adapt to the change of string-rectangle back to 20.x behaviour.
Gerd Moellmann <gerd@gnu.org>
parents: 37357
diff changeset
583 @item M-x string-insert-rectangle @key{RET} @var{string} @key{RET}
37572
956f7346b171 (Rectangles): Remove redundant and erroneous name of replace-rectangle
Eli Zaretskii <eliz@gnu.org>
parents: 37486
diff changeset
584 Insert @var{string} on each line of the rectangle.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
585 @end table
Dave Love <fx@gnu.org>
parents:
diff changeset
586
38461
23f63206a867 Proofreading fixes from Chris Green <chris_e_green@yahoo.com>.
Eli Zaretskii <eliz@gnu.org>
parents: 38415
diff changeset
587 The rectangle operations fall into two classes: commands for
23f63206a867 Proofreading fixes from Chris Green <chris_e_green@yahoo.com>.
Eli Zaretskii <eliz@gnu.org>
parents: 38415
diff changeset
588 deleting and inserting rectangles, and commands for blank rectangles.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
589
Dave Love <fx@gnu.org>
parents:
diff changeset
590 @kindex C-x r k
Dave Love <fx@gnu.org>
parents:
diff changeset
591 @kindex C-x r d
Dave Love <fx@gnu.org>
parents:
diff changeset
592 @findex kill-rectangle
Dave Love <fx@gnu.org>
parents:
diff changeset
593 @findex delete-rectangle
Dave Love <fx@gnu.org>
parents:
diff changeset
594 There are two ways to get rid of the text in a rectangle: you can
Dave Love <fx@gnu.org>
parents:
diff changeset
595 discard the text (delete it) or save it as the ``last killed''
Dave Love <fx@gnu.org>
parents:
diff changeset
596 rectangle. The commands for these two ways are @kbd{C-x r d}
Dave Love <fx@gnu.org>
parents:
diff changeset
597 (@code{delete-rectangle}) and @kbd{C-x r k} (@code{kill-rectangle}). In
Dave Love <fx@gnu.org>
parents:
diff changeset
598 either case, the portion of each line that falls inside the rectangle's
38461
23f63206a867 Proofreading fixes from Chris Green <chris_e_green@yahoo.com>.
Eli Zaretskii <eliz@gnu.org>
parents: 38415
diff changeset
599 boundaries is deleted, causing any following text on the line to
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
600 move left into the gap.
Dave Love <fx@gnu.org>
parents:
diff changeset
601
Dave Love <fx@gnu.org>
parents:
diff changeset
602 Note that ``killing'' a rectangle is not killing in the usual sense; the
Dave Love <fx@gnu.org>
parents:
diff changeset
603 rectangle is not stored in the kill ring, but in a special place that
Dave Love <fx@gnu.org>
parents:
diff changeset
604 can only record the most recent rectangle killed. This is because yanking
Dave Love <fx@gnu.org>
parents:
diff changeset
605 a rectangle is so different from yanking linear text that different yank
68510
80b042d12556 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 68260
diff changeset
606 commands have to be used. It is hard to define yank-popping for rectangles,
80b042d12556 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 68260
diff changeset
607 so we do not try.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
608
Dave Love <fx@gnu.org>
parents:
diff changeset
609 @kindex C-x r y
Dave Love <fx@gnu.org>
parents:
diff changeset
610 @findex yank-rectangle
Dave Love <fx@gnu.org>
parents:
diff changeset
611 To yank the last killed rectangle, type @kbd{C-x r y}
Dave Love <fx@gnu.org>
parents:
diff changeset
612 (@code{yank-rectangle}). Yanking a rectangle is the opposite of killing
Dave Love <fx@gnu.org>
parents:
diff changeset
613 one. Point specifies where to put the rectangle's upper left corner.
Dave Love <fx@gnu.org>
parents:
diff changeset
614 The rectangle's first line is inserted there, the rectangle's second
38481
33c054df8f9f Add a missing word.
Eli Zaretskii <eliz@gnu.org>
parents: 38461
diff changeset
615 line is inserted at the same horizontal position, but one line
33c054df8f9f Add a missing word.
Eli Zaretskii <eliz@gnu.org>
parents: 38461
diff changeset
616 vertically down, and so on. The number of lines affected is determined
33c054df8f9f Add a missing word.
Eli Zaretskii <eliz@gnu.org>
parents: 38461
diff changeset
617 by the height of the saved rectangle.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
618
Dave Love <fx@gnu.org>
parents:
diff changeset
619 You can convert single-column lists into double-column lists using
Dave Love <fx@gnu.org>
parents:
diff changeset
620 rectangle killing and yanking; kill the second half of the list as a
Dave Love <fx@gnu.org>
parents:
diff changeset
621 rectangle and then yank it beside the first line of the list.
Dave Love <fx@gnu.org>
parents:
diff changeset
622 @xref{Two-Column}, for another way to edit multi-column text.
Dave Love <fx@gnu.org>
parents:
diff changeset
623
Dave Love <fx@gnu.org>
parents:
diff changeset
624 You can also copy rectangles into and out of registers with @kbd{C-x r
Dave Love <fx@gnu.org>
parents:
diff changeset
625 r @var{r}} and @kbd{C-x r i @var{r}}. @xref{RegRect,,Rectangle
Dave Love <fx@gnu.org>
parents:
diff changeset
626 Registers}.
Dave Love <fx@gnu.org>
parents:
diff changeset
627
Dave Love <fx@gnu.org>
parents:
diff changeset
628 @kindex C-x r o
Dave Love <fx@gnu.org>
parents:
diff changeset
629 @findex open-rectangle
49330
99f721b3f74e (Rectangles): Document C-x c r.
Richard M. Stallman <rms@gnu.org>
parents: 47200
diff changeset
630 @kindex C-x r c
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
631 @findex clear-rectangle
Dave Love <fx@gnu.org>
parents:
diff changeset
632 There are two commands you can use for making blank rectangles:
49330
99f721b3f74e (Rectangles): Document C-x c r.
Richard M. Stallman <rms@gnu.org>
parents: 47200
diff changeset
633 @kbd{C-x r c} (@code{clear-rectangle}) which blanks out existing text,
99f721b3f74e (Rectangles): Document C-x c r.
Richard M. Stallman <rms@gnu.org>
parents: 47200
diff changeset
634 and @kbd{C-x r o} (@code{open-rectangle}) which inserts a blank
99f721b3f74e (Rectangles): Document C-x c r.
Richard M. Stallman <rms@gnu.org>
parents: 47200
diff changeset
635 rectangle. Clearing a rectangle is equivalent to deleting it and then
99f721b3f74e (Rectangles): Document C-x c r.
Richard M. Stallman <rms@gnu.org>
parents: 47200
diff changeset
636 inserting a blank rectangle of the same size.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
637
Dave Love <fx@gnu.org>
parents:
diff changeset
638 @findex delete-whitespace-rectangle
Dave Love <fx@gnu.org>
parents:
diff changeset
639 The command @kbd{M-x delete-whitespace-rectangle} deletes horizontal
Dave Love <fx@gnu.org>
parents:
diff changeset
640 whitespace starting from a particular column. This applies to each of
Dave Love <fx@gnu.org>
parents:
diff changeset
641 the lines in the rectangle, and the column is specified by the left
Dave Love <fx@gnu.org>
parents:
diff changeset
642 edge of the rectangle. The right edge of the rectangle does not make
Dave Love <fx@gnu.org>
parents:
diff changeset
643 any difference to this command.
Dave Love <fx@gnu.org>
parents:
diff changeset
644
Dave Love <fx@gnu.org>
parents:
diff changeset
645 @kindex C-x r t
Dave Love <fx@gnu.org>
parents:
diff changeset
646 @findex string-rectangle
37585
d44c87635f6e (Rectangles): Remove the description of replace-rectangle.
Eli Zaretskii <eliz@gnu.org>
parents: 37572
diff changeset
647 The command @kbd{C-x r t} (@code{string-rectangle}) replaces the
37447
0bc52782144f Adapt to the change of string-rectangle back to 20.x behaviour.
Gerd Moellmann <gerd@gnu.org>
parents: 37357
diff changeset
648 contents of a region-rectangle with a string on each line. The
0bc52782144f Adapt to the change of string-rectangle back to 20.x behaviour.
Gerd Moellmann <gerd@gnu.org>
parents: 37357
diff changeset
649 string's width need not be the same as the width of the rectangle. If
0bc52782144f Adapt to the change of string-rectangle back to 20.x behaviour.
Gerd Moellmann <gerd@gnu.org>
parents: 37357
diff changeset
650 the string's width is less, the text after the rectangle shifts left;
0bc52782144f Adapt to the change of string-rectangle back to 20.x behaviour.
Gerd Moellmann <gerd@gnu.org>
parents: 37357
diff changeset
651 if the string is wider than the rectangle, the text after the
0bc52782144f Adapt to the change of string-rectangle back to 20.x behaviour.
Gerd Moellmann <gerd@gnu.org>
parents: 37357
diff changeset
652 rectangle shifts right.
33805
7d3fd66a3ac3 Fix string-rectangle doc.
Dave Love <fx@gnu.org>
parents: 30895
diff changeset
653
37447
0bc52782144f Adapt to the change of string-rectangle back to 20.x behaviour.
Gerd Moellmann <gerd@gnu.org>
parents: 37357
diff changeset
654 @findex string-insert-rectangle
49600
23a1cea22d13 Trailing whitespace deleted.
Juanma Barranquero <lekktu@gmail.com>
parents: 49330
diff changeset
655 The command @kbd{M-x string-insert-rectangle} is similar to
23a1cea22d13 Trailing whitespace deleted.
Juanma Barranquero <lekktu@gmail.com>
parents: 49330
diff changeset
656 @code{string-rectangle}, but inserts the string on each line,
37447
0bc52782144f Adapt to the change of string-rectangle back to 20.x behaviour.
Gerd Moellmann <gerd@gnu.org>
parents: 37357
diff changeset
657 shifting the original text to the right.
52401
695cf19ef79e Add arch taglines
Miles Bader <miles@gnu.org>
parents: 49600
diff changeset
658
66782
e30f43430f3c * killing.texi (CUA Bindings): New node. Moved here from
Kim F. Storm <storm@cua.dk>
parents: 64890
diff changeset
659 @node CUA Bindings, Registers, Rectangles, Top
66787
0d11e9f86005 (CUA Bindings): Add @section.
Luc Teirlinck <teirllm@auburn.edu>
parents: 66782
diff changeset
660 @section CUA Bindings
66782
e30f43430f3c * killing.texi (CUA Bindings): New node. Moved here from
Kim F. Storm <storm@cua.dk>
parents: 64890
diff changeset
661 @findex cua-mode
e30f43430f3c * killing.texi (CUA Bindings): New node. Moved here from
Kim F. Storm <storm@cua.dk>
parents: 64890
diff changeset
662 @vindex cua-mode
e30f43430f3c * killing.texi (CUA Bindings): New node. Moved here from
Kim F. Storm <storm@cua.dk>
parents: 64890
diff changeset
663 @cindex CUA key bindings
e30f43430f3c * killing.texi (CUA Bindings): New node. Moved here from
Kim F. Storm <storm@cua.dk>
parents: 64890
diff changeset
664 @vindex cua-enable-cua-keys
e30f43430f3c * killing.texi (CUA Bindings): New node. Moved here from
Kim F. Storm <storm@cua.dk>
parents: 64890
diff changeset
665 The command @kbd{M-x cua-mode} sets up key bindings that are
e30f43430f3c * killing.texi (CUA Bindings): New node. Moved here from
Kim F. Storm <storm@cua.dk>
parents: 64890
diff changeset
666 compatible with the Common User Access (CUA) system used in many other
e30f43430f3c * killing.texi (CUA Bindings): New node. Moved here from
Kim F. Storm <storm@cua.dk>
parents: 64890
diff changeset
667 applications. @kbd{C-x} means cut (kill), @kbd{C-c} copy, @kbd{C-v}
e30f43430f3c * killing.texi (CUA Bindings): New node. Moved here from
Kim F. Storm <storm@cua.dk>
parents: 64890
diff changeset
668 paste (yank), and @kbd{C-z} undo. Standard Emacs commands like
e30f43430f3c * killing.texi (CUA Bindings): New node. Moved here from
Kim F. Storm <storm@cua.dk>
parents: 64890
diff changeset
669 @kbd{C-x C-c} still work, because @kbd{C-x} and @kbd{C-c} only take
67434
6d3669227452 (CUA Bindings): Describe how to use C-x and C-c as
Kim F. Storm <storm@cua.dk>
parents: 66787
diff changeset
670 effect when the mark is active (and the region is highlighted).
68510
80b042d12556 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 68260
diff changeset
671 However, if you don't want to override these bindings Emacs at all, set
67434
6d3669227452 (CUA Bindings): Describe how to use C-x and C-c as
Kim F. Storm <storm@cua.dk>
parents: 66787
diff changeset
672 @code{cua-enable-cua-keys} to @code{nil}.
66782
e30f43430f3c * killing.texi (CUA Bindings): New node. Moved here from
Kim F. Storm <storm@cua.dk>
parents: 64890
diff changeset
673
e30f43430f3c * killing.texi (CUA Bindings): New node. Moved here from
Kim F. Storm <storm@cua.dk>
parents: 64890
diff changeset
674 In CUA mode, using @kbd{Shift} together with the movement keys
67434
6d3669227452 (CUA Bindings): Describe how to use C-x and C-c as
Kim F. Storm <storm@cua.dk>
parents: 66787
diff changeset
675 activates and highlights the region over which they move. The
6d3669227452 (CUA Bindings): Describe how to use C-x and C-c as
Kim F. Storm <storm@cua.dk>
parents: 66787
diff changeset
676 standard (unshifted) movement keys deactivate the mark, and typed text
6d3669227452 (CUA Bindings): Describe how to use C-x and C-c as
Kim F. Storm <storm@cua.dk>
parents: 66787
diff changeset
677 replaces the active region as in Delete-Selection mode
6d3669227452 (CUA Bindings): Describe how to use C-x and C-c as
Kim F. Storm <storm@cua.dk>
parents: 66787
diff changeset
678 (@pxref{Graphical Kill}).
6d3669227452 (CUA Bindings): Describe how to use C-x and C-c as
Kim F. Storm <storm@cua.dk>
parents: 66787
diff changeset
679
68510
80b042d12556 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 68260
diff changeset
680 To enter an Emacs command like @kbd{C-x C-f} while the mark is
80b042d12556 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 68260
diff changeset
681 active, use one of the following methods: either hold @kbd{Shift}
80b042d12556 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 68260
diff changeset
682 together with the prefix key, e.g. @kbd{S-C-x C-f}, or quickly type
80b042d12556 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 68260
diff changeset
683 the prefix key twice, e.g. @kbd{C-x C-x C-f}.
66782
e30f43430f3c * killing.texi (CUA Bindings): New node. Moved here from
Kim F. Storm <storm@cua.dk>
parents: 64890
diff changeset
684
e30f43430f3c * killing.texi (CUA Bindings): New node. Moved here from
Kim F. Storm <storm@cua.dk>
parents: 64890
diff changeset
685 @cindex rectangle highlighting
e30f43430f3c * killing.texi (CUA Bindings): New node. Moved here from
Kim F. Storm <storm@cua.dk>
parents: 64890
diff changeset
686 CUA mode provides enhanced rectangle support with visible
e30f43430f3c * killing.texi (CUA Bindings): New node. Moved here from
Kim F. Storm <storm@cua.dk>
parents: 64890
diff changeset
687 rectangle highlighting. Use @kbd{C-RET} to start a rectangle,
e30f43430f3c * killing.texi (CUA Bindings): New node. Moved here from
Kim F. Storm <storm@cua.dk>
parents: 64890
diff changeset
688 extend it using the movement commands, and cut or copy it using
67434
6d3669227452 (CUA Bindings): Describe how to use C-x and C-c as
Kim F. Storm <storm@cua.dk>
parents: 66787
diff changeset
689 @kbd{C-x} or @kbd{C-c}. @kbd{RET} moves the cursor to the next
6d3669227452 (CUA Bindings): Describe how to use C-x and C-c as
Kim F. Storm <storm@cua.dk>
parents: 66787
diff changeset
690 (clockwise) corner of the rectangle, so you can easily expand it in
6d3669227452 (CUA Bindings): Describe how to use C-x and C-c as
Kim F. Storm <storm@cua.dk>
parents: 66787
diff changeset
691 any direction. Normal text you type is inserted to the left or right
6d3669227452 (CUA Bindings): Describe how to use C-x and C-c as
Kim F. Storm <storm@cua.dk>
parents: 66787
diff changeset
692 of each line in the rectangle (on the same side as the cursor).
66782
e30f43430f3c * killing.texi (CUA Bindings): New node. Moved here from
Kim F. Storm <storm@cua.dk>
parents: 64890
diff changeset
693
e30f43430f3c * killing.texi (CUA Bindings): New node. Moved here from
Kim F. Storm <storm@cua.dk>
parents: 64890
diff changeset
694 With CUA you can easily copy text and rectangles into and out of
71751
bf3a186a50a6 Fix typos.
Nick Roberts <nickrob@snap.net.nz>
parents: 70360
diff changeset
695 registers by providing a one-digit numeric prefix to the kill, copy,
66782
e30f43430f3c * killing.texi (CUA Bindings): New node. Moved here from
Kim F. Storm <storm@cua.dk>
parents: 64890
diff changeset
696 and yank commands, e.g. @kbd{C-1 C-c} copies the region into register
e30f43430f3c * killing.texi (CUA Bindings): New node. Moved here from
Kim F. Storm <storm@cua.dk>
parents: 64890
diff changeset
697 @code{1}, and @kbd{C-2 C-v} yanks the contents of register @code{2}.
e30f43430f3c * killing.texi (CUA Bindings): New node. Moved here from
Kim F. Storm <storm@cua.dk>
parents: 64890
diff changeset
698
e30f43430f3c * killing.texi (CUA Bindings): New node. Moved here from
Kim F. Storm <storm@cua.dk>
parents: 64890
diff changeset
699 @cindex global mark
e30f43430f3c * killing.texi (CUA Bindings): New node. Moved here from
Kim F. Storm <storm@cua.dk>
parents: 64890
diff changeset
700 CUA mode also has a global mark feature which allows easy moving and
e30f43430f3c * killing.texi (CUA Bindings): New node. Moved here from
Kim F. Storm <storm@cua.dk>
parents: 64890
diff changeset
701 copying of text between buffers. Use @kbd{C-S-SPC} to toggle the
e30f43430f3c * killing.texi (CUA Bindings): New node. Moved here from
Kim F. Storm <storm@cua.dk>
parents: 64890
diff changeset
702 global mark on and off. When the global mark is on, all text that you
e30f43430f3c * killing.texi (CUA Bindings): New node. Moved here from
Kim F. Storm <storm@cua.dk>
parents: 64890
diff changeset
703 kill or copy is automatically inserted at the global mark, and text
e30f43430f3c * killing.texi (CUA Bindings): New node. Moved here from
Kim F. Storm <storm@cua.dk>
parents: 64890
diff changeset
704 you type is inserted at the global mark rather than at the current
e30f43430f3c * killing.texi (CUA Bindings): New node. Moved here from
Kim F. Storm <storm@cua.dk>
parents: 64890
diff changeset
705 position.
e30f43430f3c * killing.texi (CUA Bindings): New node. Moved here from
Kim F. Storm <storm@cua.dk>
parents: 64890
diff changeset
706
e30f43430f3c * killing.texi (CUA Bindings): New node. Moved here from
Kim F. Storm <storm@cua.dk>
parents: 64890
diff changeset
707 For example, to copy words from various buffers into a word list in
e30f43430f3c * killing.texi (CUA Bindings): New node. Moved here from
Kim F. Storm <storm@cua.dk>
parents: 64890
diff changeset
708 a given buffer, set the global mark in the target buffer, then
e30f43430f3c * killing.texi (CUA Bindings): New node. Moved here from
Kim F. Storm <storm@cua.dk>
parents: 64890
diff changeset
709 navigate to each of the words you want in the list, mark it (e.g. with
e30f43430f3c * killing.texi (CUA Bindings): New node. Moved here from
Kim F. Storm <storm@cua.dk>
parents: 64890
diff changeset
710 @kbd{S-M-f}), copy it to the list with @kbd{C-c} or @kbd{M-w}, and
e30f43430f3c * killing.texi (CUA Bindings): New node. Moved here from
Kim F. Storm <storm@cua.dk>
parents: 64890
diff changeset
711 insert a newline after the word in the target list by pressing
e30f43430f3c * killing.texi (CUA Bindings): New node. Moved here from
Kim F. Storm <storm@cua.dk>
parents: 64890
diff changeset
712 @key{RET}.
e30f43430f3c * killing.texi (CUA Bindings): New node. Moved here from
Kim F. Storm <storm@cua.dk>
parents: 64890
diff changeset
713
56810
24bffa640391 Adapt sectioning in Info to the node structure.
Luc Teirlinck <teirllm@auburn.edu>
parents: 56692
diff changeset
714 @ifnottex
24bffa640391 Adapt sectioning in Info to the node structure.
Luc Teirlinck <teirllm@auburn.edu>
parents: 56692
diff changeset
715 @lowersections
24bffa640391 Adapt sectioning in Info to the node structure.
Luc Teirlinck <teirllm@auburn.edu>
parents: 56692
diff changeset
716 @end ifnottex
24bffa640391 Adapt sectioning in Info to the node structure.
Luc Teirlinck <teirllm@auburn.edu>
parents: 56692
diff changeset
717
52401
695cf19ef79e Add arch taglines
Miles Bader <miles@gnu.org>
parents: 49600
diff changeset
718 @ignore
695cf19ef79e Add arch taglines
Miles Bader <miles@gnu.org>
parents: 49600
diff changeset
719 arch-tag: d8da8f96-0928-449a-816e-ff2d3497866c
695cf19ef79e Add arch taglines
Miles Bader <miles@gnu.org>
parents: 49600
diff changeset
720 @end ignore