diff options
| author | Eli Zaretskii | 2001-07-17 10:50:35 +0000 |
|---|---|---|
| committer | Eli Zaretskii | 2001-07-17 10:50:35 +0000 |
| commit | 58fa012dac718ff7097828ba99aabea688c96ea8 (patch) | |
| tree | 4c19295641407f32e8a24265dbb781b7a4168030 /man/killing.texi | |
| parent | 12de6e2620330e1d42286a9673b9253369812432 (diff) | |
| download | emacs-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.texi | 54 |
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 | |||
| 47 | area tells you what is happening. | 47 | area 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 |
| 51 | a time, and those commands that delete only spaces or newlines. Commands | 51 | character at a time, and those commands that delete only spaces or |
| 52 | that can destroy significant amounts of nontrivial data generally kill. | 52 | newlines. Commands that can destroy significant amounts of nontrivial |
| 53 | The commands' names and individual descriptions use the words @samp{kill} | 53 | data generally do a kill operation instead. The commands' names and |
| 54 | and @samp{delete} to say which they do. | 54 | individual descriptions use the words @samp{kill} and @samp{delete} to |
| 55 | say 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 |
| 134 | window system, it determines automatically which key or keys should be | 135 | window system, it determines automatically which key or keys should be |
| 135 | equivalent to @key{DEL}. So the @key{BACKSPACE} and/or @key{DELETE} | 136 | equivalent to @key{DEL}. As a result, @key{BACKSPACE} and/or @key{DELETE} |
| 136 | keys normally do the right things. But in some unusual cases Emacs | 137 | keys normally do the right things. But in some unusual cases Emacs |
| 137 | gets the wrong information from the system. If these keys don't do | 138 | gets the wrong information from the system. If these keys don't do |
| 138 | what they ought to do, you need to tell Emacs which key to use for | 139 | what 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 | |||
| 144 | fit your keyboard. The uniform plan is that the ASCII @key{DEL} | 145 | fit your keyboard. The uniform plan is that the ASCII @key{DEL} |
| 145 | character deletes, and the ASCII @key{BS} (backspace) character asks | 146 | character deletes, and the ASCII @key{BS} (backspace) character asks |
| 146 | for help (it is the same as @kbd{C-h}). If this is not right for your | 147 | for help (it is the same as @kbd{C-h}). If this is not right for your |
| 147 | keyboard, if you find that the key which ought to delete backwards | 148 | keyboard, i.e.@: if you find that the key which ought to delete backwards |
| 148 | enters Help instead, see @ref{DEL Gets Help}. | 149 | enters 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-\} | |||
| 157 | characters before and after point. @kbd{M-@key{SPC}} | 158 | characters 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 |
| 159 | point, regardless of the number of spaces that existed previously (even | 160 | point, regardless of the number of spaces that existed previously (even |
| 160 | zero). | 161 | if 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 |
| 163 | after the current line. If the current line is blank, it deletes all | 164 | after 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 |
| 194 | and the newlines that follow them (however, text on the current line | 195 | and the newlines that follow them (however, text on the current line |
| 195 | before point is spared). With a negative argument @minus{}@var{n}, it | 196 | before point is not killed). With a negative argument @minus{}@var{n}, it |
| 196 | kills @var{n} lines preceding the current line (together with the text | 197 | kills @var{n} lines preceding the current line (together with the text |
| 197 | on the current line before point). Thus, @kbd{C-u - 2 C-k} at the front | 198 | on the current line before point). Thus, @kbd{C-u - 2 C-k} at the front |
| 198 | of a line kills the two previous lines. | 199 | of a line kills the two previous lines. |
| @@ -343,8 +344,9 @@ This is a line @point{}of sample text. | |||
| 343 | with point shown by @point{}. If you type @kbd{M-d M-@key{DEL} M-d | 344 | with point shown by @point{}. If you type @kbd{M-d M-@key{DEL} M-d |
| 344 | M-@key{DEL}}, killing alternately forward and backward, you end up with | 345 | M-@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 |
| 346 | is@ @ text.} in the buffer. (Note the double space, which you can clean | 347 | is@ @ text.} in the buffer. (Note the double space between @samp{is} |
| 347 | up with @kbd{M-@key{SPC}} or @kbd{M-q}.) | 348 | and @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. | |||
| 390 | text in the buffer changes to match. Enough @kbd{M-y} commands can move | 392 | text in the buffer changes to match. Enough @kbd{M-y} commands can move |
| 391 | the pointer to any entry in the ring, so you can get any entry into the | 393 | the pointer to any entry in the ring, so you can get any entry into the |
| 392 | buffer. Eventually the pointer reaches the end of the ring; the next | 394 | buffer. 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 |
| 396 | not change the order of the entries in the ring, which always runs from | 398 | not 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 |
| 447 | Append region to contents of specified buffer. | 449 | Append region to the contents of specified buffer. |
| 448 | @item M-x prepend-to-buffer | 450 | @item M-x prepend-to-buffer |
| 449 | Prepend region to contents of specified buffer. | 451 | Prepend region to the contents of specified buffer. |
| 450 | @item M-x copy-to-buffer | 452 | @item M-x copy-to-buffer |
| 451 | Copy region into specified buffer, deleting that buffer's old contents. | 453 | Copy region into a specified buffer, deleting that buffer's old contents. |
| 452 | @item M-x insert-buffer | 454 | @item M-x insert-buffer |
| 453 | Insert contents of specified buffer into current buffer at point. | 455 | Insert the contents of specified buffer into current buffer at point. |
| 454 | @item M-x append-to-file | 456 | @item M-x append-to-file |
| 455 | Append region to contents of specified file, at the end. | 457 | Append 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 |
| 462 | wherever point is in that buffer. If you have been using the buffer for | 464 | wherever point is in that buffer. If you have been using the buffer for |
| 463 | editing, the copied text goes into the middle of the text of the buffer, | 465 | editing, the copied text goes into the middle of the text of the buffer, |
| 464 | wherever point happens to be in it. | 466 | starting 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 |
| 467 | successive uses of @code{append-to-buffer} accumulate the text in the | 469 | successive 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} |
| 475 | except that point in the other buffer is left before the copied text, so | 477 | except that point in the other buffer is left before the copied text, so |
| 476 | successive prependings add text in reverse order. @kbd{M-x | 478 | successive prependings add text in reverse order. @kbd{M-x |
| 477 | copy-to-buffer} is similar except that any existing text in the other | 479 | copy-to-buffer} is similar, except that any existing text in the other |
| 478 | buffer is deleted, so the buffer is left containing just the text newly | 480 | buffer is deleted, so the buffer is left containing just the text newly |
| 479 | copied into it. | 481 | copied 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 |
| 513 | by putting the mark at one corner and point at the opposite corner. The | 515 | by putting the mark at one corner and point at the opposite corner. The |
| 514 | rectangle thus specified is called the @dfn{region-rectangle} because | 516 | rectangle thus specified is called the @dfn{region-rectangle} because |
| 515 | you control it in about the same way the region is controlled. But | 517 | you control it in much the same way as the region is controlled. But |
| 516 | remember that a given combination of point and mark values can be | 518 | remember that a given combination of point and mark values can be |
| 517 | interpreted either as a region or as a rectangle, depending on the | 519 | interpreted either as a region or as a rectangle, depending on the |
| 518 | command that uses them. | 520 | command that uses them. |
| @@ -548,8 +550,8 @@ Replace rectangle contents with @var{string} on each line. | |||
| 548 | Insert @var{string} on each line of the rectangle. | 550 | Insert @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 |
| 552 | inserting rectangles, and commands for blank rectangles. | 554 | deleting 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'' | |||
| 560 | rectangle. The commands for these two ways are @kbd{C-x r d} | 562 | rectangle. 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 |
| 562 | either case, the portion of each line that falls inside the rectangle's | 564 | either case, the portion of each line that falls inside the rectangle's |
| 563 | boundaries is deleted, causing following text (if any) on the line to | 565 | boundaries is deleted, causing any following text on the line to |
| 564 | move left into the gap. | 566 | move 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 |
| 576 | one. Point specifies where to put the rectangle's upper left corner. | 578 | one. Point specifies where to put the rectangle's upper left corner. |
| 577 | The rectangle's first line is inserted there, the rectangle's second | 579 | The rectangle's first line is inserted there, the rectangle's second |
| 578 | line is inserted at a position one line vertically down, and so on. The | 580 | line is inserted at the same horizontal, but one line vertically down, |
| 579 | number of lines affected is determined by the height of the saved | 581 | and so on. The number of lines affected is determined by the height of |
| 580 | rectangle. | 582 | the 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 |
| 583 | rectangle killing and yanking; kill the second half of the list as a | 585 | rectangle killing and yanking; kill the second half of the list as a |