vimtutor - Man Page

the Vim tutor

Examples (TL;DR)

Synopsis

vimtutor [-l | --language ISO639] [-c | --chapter NUMBER] [-g | --gui] [ISO639]
vimtutor [-h | --help]
vimtutor [--list]
gvimtutor

Description

Vimtutor starts the Vim tutor.

The Vimtutor is useful for people that want to learn their first Vim commands. The optional [language] argument is the two-letter name of a language, like "it" or "es".

Vimtutor only opens temporary copies of the original tutor files, there is no danger of overwriting the lessons.

Vim is always started in Vi compatible mode.

Options

-l,  --language=ISO639

Set the two or three letter language code. E.g. 'it', 'es', 'bar'. Defaults to language of locale if available, else to English.

-c,  --chapter=NUMBER

Set the chapter number. Defaults to chapter one.

-g,  --gui

Start vimtutor in the GUI version of vim if available, otherwise fallback to console vim.

-h,  --help

Display usage information.

--list

Display chapters and languages.

Examples

To start vimtutor in German on chapter one:

    vimtutor de

In English on chapter two:

    vimtutor -c2

Longform command for Bavarian in the GUI on chapter one:

    vimtutor --language bar --chapter 1 --gui

Files

/usr/local/share/vim/vim??/tutor/tutor[.language]

The Vimtutor chapter one text file(s).

/usr/local/share/vim/vim??/tutor/tutor2[.language]

The Vimtutor chapter two text file(s).

/usr/local/share/vim/vim??/tutor/tutor.vim

The Vim script used to copy the Vimtutor text file.

Author

The Vi Tutorial was originally written for Vi by Michael C. Pierce and Robert K. Ware, Colorado School of Mines using ideas supplied by Charles Smith, Colorado State University. E-mail: bware@mines.colorado.edu (now invalid).

Modified for Vim by Bram Moolenaar.

Translation contributors are listed in the tutor files.

See Also

vim(1)

Referenced By

vim(1).

The man page gvimtutor(1) is an alias of vimtutor(1).

2024 November 04