Unnamed repository; edit this file 'description' to name the repository.
Diffstat (limited to 'runtime/tutor')
| -rw-r--r-- | runtime/tutor | 432 |
1 files changed, 205 insertions, 227 deletions
diff --git a/runtime/tutor b/runtime/tutor index 30c0f102..05571837 100644 --- a/runtime/tutor +++ b/runtime/tutor @@ -145,7 +145,7 @@ You can also type wq or write-quit to save and exit. - Note: You can optionally enter a file path after the w / write + Note: You can optionally enter a filepath after the w / write command in order to save to that path. Note: If there are any unsaved changes to a file, a plus [+] will appear next to the file name in the status bar. @@ -316,7 +316,7 @@ Insert mode, so it is a very common shorthand for di. 1. Move the cursor to the line marked '-->' below. - 2. Move to the start of an incorrect word and type e to + 2. Move to the start of an incorrect word and type w to select it. 3. Type c to delete the word and enter Insert mode. 4. Type the correct word. @@ -337,7 +337,7 @@ 1. Move the cursor to the line marked '-->' below. 2. Type 2w to move 2 words forward. 3. Type 3e to move to the end of the third word forward. - 4. Type 2b to move 2 words backwards. + 4. Type 2b to move 2 words backwards 5. Try the above with different numbers. --> This is just a line with words you can move around in. @@ -391,8 +391,8 @@ --> 6) Sugar is sweet, --> 7) And so are you. - Note: X works similarly to x although it doesn't extend to - subsequent lines. X on an empty line does nothing. + Note : X works similarly to x although it doesn't extend to + subsequent lines. X on an empty line does nothing. ================================================================= = 3.8 COLLAPSING SELECTIONS = @@ -411,8 +411,8 @@ --> This is an error-free line with words to move around in. Note: This works the same in Select mode. - Note: Another related command is Alt-; which flips the direction - of the selection (flips the selection's cursor and anchor). + Note: Another related command is Alt-; which flips selections. + @@ -755,7 +755,7 @@ 1. Move the cursor to the line marked '-->' below. 2. Type w to select "watermelons" and then y to yank it. 3. Select "oranges" with w. - 4. Type R to replace "oranges" with "watermelons". + 4. Type R to replace "oranges" with "watermelons" --> I like watermelons because oranges are refreshing. @@ -989,28 +989,6 @@ lines. ================================================================= -= 9.4 JUMP WITH TWO-CHARACTER LABELS = -================================================================= - - Type gw to enable the 2-character labels. The start of each word - will be replaced by 2 highlighted characters. Type any sequence - of 2 highlighted characters to jump to the corresponding label, - or use ESC to drop the labels. - - The 2-character labels allow you to quickly jump to any location - in the viewable selection. - - 1. Move the cursor to the start of the line marked '-->' below. - 2. Press gw to enable the 2-character labels, and then the two - characters that replace the two letters he at the start of - here to jump to the corresponding word. - - --> This is just a simple line of text. - There may be many such lines - But you really want to jump here! - This is fast with the 2-character labels. - -================================================================= = CHAPTER 9 RECAP = ================================================================= @@ -1023,8 +1001,8 @@ lines. * Press Ctrl-i and Ctrl-o to go forward and backward in the jumplist. - * Type gw to enable 2-character labels, and any 2 characters to - jump to the corresponding label, or ESC to drop the labels. + + @@ -1044,8 +1022,8 @@ lines. 1. Move the cursor to the line marked '-->' below. 2. Select both lines with xx or 2x. 3. Type s to select, type "would" and enter. - 4. Use ( and ) to cycle the primary selection and deselect - the second "would" with Alt-, . + 4. Use ( and ) to cycle the primary selection and remove the + very second "would" with Alt-, . 5. Type c "wood" to change the remaining "would"s to "wood". --> How much would would a wouldchuck chuck @@ -1146,14 +1124,14 @@ letters! that is not good grammar. you can fix this. = 11.1 COMMENTING A LINE = ================================================================= - Press Ctrl-c to comment the line under your cursor. - To uncomment the line, press Ctrl-c again. +Press Ctrl-c to comment the line under your cursor. +To uncomment the line, press Ctrl-c again. - 1. Move your cursor to the line marked '-->' below. - 2. Now comment the line marked with '-->'. - 3. Now try uncommenting the line. +1. Move your cursor to the line marked '-->' below. +2. Now comment the line marked with '-->'. +3. Now try uncommenting the line. - --> Comment me please +--> Comment me please @@ -1168,23 +1146,23 @@ letters! that is not good grammar. you can fix this. = 11.2 COMMENTING MULTIPLE LINES = ================================================================= - Using the selections and multi-cursor functionality, you can - comment multiple lines as long as they are under the selection or - cursors. +Using the selections and multi-cursor functionality, you can +comment multiple lines as long as it is under the selection or +cursors. - 1. Move your cursor to the line marked with '-->' below. - 2. Now try to select or add more cursors to the other lines marked - with '-->'. - 3. Comment those lines. +1. Move your cursor to the line marked with '-->' below. +2. Now try to select or add more cursors the other lines marked + with '-->'. +3. Comment those lines. - --> How many are you going to comment? - --> Is this enough for a comment? - --> What are you doing?! - --> Stop commenting me! - --> AAAAaargh!!! +--> How many are you going to comment? +--> Is this enough for a comment? +--> What are you doing?! +--> Stop commenting me! +--> AAAAaargh!!! - Note: If there are already commented lines under selections or - multiple cursors, they won't be uncommented but commented again. +Note: If there are already commented lines under selections or +multiple cursors, they won't be uncommented but commented again. ================================================================= = CHAPTER 11 RECAP = @@ -1212,20 +1190,20 @@ letters! that is not good grammar. you can fix this. = 12.1 USING MATCH MODE JUMP = ================================================================= - To switch to match mode from normal mode, type m. This feature - is particularly useful for handling bracket pairs and their - contents. +To switch to match mode from normal mode, type m. This feature +is particularly useful for handling bracket pairs and their +contents. - There are several actions that can be performed in match mode, - as indicated by the help pop-up. To jump to a matching bracket pair, - simply press mm. For example on the lines below (starting with - -->), move the cursor in normal mode to (, and then press mm to jump - to the matching ). You can do the same on the line below: for example - move to ], and press mm to jump to [ . +There are several actions that can be performed in match mode, +as indicated by the help pop-up. To jump to a matching bracket pair, +simply press mm. For example on the lines below (starting with +-->), move the cursor in normal mode to (, and then press mm to jump +to the matching ). You can do the same on the line below: for example +move to ], and press mm to jump to [ . - --> you can (jump between matching parentheses) - --> or between matching [ square brackets ] - --> now { you know the drill: this works with brackets too } +--> you can (jump between matching parenthesis) +--> or between matching [ square brackets ] +--> now { you know the drill: this works with brackets too } @@ -1234,41 +1212,41 @@ letters! that is not good grammar. you can fix this. = 12.2 USING MATCH MODE SELECT INSIDE = ================================================================= - Match mode also lets you select the "inside" content between a - pair of brackets or other delimiters. In the lines below: +Match mode also lets you select the "inside" content between a +pair of brackets or other delimiters. In the lines below: - - move to the --> line, put your cursor in normal mode at any - location between the parentheses, for example at 'x', and press - mi( or mi) to select the whole content inside the parentheses - (parentheses excluded). As usual, you can then do anything you want - with the selection (for example, press c to change it) +- move to the --> line, put your cursor in normal mode at any +location between the parenthesis, for example at 'x', and press +mi( or mi) to select the whole content inside the parenthesis +(parenthesis excluded). As usual, you can then do anything you want +with the selection (for example, press c to change it) - --> outside and (inside x parentheses) - and outside again +--> outside and (inside x parenthesis) - and outside again - Test below that you can do the same with [], or {}, or with - nested combinations of these (this will act on the immediately - surrounding matching pair). This also works with "" and similar +Test below that you can do the same with [], or {}, or with +nested combinations of these (this will act on the immediately +surrounding matching pair). This also works with "" and similar - --> test [ with square brackets ] ! - --> try ( with nested [ pairs of ( parentheses) and "brackets" ]) +--> test [ with square brackets ] ! +--> try ( with nested [ pairs of ( parenthesis) and "brackets" ]) ================================================================= = 12.3 USING MATCH MODE SELECT AROUND = ================================================================= - You can also select the "around" content, i.e. both the inside - content and the delimiters themselves, by using the ma select. - For example, move to the line under, move your cursor in normal - mode to any position between the (), and select the content of - the (), including the surrounding (), by typing ma( or ma). As - usual, you can do anything you want with the selection, for - example delete it all with ma(d . +You can also select the "around" content, i.e. both the inside +content and the delimiters themselves, by using the ma select. +For example, move to the line under, move your cursor in normal +mode to any position between the (), and select the content of +the (), including the surrounding (), by typing ma( or ma). As +usual, you can do anything you want with the selection, for +example delete it all with ma(d . - --> you ( select x around ) to include delimiters in the select +--> you ( select x around ) to include delimiters in the select - This naturally works with other delimiters too: +This naturally works with other delimiters too: - --> try [ with 'square' brackets ] too! +--> try [ with 'square' brackets ] too! @@ -1278,21 +1256,21 @@ letters! that is not good grammar. you can fix this. = 12.4 USING MATCH MODE SURROUND = ================================================================= - The match mode can also be used to add surrounding around the - current selection. For example, move to the line below, then: - * i) select the "select all of this" line segment (for example, - move in normal mode the cursor to the start of select, then enter - selection mode with v , then select the 4 next words with 4e ), - * ii) press ms( or ms) to surround the selection with a pair of - parentheses. +The match mode can also be used to add surrounding around the +current selection. For example, move to the line below, then: + * i) select the "select all of this" line segment (for example, +move in normal mode the cursor to the start of select, then enter +selection mode with v , then select the 4 next words with 4e ), + * ii) press ms( or ms) to surround the selection with a pair of +parenthesis. - --> so, select all of this, and surround it with () +--> so, select all of this, and surround it with () - You can do the same with other delimiters: for example, ms' on - WORD below to surround it with a pair of ''. You can try also - with adding a surrounding pair of "", or {}, or []. +You can do the same with other delimiters: for example, ms' on +WORD below to surround it with a pair of ''. You can try also +with adding a surrounding pair of "", or {}, or []. - --> surround this WORD ! +--> surround this WORD ! @@ -1300,64 +1278,64 @@ letters! that is not good grammar. you can fix this. = 12.5 USING MATCH MODE DELETE SURROUND = ================================================================= - You can delete surrounding pair of delimiters with the md - command. On the line below, move the cursor anywhere - within the pair of (), for example to the 'x', then from there, - in normal mode, press md( or md) to delete the surrounding - pair of parentheses. +You can delete surrounding pair of delimiters with the md +command. On the line below, move the cursor anywhere +within the pair of (), for example to the 'x', then from there, +in normal mode, press md( or md) to delete the surrounding +pair of parenthesis. - --> delete (the x pair of parentheses) from within! +--> delete (the x pair of parenthesis) from within! - You can naturally delete other kinds of surroundings: +You can naturally delete other kinds of surroundings: - --> delete (nested [delimiters]): "this" will delete the nearest - matching surrounding pair. - --> delete "layers "of" quote marks" too: this will delete the - nearest previous and following quote marks +--> delete (nested [delimiters]): "this" will delete the nearest +matching surrounding pair. +--> delete "layers "of" quote marks" too: this will delete the +nearest previous and following quote marks - Trying to delete nonexistent surrounding delimiters prints an error - at the bottom bar and does nothing. +Trying to delete unexisting surrounding delimiters print an error +at the bottom bar and does nothing. ================================================================= = 12.6 USING MATCH MODE REPLACE SURROUND = ================================================================= - You can replace surrounding pairs of delimiters with the mr - command. On the line below, move the cursor to - anywhere within the pair of (), for example on the 'x', then in - normal mode, press mr([ to replace the pair of () with a pair - of []. +You can replace surrounding pairs of delimiters with the mr +command. On the line below, move the cursor to +anywhere within the pair of (), for example on the 'x', then in +normal mode, press mr([ to replace the pair of () with a pair +of []. - --> replace the (pair from x within), with something else +--> replace the (pair from x within), with something else - This command will act on the closest enclosing pair, so you - can try replacing different surrounding in the following: +This command will act on the closest enclosing pair, so you +can try replacing different surrounding in the following: - --> some (nested surroundings [can be replaced]) - --> this "works with 'other surroundings' too" +--> some (nested surroundings [can be replaced]) +--> this "works with 'other surroundings' too" - You can try to replace a nonexistent pair: this will show - an error warning at the bottom bar and do nothing. +You can try to replace a non existing pair: this will show +an error warning at the bottom bar and do nothing. ================================================================= = CHAPTER 12 RECAP = ================================================================= - You can enter the match mode with the m key; this will show the - actions available in a popup. This will allow you to: - * jump to matching pair of delimiters with mm (you must have a - delimiter belonging to a pair under your cursor) - * select inside a pair of delimiters surrounding your cursor - (i.e. select the content but not the delimiters) with mi( - and similar - * select around a pair of delimiters surrounding your cursor - (i.e. select the content and the delimiters) with ma( and - similar - * delete surrounding delimiters with md( and similar - * add surrounding delimiters around the selection with ms( - * replace a pair of delimiters surrounding your selection with - mr([ to replace for example surrounding () with [] +You can enter the match mode with the m key; this will show the +actions available in a popup. This will allow you to: + * jump to matching pair of delimiters with mm (you must have a + delimiter belonging to a pair under your cursor) + * select inside a pair of delimiters surrounding your cursor + (i.e. select the content but not the delimiters) with mi( + and similar + * select around a pair of delimiters surrounding your cursor + (i.e. select the content and the delimiters) with ma( and + similar + * delete surrounding delimiters with md( and similar + * add surrounding delimiters around the selection with ms( + * replace a pair of delimiters surrounding your selection with + mr([ to replace for example surrounding () with [] @@ -1366,20 +1344,20 @@ letters! that is not good grammar. you can fix this. = CHAPTER 13.1 CREATE NEW SPLIT = ================================================================= - In Normal mode, press Ctrl-w to open the Window menu, which displays - a list of available commands. +In Normal mode, press Ctrl-w to open the Window menu, which displays +a list of available commands. - To open a new empty buffer in a vertical split on the right half - of your current window, use Ctrl-w nv (i.e., press Ctrl - and w simultaneously, then press n, followed by v). Your current - window will now split in 2 vertically. A new empty buffer split - will appear on the right half and your cursor will jump to the - new vertical split. +To open a new empty buffer in a vertical split on the right half +of your current window, use Ctrl-w nv (i.e., press Ctrl +and w simultaneously, then press n, followed by v). Your current +window will now split in 2 vertically. A new empty buffer split +will appear on the right half and your cursor will jump to the +new vertical split. - To create a new empty buffer in a horizontal split, press - Ctrl-w ns. This action divides your current window into two - horizontally, creates a new buffer, and moves your cursor to the - new horizontal split. +To create a new empty buffer in a horizontal split, press +Ctrl-w ns. This action divides your current window into two +horizontally, creates a new buffer, and moves your cursor to the +new horizontal split. @@ -1388,33 +1366,33 @@ letters! that is not good grammar. you can fix this. = CHAPTER 13.2 MOVE BETWEEN SPLITS = ================================================================= - Use Ctrl-w k to move to the split above your current split. Use - Ctrl-w j to move to the split below. Use Ctrl-w h to move to - the split on the left and Ctrl-w l to move to the split on the - right. To navigate to the next split (in the order they were - opened), press Ctrl-w w. +Use Ctrl-w k to move to the split above your current split. Use +Ctrl-w j to move to the split below. Use Ctrl-w h to move to +the split on the left and Ctrl-w l to move to the split on the +right. To navigate to the next split (in the order they were +opened), press Ctrl-w w. - You can now do whatever you want in your new buffers and splits. - Once you are done with using your new buffer split, - you can close it with Ctrl-w q . Move to the bottom right split - with Ctrl-w l then Ctrl-w j, then press Ctrl-w q to close this - specific split. +You can now do whatever you want in your new buffers and splits. +Once you are done with using your new buffer split, +you can close it with Ctrl-w q . Move to the bottom right split +with Ctrl-w l then Ctrl-w j, then press Ctrl-w q to close this +specific split. - You can also close all splits except the current one with Ctrl-w o . - Open a third vertical split with Ctrl-w nv , then move to the - leftmost split with Ctrl-w h twice, then from inside the split on - the left press Ctrl-w o to close all except this split. +You can also close all splits except the current one with Ctrl-w o . +Open a third vertical split with Ctrl-w nv , then move to the +leftmost split with Ctrl-w h twice, then from inside the split on +the left press Ctrl-w o to close all except this split. ================================================================= = CHAPTER 13.3 SPLIT CURRENT BUFFER = ================================================================= - Use Ctrl-w s to split the view of the current buffer horizontally - and Ctrl-w v to split it vertically with the buffer opened in both - splits. +Use Ctrl-w s to split the view of the current buffer horizontally +and Ctrl-w v to split it vertically with the buffer opened in both +splits. - Close extra splits with Ctrl-w o to return to a single window view. +Close extra splits with Ctrl-w o to return to a single window view. @@ -1432,41 +1410,41 @@ letters! that is not good grammar. you can fix this. = CHAPTER 13.4 USE COMMANDS TO SPLIT = ================================================================= - The :vsplit (or :vs for short) and :hsplit (or :hs) commands can - also be used to split a specific buffer vertically or horizontally. - For example, enter the command: +The :vsplit (or :vs for short) and :hsplit (or :hs) commands can +also be used to split a specific buffer vertically or horizontally. +For example, enter the command: - :vs something +:vs something - to open a new vertical split named "something" to the right. Here, - "something" is not an existing file, so a new buffer with this name - will open; however, you can replace "something" with any file name - to open it in a new buffer. Similarly, you can enter the command: +to open a new vertical split named "something" to the right. Here, +"something" is not an existing file, so a new buffer with this name +will open; however, you can replace "something" with any file name +to open it in a new buffer. Similarly, you can enter the command: - :hs some_more +:hs some_more - to open a new buffer named "some_more" in the lower half. - "some_more" could be any file or path to open this specific file - or path instead of a new empty buffer. +to open a new buffer named "some_more" in the lower half. +"some_more" could be any file or path to open this specific file +or path instead of a new empty buffer. ================================================================= = CHAPTER 13.5 SWAPPING SPLITS = ================================================================= - Open a split on the left with :vs hello1 and then a split below - with :hs hello2. +Open a split on the left with :vs hello1 and then a split below +with :hs hello2. - From hello2, press Ctrl-w K to swap it with the split above. Now - hello2 is at the top while hello1 is at the bottom. +From hello2, press Ctrl-w K to swap it with the split above. Now +hello2 is at the top while hello1 is at the bottom. - Still from hello2, press Ctrl-w H to swap with the split on the - left: now hello2 is on the left and the tutor is on the top - right. After Ctrl-w you can use HJKL to swap with the buffer - on the left / below / above / on the right. +Still from hello2, press Ctrl-w H to swap with the split on the +left: now hello2 is on the left and the tutor is on the top +right. After Ctrl-w you can use HJKL to split with the buffer +on the left / below / above / on the right. - Move back to the tutor split, and press Ctrl-w o to only keep - this split. +Move back to the tutor split, and press Ctrl-w o to only keep +this split. @@ -1476,21 +1454,21 @@ letters! that is not good grammar. you can fix this. = CHAPTER 13.6 TRANSPOSE SPLITS = ================================================================= - Open a split on the left with :vs hello1 and then a split below - with :hs hello2. +Open a split on the left with :vs hello1 and then a split below +with :vs hello2. - Move to the tutor split, then press Ctrl-w t to transpose the - vertical split opened from this window: now, hello1 and - hello2 are below, rather than to the right of, the tutor. Press - Ctrl-w t again to transpose back. +Move to the tutor split, then press Ctrl-w t to transpose the +vertical split opened from this window: now, hello1 and +hello2 are below, rather than to the right of, the tutor. Press +Ctrl-w t again to transpose back. - Move to the hello1 split, then press Ctrl-w t to transpose the - horizontal split that was opened from this window: now hello2 - is on the right, rather than below, hello1. Press Ctrl-w t to - transpose back. +Move to the hello1 split, then press Ctrl-w t to transpose the +horizontal split that was opened from this window: now hello2 +is on the right, rather than below, hello1. Press Ctrl-w t to +transpose back. - Move back to the tutor split and press Ctrl-w o to close all but - the tutor window. +Move back to the tutor split and press Ctrl-w o to close all but +the tutor window. @@ -1498,21 +1476,21 @@ letters! that is not good grammar. you can fix this. = CHAPTER 13.7 OPEN SPLIT FROM FILEPICKER = ================================================================= - Splits can also be opened directly from the file picker. Press - space f to open the file picker. From there, you can type in text - to perform file lookup with fuzzy matching, and use the arrows - up and down to move the selected file (indicated by the > symbol). - If you want to exit the file picker, press Escape. +Splits can also be opened directly from the file picker. Press +space f to open the file picker. From there, you can type in text +to perform file lookup with fuzzy matching, and use the arrows +up and down to move the selected file (indicated by the > symbol). +If you want to exit the file picker, press Escape. - Select any file you like in the file picker. You could open it in - the current view by pressing enter (do not do this at present). - But you can also open it in a new split. Press Ctrl-v to open - the selected file in a new vertical split. Press space f again, - select any file you want, and press Ctrl-s to open it in a - horizontal split. +Select any file you like in the file picker. You could open it in +the current view by pressing enter (do not do this at present). +But you can also open it in a new split. Press Ctrl-v to open +the selected file in a new vertical split. Press space f again, +select any file you want, and press Ctrl-s to open it in a +horizontal split. - Move back to the tutor split, and press Ctrl-w o to close all - splits except this one. +Move back to the tutor split, and press Ctrl-w o to close all +splits except this one. @@ -1520,18 +1498,18 @@ letters! that is not good grammar. you can fix this. = CHAPTER 13 RECAP = ================================================================= - Splits can be used to display either the same buffer several times - or several buffers. To access the main windows and splits commands, - press Ctrl-w . You can move between splits with Ctrl-w hjkl , - you can close a split with Ctrl-w q , and you can close all but - the present split with Ctrl-w o . +Splits can be used to display either the same buffer several times +or several buffers. To access the main windows and splits commands, +press Ctrl-w . You can move between splits with Ctrl-w hjkl , +you can close a split with Ctrl-w q , and you can close all but +the present split with Ctrl-w o . - Splits can also be opened by using the :vs FILENAME and - :hs FILENAME commands. +Splits can also be opened by using the :vs FILENAME and +:hs FILENAME commands. - Splits can also be used directly from the file pickers, by using - Ctrl-v to open the file selected in a new vertical split, and - Ctrl-s in a horizontal split. +Splits can also be used directly from the file pickers, by using +Ctrl-v to open the file selected in a new vertical split, and +Ctrl-s in a horizontal split. |