aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorRichard M. Stallman2005-02-06 11:06:56 +0000
committerRichard M. Stallman2005-02-06 11:06:56 +0000
commit1b53c26efbef002c7d668a08cc8ceb7113628dc3 (patch)
tree5107f597a5012272bdb3ada91d627becb9a5f294
parente319d01792c29206f0f4517d6de77609e407f585 (diff)
downloademacs-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.texi68
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
75inserts a newline character in the buffer. If point is in the middle of 75inserts a newline character in the buffer. If point is in the middle of
76a line, @key{RET} splits the line. Typing @key{DEL} when the cursor is 76a line, the effect is to split the line. Typing @key{DEL} when the cursor is
77at the beginning of a line deletes the preceding newline, thus joining 77at the beginning of a line deletes the preceding newline, thus joining
78the line with the preceding line. 78the 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->
220Move to the end of the buffer (@code{end-of-buffer}). 220Move to the end of the buffer (@code{end-of-buffer}).
221@item C-v 221@item C-v
222Scroll the display one screen forward, and move point if necessary to put 222@itemx @key{PAGEDOWN}
223it on the screen (@code{scroll-up}). This doesn't always 223@itemx @key{PRIOR}
224move point, but it is commonly used to do so. 224Scroll the display one screen forward, and move point if necessary to
225If your keyboard has a @key{PAGEDOWN} key, it does the same thing. 225put it on the screen (@code{scroll-up}). This doesn't always move
226point, 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
227Scrolling commands are further described in @ref{Scrolling}. 229Scrolling commands are further described in @ref{Scrolling}.
228@item M-v 230@item M-v
231@itemx @key{PAGEUP}
232@itemx @key{NEXT}
229Scroll one screen backward, and move point if necessary to put it on 233Scroll one screen backward, and move point if necessary to put it on
230the screen (@code{scroll-down}). This doesn't always move point, but 234the screen (@code{scroll-down}). This doesn't always move point, but
231it is commonly used to do so. The @key{PAGEUP} key has the same 235it is commonly used to do so. If your keyboard has a @key{PAGEUP} or
232effect. 236@key{NEXT} key, it does the same thing.
233@item M-x goto-char 237@item M-x goto-char
234Read a number @var{n} and move point to buffer position @var{n}. 238Read a number @var{n} and move point to buffer position @var{n}.
235Position 1 is the beginning of the buffer. 239Position 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
260the buffer (just as @kbd{C-p} gets an error on the first line). But 264the last line of the buffer. But if you set the variable
261if 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
262non-@code{nil} value, @kbd{C-n} on the last line of a buffer creates 266the last line of a buffer creates an additional line at the end and
263an additional line at the end and moves down onto it. 267moves 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
320Undo one batch of changes---usually, one command worth (@code{undo}). 324Undo one batch of changes---usually, one command worth (@code{undo}).
321@item C-_ 325@item C-_
326@itemx C-/
322The same. 327The same.
323@item C-u C-x u 328@item C-u C-x u
324Undo one batch of changes in the region. 329Undo 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.
331you give this command, it undoes the last change. Point moves back to 337The first time you give this command, it undoes the last change.
332where it was before the command that made the change. 338Point moves back to where it was before the command that made the
339change.
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
335earlier changes, back to the limit of the undo information available. 342earlier 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
348can also perform @dfn{selective undo}, limited to the current region. 355can also perform @dfn{selective undo}, limited to the current region
356(@pxref{The Region}).
349To do this, specify the region you want, then run the @code{undo} 357To do this, specify the region you want, then run the @code{undo}
350command with a prefix argument (the value does not matter): @kbd{C-u C-x 358command with a prefix argument (the value does not matter): @kbd{C-u C-x
351u} or @kbd{C-u C-_}. This undoes the most recent change in the region. 359u} or @kbd{C-u C-_}. This undoes the most recent change in the region.
352To undo further changes in the same region, repeat the @code{undo} 360To undo further changes in the same region, repeat the @code{undo}
353command (no prefix argument is needed). In Transient Mark mode, any use 361command (no prefix argument is needed). In Transient Mark mode
354of @code{undo} when there is an active region performs selective undo; 362(@pxref{Transient Mark}), any use of @code{undo} when there is an
355you do not need a prefix argument. 363active region performs selective undo; you do not need a prefix
364argument.
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
358easiest way to recover is to type @kbd{C-_} repeatedly until the stars 367easiest 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
407undo data, then it is probably a bug and you should report it. 416undo 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 420u}, @kbd{C-_} and @kbd{C-/}, is that it is worthy of a
412key, but on some keyboards it is not obvious how to type @kbd{C-_}. 421single-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 422beginners to type.
414terminal.
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
726specify a numeric argument is to type digits and/or a minus sign while 734PC keyboards), the easiest way to specify a numeric argument is to
727holding down the @key{META} key. For example, 735type digits and/or a minus sign while holding down the @key{META} key.
736For example,
728 737
729@example 738@example
730M-5 C-n 739M-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
778argument. A few others may treat an argument of just a minus sign 787argument. A few others may treat an argument of just a minus sign
779differently from an argument of @minus{}1. These unusual cases are 788differently from an argument of @minus{}1. These unusual cases are
780described when they come up; they are always for reasons of convenience 789described when they come up; they are always for reasons of
781of use of the individual command. 790convenience of use of the individual command, and they are documented
791in 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
784character. This is straightforward unless the character is a digit; for 794character. This is straightforward unless the character is a digit; for