| Bram Moolenaar | 71badf9 | 2023-04-22 22:40:14 +0100 | [diff] [blame] | 1 | VIMTUTOR(1) General Commands Manual VIMTUTOR(1) |
| Bram Moolenaar | 071d427 | 2004-06-13 20:20:40 +0000 | [diff] [blame] | 2 | |
| RestorerZ | 6fa304f | 2024-12-02 20:19:52 +0100 | [diff] [blame] | 3 | |
| 4 | |
| Bram Moolenaar | 071d427 | 2004-06-13 20:20:40 +0000 | [diff] [blame] | 5 | NAME |
| 6 | vimtutor - the Vim tutor |
| 7 | |
| 8 | SYNOPSIS |
| Paul Desmond Parker | 17c71da | 2024-11-03 20:47:53 +0100 | [diff] [blame] | 9 | vimtutor [-l | --language ISO639] [-c | --chapter NUMBER] [-g | --gui] |
| 10 | [ISO639] |
| 11 | vimtutor [-h | --help] |
| 12 | vimtutor [--list] |
| Bram Moolenaar | 071d427 | 2004-06-13 20:20:40 +0000 | [diff] [blame] | 13 | |
| 14 | DESCRIPTION |
| Paul Desmond Parker | 17c71da | 2024-11-03 20:47:53 +0100 | [diff] [blame] | 15 | Vimtutor starts the Vim tutor. |
| Bram Moolenaar | 071d427 | 2004-06-13 20:20:40 +0000 | [diff] [blame] | 16 | |
| Bram Moolenaar | 8299df9 | 2004-07-10 09:47:34 +0000 | [diff] [blame] | 17 | The Vimtutor is useful for people that want to learn their first Vim |
| RestorerZ | 6fa304f | 2024-12-02 20:19:52 +0100 | [diff] [blame] | 18 | commands. The optional [ISO639] argument is the two or three letter |
| 19 | name of a language, like "it" or "es". |
| Bram Moolenaar | 071d427 | 2004-06-13 20:20:40 +0000 | [diff] [blame] | 20 | |
| Paul Desmond Parker | 17c71da | 2024-11-03 20:47:53 +0100 | [diff] [blame] | 21 | Vimtutor only opens temporary copies of the original tutor files, there |
| 22 | is no danger of overwriting the lessons. |
| 23 | |
| Bram Moolenaar | 071d427 | 2004-06-13 20:20:40 +0000 | [diff] [blame] | 24 | Vim is always started in Vi compatible mode. |
| 25 | |
| Paul Desmond Parker | 17c71da | 2024-11-03 20:47:53 +0100 | [diff] [blame] | 26 | OPTIONS |
| 27 | -l, --language=ISO639 |
| Christian Brabandt | 5ccac75 | 2024-11-04 21:02:42 +0100 | [diff] [blame] | 28 | Set the two or three letter language code. E.g. 'it', 'es', |
| RestorerZ | 6fa304f | 2024-12-02 20:19:52 +0100 | [diff] [blame] | 29 | 'bar'. Defaults to language of locale if available, else to |
| 30 | English. |
| Paul Desmond Parker | 17c71da | 2024-11-03 20:47:53 +0100 | [diff] [blame] | 31 | |
| 32 | -c, --chapter=NUMBER |
| Christian Brabandt | 5ccac75 | 2024-11-04 21:02:42 +0100 | [diff] [blame] | 33 | Set the chapter number. Defaults to chapter one. |
| Paul Desmond Parker | 17c71da | 2024-11-03 20:47:53 +0100 | [diff] [blame] | 34 | |
| 35 | -g, --gui |
| 36 | Start vimtutor in the GUI version of vim if available, otherwise |
| 37 | fallback to console vim. |
| 38 | |
| 39 | -h, --help |
| 40 | Display usage information. |
| 41 | |
| 42 | --list Display chapters and languages. |
| 43 | |
| 44 | EXAMPLES |
| 45 | To start vimtutor in German on chapter one: |
| 46 | |
| 47 | vimtutor de |
| 48 | |
| 49 | In English on chapter two: |
| 50 | |
| 51 | vimtutor -c2 |
| 52 | |
| 53 | Longform command for Bavarian in the GUI on chapter one: |
| 54 | |
| 55 | vimtutor --language bar --chapter 1 --gui |
| 56 | |
| Bram Moolenaar | 071d427 | 2004-06-13 20:20:40 +0000 | [diff] [blame] | 57 | FILES |
| RestorerZ | 6fa304f | 2024-12-02 20:19:52 +0100 | [diff] [blame] | 58 | /usr/local/share/vim/vim??/tutor/tutor1[.language] |
| Paul Desmond Parker | 17c71da | 2024-11-03 20:47:53 +0100 | [diff] [blame] | 59 | The Vimtutor chapter one text file(s). |
| 60 | |
| Christian Brabandt | 5ccac75 | 2024-11-04 21:02:42 +0100 | [diff] [blame] | 61 | /usr/local/share/vim/vim??/tutor/tutor2[.language] |
| Paul Desmond Parker | 17c71da | 2024-11-03 20:47:53 +0100 | [diff] [blame] | 62 | The Vimtutor chapter two text file(s). |
| Bram Moolenaar | 071d427 | 2004-06-13 20:20:40 +0000 | [diff] [blame] | 63 | |
| RestorerZ | 81b62dd | 2024-08-15 21:39:33 +0200 | [diff] [blame] | 64 | /usr/local/share/vim/vim??/tutor/tutor.vim |
| Christian Brabandt | 5ccac75 | 2024-11-04 21:02:42 +0100 | [diff] [blame] | 65 | The Vim script used to copy the Vimtutor text file. |
| Bram Moolenaar | 071d427 | 2004-06-13 20:20:40 +0000 | [diff] [blame] | 66 | |
| 67 | AUTHOR |
| Paul Desmond Parker | 17c71da | 2024-11-03 20:47:53 +0100 | [diff] [blame] | 68 | The Vi Tutorial was originally written for Vi by Michael C. Pierce and |
| 69 | Robert K. Ware, Colorado School of Mines using ideas supplied by |
| 70 | Charles Smith, Colorado State University. E-mail: bware@mines.col‐ |
| Christian Brabandt | 5ccac75 | 2024-11-04 21:02:42 +0100 | [diff] [blame] | 71 | orado.edu (now invalid). |
| Paul Desmond Parker | 17c71da | 2024-11-03 20:47:53 +0100 | [diff] [blame] | 72 | |
| 73 | Modified for Vim by Bram Moolenaar. |
| 74 | |
| 75 | Translation contributors are listed in the tutor files. |
| Bram Moolenaar | 071d427 | 2004-06-13 20:20:40 +0000 | [diff] [blame] | 76 | |
| 77 | SEE ALSO |
| 78 | vim(1) |
| 79 | |
| RestorerZ | 6fa304f | 2024-12-02 20:19:52 +0100 | [diff] [blame] | 80 | |
| 81 | |
| Christian Brabandt | 5ccac75 | 2024-11-04 21:02:42 +0100 | [diff] [blame] | 82 | 2024 November 04 VIMTUTOR(1) |