aboutsummaryrefslogtreecommitdiffstats
path: root/etc/tutorials
diff options
context:
space:
mode:
authorMichael Witten2012-07-07 18:34:37 +0800
committerChong Yidong2012-07-07 18:34:37 +0800
commit95486d4692b6ff84acfff905feade29b944d70f5 (patch)
treedbc11e8b36d539de953589c6e4ff8a89b064be43 /etc/tutorials
parent938a4ef926c7063140b2821b27a90814a1048e64 (diff)
downloademacs-95486d4692b6ff84acfff905feade29b944d70f5.tar.gz
emacs-95486d4692b6ff84acfff905feade29b944d70f5.zip
* tutorials/TUTORIAL: Copyedits.
Fixes: debbugs:11689
Diffstat (limited to 'etc/tutorials')
-rw-r--r--etc/tutorials/TUTORIAL59
1 files changed, 28 insertions, 31 deletions
diff --git a/etc/tutorials/TUTORIAL b/etc/tutorials/TUTORIAL
index ccd438ad629..b74d1421ee6 100644
--- a/etc/tutorials/TUTORIAL
+++ b/etc/tutorials/TUTORIAL
@@ -16,7 +16,7 @@ The characters ">>" at the left margin indicate directions for you to
16try using a command. For instance: 16try using a command. For instance:
17<<Blank lines inserted around following line by help-with-tutorial>> 17<<Blank lines inserted around following line by help-with-tutorial>>
18[Middle of page left blank for didactic purposes. Text continues below] 18[Middle of page left blank for didactic purposes. Text continues below]
19>> Now type C-v (View next screen) to move to the next screen. 19>> Now type C-v (View next screen) to move to the next screen.
20 (go ahead, do it by holding down the CONTROL key while typing v). 20 (go ahead, do it by holding down the CONTROL key while typing v).
21 From now on, you should do this again whenever you finish 21 From now on, you should do this again whenever you finish
22 reading the screen. 22 reading the screen.
@@ -30,7 +30,7 @@ to place in the text. You already know how to move forward one screen,
30with C-v. To move backwards one screen, type M-v (hold down the META key 30with C-v. To move backwards one screen, type M-v (hold down the META key
31and type v, or type <ESC>v if you do not have a META, EDIT, or ALT key). 31and type v, or type <ESC>v if you do not have a META, EDIT, or ALT key).
32 32
33>> Try typing M-v and then C-v, a few times. 33>> Try typing M-v and then C-v, a few times.
34 34
35 35
36* SUMMARY 36* SUMMARY
@@ -209,12 +209,12 @@ prefix argument, regardless of its value, makes the command do
209something different. 209something different.
210 210
211C-v and M-v are another kind of exception. When given an argument, 211C-v and M-v are another kind of exception. When given an argument,
212they scroll the screen up or down by that many lines, rather than by a 212they scroll the text up or down by that many lines, rather than by a
213screenful. For example, C-u 8 C-v scrolls the screen by 8 lines. 213screenful. For example, C-u 8 C-v scrolls by 8 lines.
214 214
215>> Try typing C-u 8 C-v now. 215>> Try typing C-u 8 C-v now.
216 216
217This should have scrolled the screen up by 8 lines. If you would like 217This should have scrolled the text up by 8 lines. If you would like
218to scroll it down again, you can give an argument to M-v. 218to scroll it down again, you can give an argument to M-v.
219 219
220If you are using a graphical display, such as X or MS-Windows, there 220If you are using a graphical display, such as X or MS-Windows, there
@@ -281,8 +281,6 @@ other windows.
281 281
282>> Type C-x 1 and see the documentation listing window disappear. 282>> Type C-x 1 and see the documentation listing window disappear.
283 283
284This command is unlike the other commands you have learned in that it
285consists of two characters. It starts with the character CONTROL-x.
286There is a whole series of commands that start with CONTROL-x; many of 284There is a whole series of commands that start with CONTROL-x; many of
287them have to do with windows, files, buffers, and related things. 285them have to do with windows, files, buffers, and related things.
288These commands are two, three or four characters long. 286These commands are two, three or four characters long.
@@ -337,7 +335,7 @@ Remember that most Emacs commands can be given a repeat count;
337this includes text characters. Repeating a text character inserts 335this includes text characters. Repeating a text character inserts
338it several times. 336it several times.
339 337
340>> Try that now -- type C-u 8 * to insert ********. 338>> Try that now -- type C-u 8 * to insert ********.
341 339
342You've now learned the most basic way of typing something in 340You've now learned the most basic way of typing something in
343Emacs and correcting errors. You can delete by words or lines 341Emacs and correcting errors. You can delete by words or lines
@@ -522,11 +520,8 @@ command
522This copies the text within Emacs into the file. The first time you 520This copies the text within Emacs into the file. The first time you
523do this, Emacs renames the original file to a new name so that it is 521do this, Emacs renames the original file to a new name so that it is
524not lost. The new name is made by adding "~" to the end of the 522not lost. The new name is made by adding "~" to the end of the
525original file's name. 523original file's name. When saving is finished, Emacs displays the
526 524name of the file written.
527When saving is finished, Emacs displays the name of the file written.
528You should save fairly often, so that you will not lose very much
529work if the system should crash (see the section "Auto Save" below).
530 525
531>> Type C-x C-s TUTORIAL <Return>. 526>> Type C-x C-s TUTORIAL <Return>.
532 This should save this tutorial to a file named TUTORIAL, and show 527 This should save this tutorial to a file named TUTORIAL, and show
@@ -534,11 +529,11 @@ work if the system should crash (see the section "Auto Save" below).
534 529
535You can find an existing file, to view it or edit it. You can also 530You can find an existing file, to view it or edit it. You can also
536find a file which does not already exist. This is the way to create a 531find a file which does not already exist. This is the way to create a
537file with Emacs: find the file, which will start out empty, and then 532file with Emacs: find the file, which starts out empty, and then begin
538begin inserting the text for the file. When you ask to "save" the 533inserting the text for the file. When you ask to "save" the file,
539file, Emacs will really create the file with the text that you have 534Emacs actually creates the file with the text that you have inserted.
540inserted. From then on, you can consider yourself to be editing an 535From then on, you can consider yourself to be editing an already
541already existing file. 536existing file.
542 537
543 538
544* BUFFERS 539* BUFFERS
@@ -595,8 +590,8 @@ this does not save the first file. Its changes remain inside Emacs,
595in that file's buffer. The creation or editing of the second file's 590in that file's buffer. The creation or editing of the second file's
596buffer has no effect on the first file's buffer. This is very useful, 591buffer has no effect on the first file's buffer. This is very useful,
597but it also means that you need a convenient way to save the first 592but it also means that you need a convenient way to save the first
598file's buffer. It would be a nuisance to have to switch back to 593file's buffer. Having to switch back to that buffer, in order to save
599it with C-x C-f in order to save it with C-x C-s. So we have 594it with C-x C-s, would be a nuisance. So we have
600 595
601 C-x s Save some buffers 596 C-x s Save some buffers
602 597
@@ -631,7 +626,7 @@ If you are using a graphical display, you don't need any special
631command to move from Emacs to another application. You can do this 626command to move from Emacs to another application. You can do this
632with the mouse or with window manager commands. However, if you're 627with the mouse or with window manager commands. However, if you're
633using a text terminal which can only show one application at a time, 628using a text terminal which can only show one application at a time,
634you need to "suspend" Emacs to move to any other program. 629you need to "suspend" Emacs to move to any other application.
635 630
636C-z is the command to exit Emacs *temporarily*--so that you can go 631C-z is the command to exit Emacs *temporarily*--so that you can go
637back to the same Emacs session afterward. When Emacs is running on a 632back to the same Emacs session afterward. When Emacs is running on a
@@ -640,8 +635,8 @@ but does not destroy the Emacs job. In the most common shells, you
640can resume Emacs with the `fg' command or with `%emacs'. 635can resume Emacs with the `fg' command or with `%emacs'.
641 636
642The time to use C-x C-c is when you are about to log out. It's also 637The time to use C-x C-c is when you are about to log out. It's also
643the right thing to use to exit an Emacs invoked under mail handling 638the right thing to use to exit an Emacs invoked for a quick edit, such
644programs and other miscellaneous utilities. 639as by a mail handling utility.
645 640
646There are many C-x commands. Here is a list of the ones you have learned: 641There are many C-x commands. Here is a list of the ones you have learned:
647 642
@@ -656,8 +651,8 @@ There are many C-x commands. Here is a list of the ones you have learned:
656 651
657Named eXtended commands are commands which are used even less 652Named eXtended commands are commands which are used even less
658frequently, or commands which are used only in certain modes. An 653frequently, or commands which are used only in certain modes. An
659example is the command replace-string, which globally replaces one 654example is the command replace-string, which replaces one string with
660string with another. When you type M-x, Emacs prompts you at the 655another in the buffer. When you type M-x, Emacs prompts you at the
661bottom of the screen with M-x and you should type the name of the 656bottom of the screen with M-x and you should type the name of the
662command; in this case, "replace-string". Just type "repl s<TAB>" and 657command; in this case, "replace-string". Just type "repl s<TAB>" and
663Emacs will complete the name. (<TAB> is the Tab key, usually found 658Emacs will complete the name. (<TAB> is the Tab key, usually found
@@ -671,9 +666,9 @@ argument with <Return>.
671>> Move the cursor to the blank line two lines below this one. 666>> Move the cursor to the blank line two lines below this one.
672 Then type M-x repl s<Return>changed<Return>altered<Return>. 667 Then type M-x repl s<Return>changed<Return>altered<Return>.
673 668
674 Notice how this line has changed: you've replaced 669 Notice how this line has changed: you've replaced the word
675 the word c-h-a-n-g-e-d with "altered" wherever it occurred, 670 "changed" with "altered" wherever it occurred, after the
676 after the initial position of the cursor. 671 initial position of the cursor.
677 672
678 673
679* AUTO SAVE 674* AUTO SAVE
@@ -762,6 +757,7 @@ differently.
762 757
763To view documentation on your current major mode, type C-h m. 758To view documentation on your current major mode, type C-h m.
764 759
760>> Move the cursor to the line following this line.
765>> Type C-l C-l to bring this line to the top of screen. 761>> Type C-l C-l to bring this line to the top of screen.
766>> Type C-h m, to see how Text mode differs from Fundamental mode. 762>> Type C-h m, to see how Text mode differs from Fundamental mode.
767>> Type C-x 1 to remove the documentation from the screen. 763>> Type C-x 1 to remove the documentation from the screen.
@@ -893,7 +889,8 @@ display, those cursors are drawn as unblinking hollow boxes.
893 889
894The command C-M-v is very useful when you are editing text in one 890The command C-M-v is very useful when you are editing text in one
895window and using the other window just for reference. Without leaving 891window and using the other window just for reference. Without leaving
896the selected window, you can scroll the other window with C-M-v. 892the selected window, you can scroll the text in the other window with
893C-M-v.
897 894
898C-M-v is an example of a CONTROL-META character. If you have a META 895C-M-v is an example of a CONTROL-META character. If you have a META
899(or Alt) key, you can type C-M-v by holding down both CONTROL and META 896(or Alt) key, you can type C-M-v by holding down both CONTROL and META
@@ -1041,8 +1038,8 @@ You need to type in the name of the variable when Emacs prompts for it.
1041>> Type C-h a file <Return>. 1038>> Type C-h a file <Return>.
1042 1039
1043This displays in another window a list of all M-x commands with "file" 1040This displays in another window a list of all M-x commands with "file"
1044in their names. You will see character-commands like C-x C-f listed 1041in their names. You will see character-commands listed beside the
1045beside the corresponding command names such as find-file. 1042corresponding command names (such as C-x C-f beside find-file).
1046 1043
1047>> Type C-M-v to scroll the help window. Do this a few times. 1044>> Type C-M-v to scroll the help window. Do this a few times.
1048 1045