aboutsummaryrefslogtreecommitdiffstats
path: root/man/killing.texi
diff options
context:
space:
mode:
authorEli Zaretskii2001-07-17 10:50:35 +0000
committerEli Zaretskii2001-07-17 10:50:35 +0000
commit58fa012dac718ff7097828ba99aabea688c96ea8 (patch)
tree4c19295641407f32e8a24265dbb781b7a4168030 /man/killing.texi
parent12de6e2620330e1d42286a9673b9253369812432 (diff)
downloademacs-58fa012dac718ff7097828ba99aabea688c96ea8.tar.gz
emacs-58fa012dac718ff7097828ba99aabea688c96ea8.zip
Proofreading fixes from Chris Green <chris_e_green@yahoo.com>.
Diffstat (limited to 'man/killing.texi')
-rw-r--r--man/killing.texi54
1 files changed, 28 insertions, 26 deletions
diff --git a/man/killing.texi b/man/killing.texi
index 7b1dc865c94..c3d6930c56c 100644
--- a/man/killing.texi
+++ b/man/killing.texi
@@ -47,11 +47,12 @@ deleting it from the buffer. When this happens, a message in the echo
47area tells you what is happening. 47area tells you what is happening.
48 48
49 The delete commands include @kbd{C-d} (@code{delete-char}) and 49 The delete commands include @kbd{C-d} (@code{delete-char}) and
50@key{DEL} (@code{delete-backward-char}), which delete only one character at 50@key{DEL} (@code{delete-backward-char}), which delete only one
51a time, and those commands that delete only spaces or newlines. Commands 51character at a time, and those commands that delete only spaces or
52that can destroy significant amounts of nontrivial data generally kill. 52newlines. Commands that can destroy significant amounts of nontrivial
53The commands' names and individual descriptions use the words @samp{kill} 53data generally do a kill operation instead. The commands' names and
54and @samp{delete} to say which they do. 54individual descriptions use the words @samp{kill} and @samp{delete} to
55say which kind of operation they perform.
55 56
56@cindex Delete Selection mode 57@cindex Delete Selection mode
57@cindex mode, Delete Selection 58@cindex mode, Delete Selection
@@ -132,7 +133,7 @@ should be.
132 133
133 Why do we say ``or it should be''? When Emacs starts up using a 134 Why do we say ``or it should be''? When Emacs starts up using a
134window system, it determines automatically which key or keys should be 135window system, it determines automatically which key or keys should be
135equivalent to @key{DEL}. So the @key{BACKSPACE} and/or @key{DELETE} 136equivalent to @key{DEL}. As a result, @key{BACKSPACE} and/or @key{DELETE}
136keys normally do the right things. But in some unusual cases Emacs 137keys normally do the right things. But in some unusual cases Emacs
137gets the wrong information from the system. If these keys don't do 138gets the wrong information from the system. If these keys don't do
138what they ought to do, you need to tell Emacs which key to use for 139what they ought to do, you need to tell Emacs which key to use for
@@ -144,7 +145,7 @@ keyboard really has, so it follows a uniform plan which may or may not
144fit your keyboard. The uniform plan is that the ASCII @key{DEL} 145fit your keyboard. The uniform plan is that the ASCII @key{DEL}
145character deletes, and the ASCII @key{BS} (backspace) character asks 146character deletes, and the ASCII @key{BS} (backspace) character asks
146for help (it is the same as @kbd{C-h}). If this is not right for your 147for help (it is the same as @kbd{C-h}). If this is not right for your
147keyboard, if you find that the key which ought to delete backwards 148keyboard, i.e.@: if you find that the key which ought to delete backwards
148enters Help instead, see @ref{DEL Gets Help}. 149enters Help instead, see @ref{DEL Gets Help}.
149 150
150@kindex M-\ 151@kindex M-\
@@ -157,7 +158,7 @@ characters: spaces, tabs and newlines. @kbd{M-\}
157characters before and after point. @kbd{M-@key{SPC}} 158characters before and after point. @kbd{M-@key{SPC}}
158(@code{just-one-space}) does likewise but leaves a single space after 159(@code{just-one-space}) does likewise but leaves a single space after
159point, regardless of the number of spaces that existed previously (even 160point, regardless of the number of spaces that existed previously (even
160zero). 161if there were none before).
161 162
162 @kbd{C-x C-o} (@code{delete-blank-lines}) deletes all blank lines 163 @kbd{C-x C-o} (@code{delete-blank-lines}) deletes all blank lines
163after the current line. If the current line is blank, it deletes all 164after the current line. If the current line is blank, it deletes all
@@ -192,7 +193,7 @@ of the line, you can be sure @kbd{C-k} will kill the newline.
192 193
193 When @kbd{C-k} is given a positive argument, it kills that many lines 194 When @kbd{C-k} is given a positive argument, it kills that many lines
194and the newlines that follow them (however, text on the current line 195and the newlines that follow them (however, text on the current line
195before point is spared). With a negative argument @minus{}@var{n}, it 196before point is not killed). With a negative argument @minus{}@var{n}, it
196kills @var{n} lines preceding the current line (together with the text 197kills @var{n} lines preceding the current line (together with the text
197on the current line before point). Thus, @kbd{C-u - 2 C-k} at the front 198on the current line before point). Thus, @kbd{C-u - 2 C-k} at the front
198of a line kills the two previous lines. 199of a line kills the two previous lines.
@@ -343,8 +344,9 @@ This is a line @point{}of sample text.
343with point shown by @point{}. If you type @kbd{M-d M-@key{DEL} M-d 344with point shown by @point{}. If you type @kbd{M-d M-@key{DEL} M-d
344M-@key{DEL}}, killing alternately forward and backward, you end up with 345M-@key{DEL}}, killing alternately forward and backward, you end up with
345@samp{a line of sample} as one entry in the kill ring, and @samp{This 346@samp{a line of sample} as one entry in the kill ring, and @samp{This
346is@ @ text.} in the buffer. (Note the double space, which you can clean 347is@ @ text.} in the buffer. (Note the double space between @samp{is}
347up with @kbd{M-@key{SPC}} or @kbd{M-q}.) 348and @samp{text}, which you can clean up with @kbd{M-@key{SPC}} or
349@kbd{M-q}.)
348 350
349 Another way to kill the same text is to move back two words with 351 Another way to kill the same text is to move back two words with
350@kbd{M-b M-b}, then kill all four words forward with @kbd{C-u M-d}. 352@kbd{M-b M-b}, then kill all four words forward with @kbd{C-u M-d}.
@@ -390,7 +392,7 @@ yank'' pointer moves to the newly made entry at the front of the ring.
390text in the buffer changes to match. Enough @kbd{M-y} commands can move 392text in the buffer changes to match. Enough @kbd{M-y} commands can move
391the pointer to any entry in the ring, so you can get any entry into the 393the pointer to any entry in the ring, so you can get any entry into the
392buffer. Eventually the pointer reaches the end of the ring; the next 394buffer. Eventually the pointer reaches the end of the ring; the next
393@kbd{M-y} moves it to the first entry again. 395@kbd{M-y} loops back around to the first entry again.
394 396
395 @kbd{M-y} moves the ``last yank'' pointer around the ring, but it does 397 @kbd{M-y} moves the ``last yank'' pointer around the ring, but it does
396not change the order of the entries in the ring, which always runs from 398not change the order of the entries in the ring, which always runs from
@@ -444,15 +446,15 @@ scattered pieces of text into a buffer or into a file.
444 446
445@table @kbd 447@table @kbd
446@item M-x append-to-buffer 448@item M-x append-to-buffer
447Append region to contents of specified buffer. 449Append region to the contents of specified buffer.
448@item M-x prepend-to-buffer 450@item M-x prepend-to-buffer
449Prepend region to contents of specified buffer. 451Prepend region to the contents of specified buffer.
450@item M-x copy-to-buffer 452@item M-x copy-to-buffer
451Copy region into specified buffer, deleting that buffer's old contents. 453Copy region into a specified buffer, deleting that buffer's old contents.
452@item M-x insert-buffer 454@item M-x insert-buffer
453Insert contents of specified buffer into current buffer at point. 455Insert the contents of specified buffer into current buffer at point.
454@item M-x append-to-file 456@item M-x append-to-file
455Append region to contents of specified file, at the end. 457Append region to the contents of specified file, at the end.
456@end table 458@end table
457 459
458 To accumulate text into a buffer, use @kbd{M-x append-to-buffer}. 460 To accumulate text into a buffer, use @kbd{M-x append-to-buffer}.
@@ -461,7 +463,7 @@ buffer specified. If you specify a nonexistent buffer,
461@code{append-to-buffer} creates the buffer. The text is inserted 463@code{append-to-buffer} creates the buffer. The text is inserted
462wherever point is in that buffer. If you have been using the buffer for 464wherever point is in that buffer. If you have been using the buffer for
463editing, the copied text goes into the middle of the text of the buffer, 465editing, the copied text goes into the middle of the text of the buffer,
464wherever point happens to be in it. 466starting from wherever point happens to be at that moment.
465 467
466 Point in that buffer is left at the end of the copied text, so 468 Point in that buffer is left at the end of the copied text, so
467successive uses of @code{append-to-buffer} accumulate the text in the 469successive uses of @code{append-to-buffer} accumulate the text in the
@@ -474,7 +476,7 @@ a buffer, then point is always at the end.
474 @kbd{M-x prepend-to-buffer} is just like @code{append-to-buffer} 476 @kbd{M-x prepend-to-buffer} is just like @code{append-to-buffer}
475except that point in the other buffer is left before the copied text, so 477except that point in the other buffer is left before the copied text, so
476successive prependings add text in reverse order. @kbd{M-x 478successive prependings add text in reverse order. @kbd{M-x
477copy-to-buffer} is similar except that any existing text in the other 479copy-to-buffer} is similar, except that any existing text in the other
478buffer is deleted, so the buffer is left containing just the text newly 480buffer is deleted, so the buffer is left containing just the text newly
479copied into it. 481copied into it.
480 482
@@ -512,7 +514,7 @@ text into or out of such formats.
512 When you must specify a rectangle for a command to work on, you do it 514 When you must specify a rectangle for a command to work on, you do it
513by putting the mark at one corner and point at the opposite corner. The 515by putting the mark at one corner and point at the opposite corner. The
514rectangle thus specified is called the @dfn{region-rectangle} because 516rectangle thus specified is called the @dfn{region-rectangle} because
515you control it in about the same way the region is controlled. But 517you control it in much the same way as the region is controlled. But
516remember that a given combination of point and mark values can be 518remember that a given combination of point and mark values can be
517interpreted either as a region or as a rectangle, depending on the 519interpreted either as a region or as a rectangle, depending on the
518command that uses them. 520command that uses them.
@@ -548,8 +550,8 @@ Replace rectangle contents with @var{string} on each line.
548Insert @var{string} on each line of the rectangle. 550Insert @var{string} on each line of the rectangle.
549@end table 551@end table
550 552
551 The rectangle operations fall into two classes: commands deleting and 553 The rectangle operations fall into two classes: commands for
552inserting rectangles, and commands for blank rectangles. 554deleting and inserting rectangles, and commands for blank rectangles.
553 555
554@kindex C-x r k 556@kindex C-x r k
555@kindex C-x r d 557@kindex C-x r d
@@ -560,7 +562,7 @@ discard the text (delete it) or save it as the ``last killed''
560rectangle. The commands for these two ways are @kbd{C-x r d} 562rectangle. The commands for these two ways are @kbd{C-x r d}
561(@code{delete-rectangle}) and @kbd{C-x r k} (@code{kill-rectangle}). In 563(@code{delete-rectangle}) and @kbd{C-x r k} (@code{kill-rectangle}). In
562either case, the portion of each line that falls inside the rectangle's 564either case, the portion of each line that falls inside the rectangle's
563boundaries is deleted, causing following text (if any) on the line to 565boundaries is deleted, causing any following text on the line to
564move left into the gap. 566move left into the gap.
565 567
566 Note that ``killing'' a rectangle is not killing in the usual sense; the 568 Note that ``killing'' a rectangle is not killing in the usual sense; the
@@ -575,9 +577,9 @@ commands have to be used and yank-popping is hard to make sense of.
575(@code{yank-rectangle}). Yanking a rectangle is the opposite of killing 577(@code{yank-rectangle}). Yanking a rectangle is the opposite of killing
576one. Point specifies where to put the rectangle's upper left corner. 578one. Point specifies where to put the rectangle's upper left corner.
577The rectangle's first line is inserted there, the rectangle's second 579The rectangle's first line is inserted there, the rectangle's second
578line is inserted at a position one line vertically down, and so on. The 580line is inserted at the same horizontal, but one line vertically down,
579number of lines affected is determined by the height of the saved 581and so on. The number of lines affected is determined by the height of
580rectangle. 582the saved rectangle.
581 583
582 You can convert single-column lists into double-column lists using 584 You can convert single-column lists into double-column lists using
583rectangle killing and yanking; kill the second half of the list as a 585rectangle killing and yanking; kill the second half of the list as a