on master help sign in
tutor: Normalize key names, capitalization, etc.
5077ce7Tim Siegel
runtime/tutor+68−72
@@ -16,7 +16,7 @@ _________________________________________________________________
16 perform various actions with the text. This allows for more
16 perform various actions with the text. This allows for more
17 efficient editing. This tutor will teach you how you can make
17 efficient editing. This tutor will teach you how you can make
18 use of Helix's modal editing features. To begin, ensure your
18 use of Helix's modal editing features. To begin, ensure your
19− caps-lock key is not pressed and hold the j key until you reach
19+ CapsLock key is not pressed and hold the j key until you reach
20 the first lesson.
20 the first lesson.
21
21
22
22
@@ -31,7 +31,7 @@ _________________________________________________________________
31 ↓
31 ↓
32
32
33 The cursor can be moved using the h, j, k, l keys, as shown
33 The cursor can be moved using the h, j, k, l keys, as shown
34− above. The cursor/arrow keys will also work, but it is faster
34+ above. The cursor / arrow keys will also work, but it is faster
35 to use the hjkl keys as they are closer to the other keys you
35 to use the hjkl keys as they are closer to the other keys you
36 will be using. Try moving around to get a feel for hjkl.
36 will be using. Try moving around to get a feel for hjkl.
37 Once you're ready, hold j to continue to the next lesson.
37 Once you're ready, hold j to continue to the next lesson.
@@ -48,13 +48,13 @@ _________________________________________________________________
48
48
49 1. Type : to enter Command mode. Your cursor will
49 1. Type : to enter Command mode. Your cursor will
50 move to the bottom of the screen.
50 move to the bottom of the screen.
51− 2. Type q or quit and type <ENTER> to exit Helix.
51+ 2. Type q or quit and type Enter to exit Helix.
52
52
53 Note: The quit command will fail if there are unsaved changes.
53 Note: The quit command will fail if there are unsaved changes.
54 To force quit and DISCARD these changes, type q! or quit!.
54 To force quit and DISCARD these changes, type q! or quit!.
55 You will learn how to save files later.
55 You will learn how to save files later.
56
56
57− To exit Command mode without entering a command, type <ESC>.
57+ To exit Command mode without entering a command, type Escape.
58
58
59 Now, move on to the next lesson.
59 Now, move on to the next lesson.
60
60
@@ -96,7 +96,7 @@ _________________________________________________________________
96 2. Move to a place in the line which is missing text and type
96 2. Move to a place in the line which is missing text and type
97 i to enter Insert mode. Keys you type will now type text.
97 i to enter Insert mode. Keys you type will now type text.
98 3. Enter the missing text.
98 3. Enter the missing text.
99− 4. type <ESC> to exit Insert mode and return to Normal mode.
99+ 4. type Escape to exit Insert mode and return to Normal mode.
100 5. Repeat until the line matches the line below it.
100 5. Repeat until the line matches the line below it.
101
101
102 --> Th stce misg so.
102 --> Th stce misg so.
@@ -112,18 +112,18 @@ _________________________________________________________________
112= 1.5 SAVING A FILE =
112= 1.5 SAVING A FILE =
113=================================================================
113=================================================================
114
114
115− Type :w/:write to save a file.
115+ Type :w / :write to save a file.
116
116
117 1. Exit Helix using :q! as explained before, or open a new
117 1. Exit Helix using :q! as explained before, or open a new
118 terminal.
118 terminal.
119 2. Open a file in Helix by running: hx FILENAME
119 2. Open a file in Helix by running: hx FILENAME
120 3. Make some edits to the file.
120 3. Make some edits to the file.
121 4. Type : to enter Command mode.
121 4. Type : to enter Command mode.
122− 5. Type w or write, and type <ENTER> to save the file.
122+ 5. Type w or write, and type Enter to save the file.
123
123
124 You can also type wq or write-quit to save and exit.
124 You can also type wq or write-quit to save and exit.
125
125
126− Note: You can optionally enter a filepath after the w/write
126+ Note: You can optionally enter a filepath after the w / write
127 command in order to save to that path.
127 command in order to save to that path.
128 Note: If there are any unsaved changes to a file, a plus [+]
128 Note: If there are any unsaved changes to a file, a plus [+]
129 will appear next to the file name in the status bar.
129 will appear next to the file name in the status bar.
@@ -137,15 +137,15 @@ _________________________________________________________________
137 * Use the h,j,k,l keys to move the cursor.
137 * Use the h,j,k,l keys to move the cursor.
138
138
139 * Type : to enter Command mode.
139 * Type : to enter Command mode.
140− * The q/quit and q!/quit! commands will exit Helix. The
140+ * The q / quit and q! / quit! commands will exit Helix. The
141 former fails when there are unsaved changes. The latter
141 former fails when there are unsaved changes. The latter
142 discards them.
142 discards them.
143− * The w/write command will save the file.
143+ * The w / write command will save the file.
144− * The wq/write-quit command will do both.
144+ * The wq / write-quit command will do both.
145
145
146 * Type d to delete the character at the cursor.
146 * Type d to delete the character at the cursor.
147
147
148− * Type i to enter Insert mode and type text. Type <ESC> to
148+ * Type i to enter Insert mode and type text. Type Escape to
149 return to Normal mode.
149 return to Normal mode.
150
150
151
151
@@ -167,7 +167,7 @@ _________________________________________________________________
167 A - Insert at the end of the line.
167 A - Insert at the end of the line.
168
168
169 1. Move to anywhere in the line marked '-->' below.
169 1. Move to anywhere in the line marked '-->' below.
170− 2. Type A (<SHIFT> + a), your cursor will move to the end of
170+ 2. Type A (Shift-a), your cursor will move to the end of
171 the line and you will be able to type.
171 the line and you will be able to type.
172 3. Type the text necessary to match the line below.
172 3. Type the text necessary to match the line below.
173
173
@@ -207,7 +207,7 @@ _________________________________________________________________
207
207
208 * Type A to enter Insert mode at the end of a line.
208 * Type A to enter Insert mode at the end of a line.
209
209
210− * Use o and O to open lines below/above the cursor respectively.
210+ * Use o and O to open lines below and above the cursor respectively.
211
211
212
212
213
213
@@ -307,11 +307,11 @@ _________________________________________________________________
307
307
308
308
309=================================================================
309=================================================================
310−= 3.5 SELECT/EXTEND MODE =
310+= 3.5 SELECT / EXTEND MODE =
311=================================================================
311=================================================================
312
312
313 Type v to enter Select mode.
313 Type v to enter Select mode.
314− Type v again or <ESC> to return to Normal mode
314+ Type v again or Escape to return to Normal mode
315 In Select mode every movement will extend the selection, as
315 In Select mode every movement will extend the selection, as
316 opposed to replacing it.
316 opposed to replacing it.
317
317
@@ -366,8 +366,8 @@ _________________________________________________________________
366
366
367 --> This is an error-free line with words to move around in.
367 --> This is an error-free line with words to move around in.
368
368
369− Note: This works the same in select mode.
369+ Note: This works the same in Select mode.
370− Note: Another related command is A-; which flips selections.
370+ Note: Another related command is Alt-; which flips selections.
371
371
372
372
373
373
@@ -405,7 +405,7 @@ _________________________________________________________________
405 3. Type u to undo your deletion.
405 3. Type u to undo your deletion.
406 4. Fix all the errors on the line.
406 4. Fix all the errors on the line.
407 5. Type u several times to undo your fixes.
407 5. Type u several times to undo your fixes.
408− 6. Type U (<SHIFT> + u) several times to redo your fixes.
408+ 6. Type U (Shift-u) several times to redo your fixes.
409
409
410 --> Fiix the errors on thhis line and reeplace them witth undo.
410 --> Fiix the errors on thhis line and reeplace them witth undo.
411
411
@@ -434,34 +434,32 @@ _________________________________________________________________
434 1 banana 2 banana 3 banana 4
434 1 banana 2 banana 3 banana 4
435
435
436 Note: Whenever you delete or change text, Helix will copy the
436 Note: Whenever you delete or change text, Helix will copy the
437− altered text. Use alt-d/c instead to avoid this.
437+ altered text. Use Alt-d / Alt-c instead to avoid this.
438 Note: Helix doesn't share the system clipboard by default. Type
438 Note: Helix doesn't share the system clipboard by default. Type
439− space-y/p to yank/paste on your computer's main clipboard.
439+ Space + y / p to yank / paste on the system's clipboard.
440
440
441=================================================================
441=================================================================
442= 4.3 SEARCHING IN FILE =
442= 4.3 SEARCHING IN FILE =
443=================================================================
443=================================================================
444
444
445− Type / to search forward in file, enter to confirm search.
445+ Type / to search forward in file, Enter to confirm search.
446 Type n to go to the next search match.
446 Type n to go to the next search match.
447 Type N to go to the previous search match.
447 Type N to go to the previous search match.
448
448
449 1. Type / and type in a common word, like 'banana'.
449 1. Type / and type in a common word, like 'banana'.
450− 2. Type enter to confirm the search.
450+ 2. Type Enter to confirm the search.
451 3. Use n and N to cycle through the matches.
451 3. Use n and N to cycle through the matches.
452
452
453 Searching uses regular expressions, allowing you to target more
453 Searching uses regular expressions, allowing you to target more
454 complex expressions, which you'll learn about in the lesson on
454 complex expressions, which you'll learn about in the lesson on
455 the select command.
455 the select command.
456
456
457− Note: To search backwards, type ? (shift-/).
457+ Note: To search backwards, type ? (Shift-/).
458 Note: Unlike Vim, ? doesn't change the search direction.
458 Note: Unlike Vim, ? doesn't change the search direction.
459 N always goes backwards and n always goes forwards.
459 N always goes backwards and n always goes forwards.
460
460
461
461
462
462
463−
464−
465=================================================================
463=================================================================
466= CHAPTER 4 RECAP =
464= CHAPTER 4 RECAP =
467=================================================================
465=================================================================
@@ -469,7 +467,7 @@ _________________________________________________________________
469 * Type u to undo. Type U to redo.
467 * Type u to undo. Type U to redo.
470
468
471 * Type y to yank (copy) text and p to paste.
469 * Type y to yank (copy) text and p to paste.
472− * Use space-Y and space-P to yank/paste on the system
470+ * Use Space + y and Space + p to yank / paste on the system
473 clipboard.
471 clipboard.
474
472
475 * Type / to search forward in file, and ? to search backwards.
473 * Type / to search forward in file, and ? to search backwards.
@@ -490,8 +488,8 @@ _________________________________________________________________
490
488
491 Type C to duplicate the cursor to the next suitable line.
489 Type C to duplicate the cursor to the next suitable line.
492
490
493− 1. Move the cursor to the first line below marked -->. Place
491+ 1. Move the cursor to the first line marked '-->' below. Place
494− the cursor on the first word.
492+ the cursor somewhere past the '-->'.
495 2. Type C to duplicate the cursor to the next suitable line.
493 2. Type C to duplicate the cursor to the next suitable line.
496 Notice how it skips the line in the middle. Keys you type
494 Notice how it skips the line in the middle. Keys you type
497 will now affect both cursors.
495 will now affect both cursors.
@@ -502,10 +500,9 @@ _________________________________________________________________
502 --> Fix th two nes at same ime.
500 --> Fix th two nes at same ime.
503 -->
501 -->
504 --> Fix th two nes at same ime.
502 --> Fix th two nes at same ime.
505−
506 Fix these two lines at the same time.
503 Fix these two lines at the same time.
507
504
508− Note: Type alt-C to do the same above the cursor.
505+ Note: Type Alt-C to do the same above the cursor.
509
506
510=================================================================
507=================================================================
511= 5.2 THE SELECT COMMAND =
508= 5.2 THE SELECT COMMAND =
@@ -516,11 +513,11 @@ _________________________________________________________________
516 1. Move the cursor to the line marked '-->' below.
513 1. Move the cursor to the line marked '-->' below.
517 2. Type x to select the line.
514 2. Type x to select the line.
518 3. Type s. A prompt will appear.
515 3. Type s. A prompt will appear.
519− 4. Type 'apples' and type <ENTER>. Both occurrences of
516+ 4. Type 'apples' and type Enter. Both occurrences of
520 'apples' in the line will be selected.
517 'apples' in the line will be selected.
521 5. You can now type c and change 'apples' to something else,
518 5. You can now type c and change 'apples' to something else,
522 like 'oranges'.
519 like 'oranges'.
523− 6. Type <ESC> to exit Insert mode.
520+ 6. Type Escape to exit Insert mode.
524 7. Type , to remove the second cursor.
521 7. Type , to remove the second cursor.
525
522
526 --> I like to eat apples since my favorite fruit is apples.
523 --> I like to eat apples since my favorite fruit is apples.
@@ -577,11 +574,11 @@ _________________________________________________________________
577= 5.5 SPLIT SELECTION INTO LINES =
574= 5.5 SPLIT SELECTION INTO LINES =
578=================================================================
575=================================================================
579
576
580− Type A-s (Alt-s) to split the selection(s) on newlines.
577+ Type Alt-s to split the selection(s) on newlines.
581
578
582 1. Move the cursor to the first row of the table below.
579 1. Move the cursor to the first row of the table below.
583 2. Select the entire table with 6x.
580 2. Select the entire table with 6x.
584− 3. Type A-s to split into selections at each line.
581+ 3. Type Alt-s to split into selections at each line.
585 4. Align the table with &.
582 4. Align the table with &.
586
583
587 | FRUIT | AMOUNT |
584 | FRUIT | AMOUNT |
@@ -607,7 +604,7 @@ _________________________________________________________________
607
604
608 * Type & to align selections.
605 * Type & to align selections.
609
606
610− * Type A-s to split the selection into lines.
607+ * Type Alt-s to split the selection into lines.
611
608
612
609
613
610
@@ -630,7 +627,7 @@ _________________________________________________________________
630 2. Type f[ to select to the square bracket.
627 2. Type f[ to select to the square bracket.
631 3. Type d to delete your selection.
628 3. Type d to delete your selection.
632 4. Go to the end of the line and repeat with F].
629 4. Go to the end of the line and repeat with F].
633− 5. Move to the second line marked -->, just after the arrow.
630+ 5. Move to the second line marked '-->', just after the arrow.
634 6. Use t and T to delete the dashes around the sentence.
631 6. Use t and T to delete the dashes around the sentence.
635
632
636 --> -----[Free this sentence of its brackets!]-----
633 --> -----[Free this sentence of its brackets!]-----
@@ -666,16 +663,16 @@ _________________________________________________________________
666=================================================================
663=================================================================
667
664
668 Type . to repeat the last insert command.
665 Type . to repeat the last insert command.
669− Type A-. to repeat the last f / t selection.
666+ Type Alt-. to repeat the last f / t selection.
670
667
671 1. Move the cursor to the line marked '-->' below.
668 1. Move the cursor to the line marked '-->' below.
672 2. Make a change, insertion or appendage and repeat it with . .
669 2. Make a change, insertion or appendage and repeat it with . .
673− 3. Try using A-. with f and t, to select multiple sentences for
670+ 3. Try using Alt-. with f and t, to select multiple sentences
674− instance.
671+ for instance.
675
672
676 --> This is some text for you to repeat things. You can repeat
673 --> This is some text for you to repeat things. You can repeat
677− insertions like changing words, or repeat selections like f/t.
674+ insertions like changing words, or repeat selections like
678−
675+ f / t.
679
676
680
677
681
678
@@ -693,7 +690,7 @@ _________________________________________________________________
693 * Type r to replace selected characters.
690 * Type r to replace selected characters.
694
691
695 * Type . to repeat the last insertion.
692 * Type . to repeat the last insertion.
696− * Type A-. to repeat the last f / t selection.
693+ * Type Alt-. to repeat the last f / t selection.
697
694
698
695
699
696
@@ -775,13 +772,13 @@ lines.
775= 7.4 INCREMENTING AND DECREMENTING =
772= 7.4 INCREMENTING AND DECREMENTING =
776=================================================================
773=================================================================
777
774
778− Type C-a to increment the number under selection.
775+ Type Ctrl-a to increment the number under selection.
779− Type C-x to decrement the number under selection.
776+ Type Ctrl-x to decrement the number under selection.
780
777
781 1. Move the cursor to the third line marked '-->' below.
778 1. Move the cursor to the third line marked '-->' below.
782− 2. Type C-a to increment the second point marked 2.
779+ 2. Type Ctrl-a to increment the second point marked 2.
783 3. Repeat for the point marked 3.
780 3. Repeat for the point marked 3.
784− 4. Move to the last point and type C-x to decrement the 6.
781+ 4. Move to the last point and type Ctrl-x to decrement the 6.
785
782
786 --> 1) First point.
783 --> 1) First point.
787 --> 2) Added point.
784 --> 2) Added point.
@@ -803,8 +800,8 @@ lines.
803
800
804 * Type < and > to indent / outdent lines.
801 * Type < and > to indent / outdent lines.
805
802
806− * Type C-a to increment the selected number.
803+ * Type Ctrl-a to increment the selected number.
807− * Type C-x to decrement the selected number.
804+ * Type Ctrl-x to decrement the selected number.
808
805
809
806
810
807
@@ -903,18 +900,17 @@ lines.
903 Note: * is like a shorthand for "/ y as all it really does is
900 Note: * is like a shorthand for "/ y as all it really does is
904 copy the selection into the / register.
901 copy the selection into the / register.
905
902
906−
907=================================================================
903=================================================================
908= 9.2 ADDING SELECTION ON NEXT SEARCH MATCH =
904= 9.2 ADDING SELECTION ON NEXT SEARCH MATCH =
909=================================================================
905=================================================================
910
906
911− A property of select mode (v) when using n and N is that instead
907+ A property of Select mode (v) when using n and N is that instead
912 of moving the selection to the next match, it adds a new
908 of moving the selection to the next match, it adds a new
913 selection on each match.
909 selection on each match.
914
910
915 1. Move the cursor to the line marked '-->' below.
911 1. Move the cursor to the line marked '-->' below.
916 2. Select the first "bat" and type * to set it to search.
912 2. Select the first "bat" and type * to set it to search.
917− 3. Type v to enter select mode.
913+ 3. Type v to enter Select mode.
918 4. Type n to select the other "bat".
914 4. Type n to select the other "bat".
919 5. Use c or r to change the "bat"s to "cat".
915 5. Use c or r to change the "bat"s to "cat".
920
916
@@ -934,15 +930,15 @@ lines.
934 searching or jumping to the definition of a function in code. It
930 searching or jumping to the definition of a function in code. It
935 stores these in what's called the jumplist.
931 stores these in what's called the jumplist.
936
932
937− Type C-s (ctrl-s) to manually save your current position to
933+ Type Ctrl-s to manually save your current position to
938 the jumplist.
934 the jumplist.
939
935
940− Type C-i ("in") and C-o ("out") to move forward and backwards in
936+ Type Ctrl-i ("in") and Ctrl-o ("out") to move forward and
941− the jumplist respectively.
937+ backwards in the jumplist respectively.
942
938
943− 1. Type C-s somewhere.
939+ 1. Type Ctrl-s somewhere.
944 2. Move far away in the file.
940 2. Move far away in the file.
945− 3. Type C-o (just once!) to come back to where you saved.
941+ 3. Type Ctrl-o (just once!) to come back to where you saved.
946
942
947
943
948
944
@@ -954,12 +950,12 @@ lines.
954
950
955 * Type * to set the search register to the primary selection.
951 * Type * to set the search register to the primary selection.
956
952
957− * Type n / N in visual mode to add selections on each search
953+ * Type n / N in Visual mode to add selections on each search
958 match.
954 match.
959
955
960− * Type C-s to save position to the jumplist.
956+ * Type Ctrl-s to save position to the jumplist.
961− * Type C-i and C-o to go forward and backward in the jumplist.
957+ * Type Ctrl-i and Ctrl-o to go forward and backward in the
962−
958+ jumplist.
963
959
964
960
965
961
@@ -977,20 +973,20 @@ lines.
977 Type ) and ( to cycle the primary selection forward and backward
973 Type ) and ( to cycle the primary selection forward and backward
978 through selections respectively.
974 through selections respectively.
979
975
980− Type A-, to remove the primary selection.
976+ Type Alt-, to remove the primary selection.
981
977
982 1. Move the cursor to the line marked '-->' below.
978 1. Move the cursor to the line marked '-->' below.
983 2. Select both lines with xx or 2x.
979 2. Select both lines with xx or 2x.
984 3. Type s to select, type "would" and enter.
980 3. Type s to select, type "would" and enter.
985 4. Use ( and ) to cycle the primary selection and remove the
981 4. Use ( and ) to cycle the primary selection and remove the
986− very second "would" with A-, .
982+ very second "would" with Alt-, .
987 5. Type c "wood" to change the remaining "would"s to "wood".
983 5. Type c "wood" to change the remaining "would"s to "wood".
988
984
989 --> How much would would a wouldchuck chuck
985 --> How much would would a wouldchuck chuck
990 --> if a wouldchuck could chuck would?
986 --> if a wouldchuck could chuck would?
991
987
992− Note: Additionally, A-( and A-) cycle the *contents* of the
988+ Note: Additionally, Alt-( and Alt-) cycle the *contents* of the
993− selections.
989+ selections as well.
994
990
995=================================================================
991=================================================================
996= 10.2 CHANGING CASE =
992= 10.2 CHANGING CASE =
@@ -1003,10 +999,10 @@ lines.
1003 1. Move the cursor to the first line marked '-->' below.
999 1. Move the cursor to the first line marked '-->' below.
1004 2. Select each wrongly capitalised or lowercase letter
1000 2. Select each wrongly capitalised or lowercase letter
1005 and type ~ over them.
1001 and type ~ over them.
1006− 3. Move to the second line marked -->.
1002+ 3. Move to the second line marked '-->'.
1007 4. Type x to select the line.
1003 4. Type x to select the line.
1008 5. Type ` to change the line to lowercase.
1004 5. Type ` to change the line to lowercase.
1009− 6. Move to the third line marked -->.
1005+ 6. Move to the third line marked '-->'.
1010 7. Type x to select the line.
1006 7. Type x to select the line.
1011 8. Type Alt-` to change the line to uppercase.
1007 8. Type Alt-` to change the line to uppercase.
1012
1008
@@ -1022,13 +1018,13 @@ lines.
1022
1018
1023 1. Move the cursor to the line under ---.
1019 1. Move the cursor to the line under ---.
1024 2. Type xx / 2x to select the lines.
1020 2. Type xx / 2x to select the lines.
1025− 3. Type S then \. |! <enter> (note the spaces after . and !).
1021+ 3. Type S then \. |! Enter (note the spaces after . and !).
1026 This effectively splits the selection into sentences at each
1022 This effectively splits the selection into sentences at each
1027 dot or exclamation mark.
1023 dot or exclamation mark.
1028− 4. Type A-; to reverse the selections.
1024+ 4. Type Alt-; to reverse the selections.
1029 5. Type ; to reduce selections to a single character - the first
1025 5. Type ; to reduce selections to a single character - the first
1030 letter of each sentence.
1026 letter of each sentence.
1031− 6. Type A-` to convert all selected letters to uppercase.
1027+ 6. Type Alt-` to convert all selected letters to uppercase.
1032
1028
1033---
1029---
1034these are sentences. some sentences don't start with uppercase
1030these are sentences. some sentences don't start with uppercase
@@ -1042,10 +1038,10 @@ letters! that is not good grammar. you can fix this.
1042
1038
1043 * Use ) and ( to cycle the primary selection back and forward
1039 * Use ) and ( to cycle the primary selection back and forward
1044 through selections respectively.
1040 through selections respectively.
1045− * Type A-, to remove the primary selection.
1041+ * Type Alt-, to remove the primary selection.
1046
1042
1047 * Type ~ to alternate case of selected letters.
1043 * Type ~ to alternate case of selected letters.
1048− * Use ` and A-` to set the case of selected letters to
1044+ * Use ` and Alt-` to set the case of selected letters to
1049 upper and lower respectively.
1045 upper and lower respectively.
1050
1046
1051 * Type S to split selections on regex.
1047 * Type S to split selections on regex.