diff options
| author | Michael Witten | 2012-07-07 18:34:37 +0800 |
|---|---|---|
| committer | Chong Yidong | 2012-07-07 18:34:37 +0800 |
| commit | 95486d4692b6ff84acfff905feade29b944d70f5 (patch) | |
| tree | dbc11e8b36d539de953589c6e4ff8a89b064be43 /etc/tutorials | |
| parent | 938a4ef926c7063140b2821b27a90814a1048e64 (diff) | |
| download | emacs-95486d4692b6ff84acfff905feade29b944d70f5.tar.gz emacs-95486d4692b6ff84acfff905feade29b944d70f5.zip | |
* tutorials/TUTORIAL: Copyedits.
Fixes: debbugs:11689
Diffstat (limited to 'etc/tutorials')
| -rw-r--r-- | etc/tutorials/TUTORIAL | 59 |
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 | |||
| 16 | try using a command. For instance: | 16 | try 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, | |||
| 30 | with C-v. To move backwards one screen, type M-v (hold down the META key | 30 | with C-v. To move backwards one screen, type M-v (hold down the META key |
| 31 | and type v, or type <ESC>v if you do not have a META, EDIT, or ALT key). | 31 | and 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 | |||
| 209 | something different. | 209 | something different. |
| 210 | 210 | ||
| 211 | C-v and M-v are another kind of exception. When given an argument, | 211 | C-v and M-v are another kind of exception. When given an argument, |
| 212 | they scroll the screen up or down by that many lines, rather than by a | 212 | they scroll the text up or down by that many lines, rather than by a |
| 213 | screenful. For example, C-u 8 C-v scrolls the screen by 8 lines. | 213 | screenful. 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 | ||
| 217 | This should have scrolled the screen up by 8 lines. If you would like | 217 | This should have scrolled the text up by 8 lines. If you would like |
| 218 | to scroll it down again, you can give an argument to M-v. | 218 | to scroll it down again, you can give an argument to M-v. |
| 219 | 219 | ||
| 220 | If you are using a graphical display, such as X or MS-Windows, there | 220 | If 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 | ||
| 284 | This command is unlike the other commands you have learned in that it | ||
| 285 | consists of two characters. It starts with the character CONTROL-x. | ||
| 286 | There is a whole series of commands that start with CONTROL-x; many of | 284 | There is a whole series of commands that start with CONTROL-x; many of |
| 287 | them have to do with windows, files, buffers, and related things. | 285 | them have to do with windows, files, buffers, and related things. |
| 288 | These commands are two, three or four characters long. | 286 | These commands are two, three or four characters long. |
| @@ -337,7 +335,7 @@ Remember that most Emacs commands can be given a repeat count; | |||
| 337 | this includes text characters. Repeating a text character inserts | 335 | this includes text characters. Repeating a text character inserts |
| 338 | it several times. | 336 | it 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 | ||
| 342 | You've now learned the most basic way of typing something in | 340 | You've now learned the most basic way of typing something in |
| 343 | Emacs and correcting errors. You can delete by words or lines | 341 | Emacs and correcting errors. You can delete by words or lines |
| @@ -522,11 +520,8 @@ command | |||
| 522 | This copies the text within Emacs into the file. The first time you | 520 | This copies the text within Emacs into the file. The first time you |
| 523 | do this, Emacs renames the original file to a new name so that it is | 521 | do this, Emacs renames the original file to a new name so that it is |
| 524 | not lost. The new name is made by adding "~" to the end of the | 522 | not lost. The new name is made by adding "~" to the end of the |
| 525 | original file's name. | 523 | original file's name. When saving is finished, Emacs displays the |
| 526 | 524 | name of the file written. | |
| 527 | When saving is finished, Emacs displays the name of the file written. | ||
| 528 | You should save fairly often, so that you will not lose very much | ||
| 529 | work 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 | ||
| 535 | You can find an existing file, to view it or edit it. You can also | 530 | You can find an existing file, to view it or edit it. You can also |
| 536 | find a file which does not already exist. This is the way to create a | 531 | find a file which does not already exist. This is the way to create a |
| 537 | file with Emacs: find the file, which will start out empty, and then | 532 | file with Emacs: find the file, which starts out empty, and then begin |
| 538 | begin inserting the text for the file. When you ask to "save" the | 533 | inserting the text for the file. When you ask to "save" the file, |
| 539 | file, Emacs will really create the file with the text that you have | 534 | Emacs actually creates the file with the text that you have inserted. |
| 540 | inserted. From then on, you can consider yourself to be editing an | 535 | From then on, you can consider yourself to be editing an already |
| 541 | already existing file. | 536 | existing 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, | |||
| 595 | in that file's buffer. The creation or editing of the second file's | 590 | in that file's buffer. The creation or editing of the second file's |
| 596 | buffer has no effect on the first file's buffer. This is very useful, | 591 | buffer has no effect on the first file's buffer. This is very useful, |
| 597 | but it also means that you need a convenient way to save the first | 592 | but it also means that you need a convenient way to save the first |
| 598 | file's buffer. It would be a nuisance to have to switch back to | 593 | file's buffer. Having to switch back to that buffer, in order to save |
| 599 | it with C-x C-f in order to save it with C-x C-s. So we have | 594 | it 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 | |||
| 631 | command to move from Emacs to another application. You can do this | 626 | command to move from Emacs to another application. You can do this |
| 632 | with the mouse or with window manager commands. However, if you're | 627 | with the mouse or with window manager commands. However, if you're |
| 633 | using a text terminal which can only show one application at a time, | 628 | using a text terminal which can only show one application at a time, |
| 634 | you need to "suspend" Emacs to move to any other program. | 629 | you need to "suspend" Emacs to move to any other application. |
| 635 | 630 | ||
| 636 | C-z is the command to exit Emacs *temporarily*--so that you can go | 631 | C-z is the command to exit Emacs *temporarily*--so that you can go |
| 637 | back to the same Emacs session afterward. When Emacs is running on a | 632 | back 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 | |||
| 640 | can resume Emacs with the `fg' command or with `%emacs'. | 635 | can resume Emacs with the `fg' command or with `%emacs'. |
| 641 | 636 | ||
| 642 | The time to use C-x C-c is when you are about to log out. It's also | 637 | The time to use C-x C-c is when you are about to log out. It's also |
| 643 | the right thing to use to exit an Emacs invoked under mail handling | 638 | the right thing to use to exit an Emacs invoked for a quick edit, such |
| 644 | programs and other miscellaneous utilities. | 639 | as by a mail handling utility. |
| 645 | 640 | ||
| 646 | There are many C-x commands. Here is a list of the ones you have learned: | 641 | There 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 | ||
| 657 | Named eXtended commands are commands which are used even less | 652 | Named eXtended commands are commands which are used even less |
| 658 | frequently, or commands which are used only in certain modes. An | 653 | frequently, or commands which are used only in certain modes. An |
| 659 | example is the command replace-string, which globally replaces one | 654 | example is the command replace-string, which replaces one string with |
| 660 | string with another. When you type M-x, Emacs prompts you at the | 655 | another in the buffer. When you type M-x, Emacs prompts you at the |
| 661 | bottom of the screen with M-x and you should type the name of the | 656 | bottom of the screen with M-x and you should type the name of the |
| 662 | command; in this case, "replace-string". Just type "repl s<TAB>" and | 657 | command; in this case, "replace-string". Just type "repl s<TAB>" and |
| 663 | Emacs will complete the name. (<TAB> is the Tab key, usually found | 658 | Emacs 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 | ||
| 763 | To view documentation on your current major mode, type C-h m. | 758 | To 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 | ||
| 894 | The command C-M-v is very useful when you are editing text in one | 890 | The command C-M-v is very useful when you are editing text in one |
| 895 | window and using the other window just for reference. Without leaving | 891 | window and using the other window just for reference. Without leaving |
| 896 | the selected window, you can scroll the other window with C-M-v. | 892 | the selected window, you can scroll the text in the other window with |
| 893 | C-M-v. | ||
| 897 | 894 | ||
| 898 | C-M-v is an example of a CONTROL-META character. If you have a META | 895 | C-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 | ||
| 1043 | This displays in another window a list of all M-x commands with "file" | 1040 | This displays in another window a list of all M-x commands with "file" |
| 1044 | in their names. You will see character-commands like C-x C-f listed | 1041 | in their names. You will see character-commands listed beside the |
| 1045 | beside the corresponding command names such as find-file. | 1042 | corresponding 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 | ||