diff options
| author | Richard M. Stallman | 2005-02-06 11:06:56 +0000 |
|---|---|---|
| committer | Richard M. Stallman | 2005-02-06 11:06:56 +0000 |
| commit | 1b53c26efbef002c7d668a08cc8ceb7113628dc3 (patch) | |
| tree | 5107f597a5012272bdb3ada91d627becb9a5f294 | |
| parent | e319d01792c29206f0f4517d6de77609e407f585 (diff) | |
| download | emacs-1b53c26efbef002c7d668a08cc8ceb7113628dc3.tar.gz emacs-1b53c26efbef002c7d668a08cc8ceb7113628dc3.zip | |
(Inserting Text): Cleanup wording.
(Moving Point): Doc PRIOR, PAGEUP, NEXT, PAGEDOWN more systematically.
C-n is not error at end of buffer.
(Undo): Doc C-/ like C-_. Add xrefs.
(Arguments): META key may be labeled ALT.
Peculiar arg meanings are explained in doc strings.
| -rw-r--r-- | man/basic.texi | 68 |
1 files changed, 39 insertions, 29 deletions
diff --git a/man/basic.texi b/man/basic.texi index 1598de2632a..dabc65defd9 100644 --- a/man/basic.texi +++ b/man/basic.texi | |||
| @@ -73,7 +73,7 @@ point, the one underneath the cursor, like @kbd{C-d} (see below). | |||
| 73 | @cindex newline | 73 | @cindex newline |
| 74 | To end a line and start typing a new one, type @key{RET}. This | 74 | To end a line and start typing a new one, type @key{RET}. This |
| 75 | inserts a newline character in the buffer. If point is in the middle of | 75 | inserts a newline character in the buffer. If point is in the middle of |
| 76 | a line, @key{RET} splits the line. Typing @key{DEL} when the cursor is | 76 | a line, the effect is to split the line. Typing @key{DEL} when the cursor is |
| 77 | at the beginning of a line deletes the preceding newline, thus joining | 77 | at the beginning of a line deletes the preceding newline, thus joining |
| 78 | the line with the preceding line. | 78 | the line with the preceding line. |
| 79 | 79 | ||
| @@ -219,17 +219,21 @@ numeric argument @var{n}, move to @var{n}/10 of the way from the top. | |||
| 219 | @item M-> | 219 | @item M-> |
| 220 | Move to the end of the buffer (@code{end-of-buffer}). | 220 | Move to the end of the buffer (@code{end-of-buffer}). |
| 221 | @item C-v | 221 | @item C-v |
| 222 | Scroll the display one screen forward, and move point if necessary to put | 222 | @itemx @key{PAGEDOWN} |
| 223 | it on the screen (@code{scroll-up}). This doesn't always | 223 | @itemx @key{PRIOR} |
| 224 | move point, but it is commonly used to do so. | 224 | Scroll the display one screen forward, and move point if necessary to |
| 225 | If your keyboard has a @key{PAGEDOWN} key, it does the same thing. | 225 | put it on the screen (@code{scroll-up}). This doesn't always move |
| 226 | point, but it is commonly used to do so. If your keyboard has a | ||
| 227 | @key{PAGEDOWN} or @key{PRIOR} key, it does the same thing. | ||
| 226 | 228 | ||
| 227 | Scrolling commands are further described in @ref{Scrolling}. | 229 | Scrolling commands are further described in @ref{Scrolling}. |
| 228 | @item M-v | 230 | @item M-v |
| 231 | @itemx @key{PAGEUP} | ||
| 232 | @itemx @key{NEXT} | ||
| 229 | Scroll one screen backward, and move point if necessary to put it on | 233 | Scroll one screen backward, and move point if necessary to put it on |
| 230 | the screen (@code{scroll-down}). This doesn't always move point, but | 234 | the screen (@code{scroll-down}). This doesn't always move point, but |
| 231 | it is commonly used to do so. The @key{PAGEUP} key has the same | 235 | it is commonly used to do so. If your keyboard has a @key{PAGEUP} or |
| 232 | effect. | 236 | @key{NEXT} key, it does the same thing. |
| 233 | @item M-x goto-char | 237 | @item M-x goto-char |
| 234 | Read a number @var{n} and move point to buffer position @var{n}. | 238 | Read a number @var{n} and move point to buffer position @var{n}. |
| 235 | Position 1 is the beginning of the buffer. | 239 | Position 1 is the beginning of the buffer. |
| @@ -256,11 +260,11 @@ to the end of another line. Normally, @code{track-eol} is @code{nil}. | |||
| 256 | @xref{Variables}, for how to set variables such as @code{track-eol}. | 260 | @xref{Variables}, for how to set variables such as @code{track-eol}. |
| 257 | 261 | ||
| 258 | @vindex next-line-add-newlines | 262 | @vindex next-line-add-newlines |
| 259 | @kbd{C-n} normally gets an error when you use it on the last line of | 263 | @kbd{C-n} normally stops at the end of the bufer when you use it on |
| 260 | the buffer (just as @kbd{C-p} gets an error on the first line). But | 264 | the last line of the buffer. But if you set the variable |
| 261 | if you set the variable @code{next-line-add-newlines} to a | 265 | @code{next-line-add-newlines} to a non-@code{nil} value, @kbd{C-n} on |
| 262 | non-@code{nil} value, @kbd{C-n} on the last line of a buffer creates | 266 | the last line of a buffer creates an additional line at the end and |
| 263 | an additional line at the end and moves down onto it. | 267 | moves down onto it. |
| 264 | 268 | ||
| 265 | @node Erasing | 269 | @node Erasing |
| 266 | @section Erasing Text | 270 | @section Erasing Text |
| @@ -319,6 +323,7 @@ tedious. | |||
| 319 | @item C-x u | 323 | @item C-x u |
| 320 | Undo one batch of changes---usually, one command worth (@code{undo}). | 324 | Undo one batch of changes---usually, one command worth (@code{undo}). |
| 321 | @item C-_ | 325 | @item C-_ |
| 326 | @itemx C-/ | ||
| 322 | The same. | 327 | The same. |
| 323 | @item C-u C-x u | 328 | @item C-u C-x u |
| 324 | Undo one batch of changes in the region. | 329 | Undo one batch of changes in the region. |
| @@ -326,10 +331,12 @@ Undo one batch of changes in the region. | |||
| 326 | 331 | ||
| 327 | @kindex C-x u | 332 | @kindex C-x u |
| 328 | @kindex C-_ | 333 | @kindex C-_ |
| 334 | @kindex C-/ | ||
| 329 | @findex undo | 335 | @findex undo |
| 330 | The command @kbd{C-x u} or @kbd{C-_} is how you undo. The first time | 336 | The command @kbd{C-x u} (or @kbd{C-_} or @kbd{C-/}) is how you undo. |
| 331 | you give this command, it undoes the last change. Point moves back to | 337 | The first time you give this command, it undoes the last change. |
| 332 | where it was before the command that made the change. | 338 | Point moves back to where it was before the command that made the |
| 339 | change. | ||
| 333 | 340 | ||
| 334 | Consecutive repetitions of @kbd{C-_} or @kbd{C-x u} undo earlier and | 341 | Consecutive repetitions of @kbd{C-_} or @kbd{C-x u} undo earlier and |
| 335 | earlier changes, back to the limit of the undo information available. | 342 | earlier changes, back to the limit of the undo information available. |
| @@ -345,14 +352,16 @@ the sequence of undoing, then type more undo commands. | |||
| 345 | @cindex selective undo | 352 | @cindex selective undo |
| 346 | @kindex C-u C-x u | 353 | @kindex C-u C-x u |
| 347 | Ordinary undo applies to all changes made in the current buffer. You | 354 | Ordinary undo applies to all changes made in the current buffer. You |
| 348 | can also perform @dfn{selective undo}, limited to the current region. | 355 | can also perform @dfn{selective undo}, limited to the current region |
| 356 | (@pxref{The Region}). | ||
| 349 | To do this, specify the region you want, then run the @code{undo} | 357 | To do this, specify the region you want, then run the @code{undo} |
| 350 | command with a prefix argument (the value does not matter): @kbd{C-u C-x | 358 | command with a prefix argument (the value does not matter): @kbd{C-u C-x |
| 351 | u} or @kbd{C-u C-_}. This undoes the most recent change in the region. | 359 | u} or @kbd{C-u C-_}. This undoes the most recent change in the region. |
| 352 | To undo further changes in the same region, repeat the @code{undo} | 360 | To undo further changes in the same region, repeat the @code{undo} |
| 353 | command (no prefix argument is needed). In Transient Mark mode, any use | 361 | command (no prefix argument is needed). In Transient Mark mode |
| 354 | of @code{undo} when there is an active region performs selective undo; | 362 | (@pxref{Transient Mark}), any use of @code{undo} when there is an |
| 355 | you do not need a prefix argument. | 363 | active region performs selective undo; you do not need a prefix |
| 364 | argument. | ||
| 356 | 365 | ||
| 357 | If you notice that a buffer has been modified accidentally, the | 366 | If you notice that a buffer has been modified accidentally, the |
| 358 | easiest way to recover is to type @kbd{C-_} repeatedly until the stars | 367 | easiest way to recover is to type @kbd{C-_} repeatedly until the stars |
| @@ -407,11 +416,10 @@ future. But if you didn't expect the command to create such large | |||
| 407 | undo data, then it is probably a bug and you should report it. | 416 | undo data, then it is probably a bug and you should report it. |
| 408 | @xref{Bugs,, Reporting Bugs}. | 417 | @xref{Bugs,, Reporting Bugs}. |
| 409 | 418 | ||
| 410 | The reason the @code{undo} command has two keys, @kbd{C-x u} and | 419 | The reason the @code{undo} command has three key bindings, @kbd{C-x |
| 411 | @kbd{C-_}, set up to run it is that it is worthy of a single-character | 420 | u}, @kbd{C-_} and @kbd{C-/}, is that it is worthy of a |
| 412 | key, but on some keyboards it is not obvious how to type @kbd{C-_}. | 421 | single-character key, but @kbd{C-x u} is more straightforward for |
| 413 | @kbd{C-x u} is an alternative you can type straightforwardly on any | 422 | beginners to type. |
| 414 | terminal. | ||
| 415 | 423 | ||
| 416 | @node Basic Files | 424 | @node Basic Files |
| 417 | @section Files | 425 | @section Files |
| @@ -722,9 +730,10 @@ act in the opposite direction. | |||
| 722 | @kindex M-@t{-} | 730 | @kindex M-@t{-} |
| 723 | @findex digit-argument | 731 | @findex digit-argument |
| 724 | @findex negative-argument | 732 | @findex negative-argument |
| 725 | If your terminal keyboard has a @key{META} key, the easiest way to | 733 | If your terminal keyboard has a @key{META} key (labeled @key{ALT} on |
| 726 | specify a numeric argument is to type digits and/or a minus sign while | 734 | PC keyboards), the easiest way to specify a numeric argument is to |
| 727 | holding down the @key{META} key. For example, | 735 | type digits and/or a minus sign while holding down the @key{META} key. |
| 736 | For example, | ||
| 728 | 737 | ||
| 729 | @example | 738 | @example |
| 730 | M-5 C-n | 739 | M-5 C-n |
| @@ -777,8 +786,9 @@ with an argument of one. (@xref{Killing}, for more information on | |||
| 777 | A few commands treat a plain @kbd{C-u} differently from an ordinary | 786 | A few commands treat a plain @kbd{C-u} differently from an ordinary |
| 778 | argument. A few others may treat an argument of just a minus sign | 787 | argument. A few others may treat an argument of just a minus sign |
| 779 | differently from an argument of @minus{}1. These unusual cases are | 788 | differently from an argument of @minus{}1. These unusual cases are |
| 780 | described when they come up; they are always for reasons of convenience | 789 | described when they come up; they are always for reasons of |
| 781 | of use of the individual command. | 790 | convenience of use of the individual command, and they are documented |
| 791 | in the command's documentation string. | ||
| 782 | 792 | ||
| 783 | You can use a numeric argument to insert multiple copies of a | 793 | You can use a numeric argument to insert multiple copies of a |
| 784 | character. This is straightforward unless the character is a digit; for | 794 | character. This is straightforward unless the character is a digit; for |