# HG changeset patch # User Richard M. Stallman # Date 1107688016 0 # Node ID 801aa21b27e985b1bf89cf3deda3499f1a1ac4ba # Parent e966a59906490de0da3010b851268a3ccfd49e96 (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. diff -r e966a5990649 -r 801aa21b27e9 man/basic.texi --- a/man/basic.texi Sun Feb 06 11:03:40 2005 +0000 +++ b/man/basic.texi Sun Feb 06 11:06:56 2005 +0000 @@ -73,7 +73,7 @@ @cindex newline To end a line and start typing a new one, type @key{RET}. This inserts a newline character in the buffer. If point is in the middle of -a line, @key{RET} splits the line. Typing @key{DEL} when the cursor is +a line, the effect is to split the line. Typing @key{DEL} when the cursor is at the beginning of a line deletes the preceding newline, thus joining the line with the preceding line. @@ -219,17 +219,21 @@ @item M-> Move to the end of the buffer (@code{end-of-buffer}). @item C-v -Scroll the display one screen forward, and move point if necessary to put -it on the screen (@code{scroll-up}). This doesn't always -move point, but it is commonly used to do so. -If your keyboard has a @key{PAGEDOWN} key, it does the same thing. +@itemx @key{PAGEDOWN} +@itemx @key{PRIOR} +Scroll the display one screen forward, and move point if necessary to +put it on the screen (@code{scroll-up}). This doesn't always move +point, but it is commonly used to do so. If your keyboard has a +@key{PAGEDOWN} or @key{PRIOR} key, it does the same thing. Scrolling commands are further described in @ref{Scrolling}. @item M-v +@itemx @key{PAGEUP} +@itemx @key{NEXT} Scroll one screen backward, and move point if necessary to put it on the screen (@code{scroll-down}). This doesn't always move point, but -it is commonly used to do so. The @key{PAGEUP} key has the same -effect. +it is commonly used to do so. If your keyboard has a @key{PAGEUP} or +@key{NEXT} key, it does the same thing. @item M-x goto-char Read a number @var{n} and move point to buffer position @var{n}. Position 1 is the beginning of the buffer. @@ -256,11 +260,11 @@ @xref{Variables}, for how to set variables such as @code{track-eol}. @vindex next-line-add-newlines - @kbd{C-n} normally gets an error when you use it on the last line of -the buffer (just as @kbd{C-p} gets an error on the first line). But -if you set the variable @code{next-line-add-newlines} to a -non-@code{nil} value, @kbd{C-n} on the last line of a buffer creates -an additional line at the end and moves down onto it. + @kbd{C-n} normally stops at the end of the bufer when you use it on +the last line of the buffer. But if you set the variable +@code{next-line-add-newlines} to a non-@code{nil} value, @kbd{C-n} on +the last line of a buffer creates an additional line at the end and +moves down onto it. @node Erasing @section Erasing Text @@ -319,6 +323,7 @@ @item C-x u Undo one batch of changes---usually, one command worth (@code{undo}). @item C-_ +@itemx C-/ The same. @item C-u C-x u Undo one batch of changes in the region. @@ -326,10 +331,12 @@ @kindex C-x u @kindex C-_ +@kindex C-/ @findex undo - The command @kbd{C-x u} or @kbd{C-_} is how you undo. The first time -you give this command, it undoes the last change. Point moves back to -where it was before the command that made the change. + The command @kbd{C-x u} (or @kbd{C-_} or @kbd{C-/}) is how you undo. +The first time you give this command, it undoes the last change. +Point moves back to where it was before the command that made the +change. Consecutive repetitions of @kbd{C-_} or @kbd{C-x u} undo earlier and earlier changes, back to the limit of the undo information available. @@ -345,14 +352,16 @@ @cindex selective undo @kindex C-u C-x u Ordinary undo applies to all changes made in the current buffer. You -can also perform @dfn{selective undo}, limited to the current region. +can also perform @dfn{selective undo}, limited to the current region +(@pxref{The Region}). To do this, specify the region you want, then run the @code{undo} command with a prefix argument (the value does not matter): @kbd{C-u C-x u} or @kbd{C-u C-_}. This undoes the most recent change in the region. To undo further changes in the same region, repeat the @code{undo} -command (no prefix argument is needed). In Transient Mark mode, any use -of @code{undo} when there is an active region performs selective undo; -you do not need a prefix argument. +command (no prefix argument is needed). In Transient Mark mode +(@pxref{Transient Mark}), any use of @code{undo} when there is an +active region performs selective undo; you do not need a prefix +argument. If you notice that a buffer has been modified accidentally, the easiest way to recover is to type @kbd{C-_} repeatedly until the stars @@ -407,11 +416,10 @@ undo data, then it is probably a bug and you should report it. @xref{Bugs,, Reporting Bugs}. - The reason the @code{undo} command has two keys, @kbd{C-x u} and -@kbd{C-_}, set up to run it is that it is worthy of a single-character -key, but on some keyboards it is not obvious how to type @kbd{C-_}. -@kbd{C-x u} is an alternative you can type straightforwardly on any -terminal. + The reason the @code{undo} command has three key bindings, @kbd{C-x +u}, @kbd{C-_} and @kbd{C-/}, is that it is worthy of a +single-character key, but @kbd{C-x u} is more straightforward for +beginners to type. @node Basic Files @section Files @@ -722,9 +730,10 @@ @kindex M-@t{-} @findex digit-argument @findex negative-argument - If your terminal keyboard has a @key{META} key, the easiest way to -specify a numeric argument is to type digits and/or a minus sign while -holding down the @key{META} key. For example, + If your terminal keyboard has a @key{META} key (labeled @key{ALT} on +PC keyboards), the easiest way to specify a numeric argument is to +type digits and/or a minus sign while holding down the @key{META} key. +For example, @example M-5 C-n @@ -777,8 +786,9 @@ A few commands treat a plain @kbd{C-u} differently from an ordinary argument. A few others may treat an argument of just a minus sign differently from an argument of @minus{}1. These unusual cases are -described when they come up; they are always for reasons of convenience -of use of the individual command. +described when they come up; they are always for reasons of +convenience of use of the individual command, and they are documented +in the command's documentation string. You can use a numeric argument to insert multiple copies of a character. This is straightforward unless the character is a digit; for