2024-11-03 20:47:53 +01:00
.TH VIMTUTOR 1 "2024 November 03"
2004-06-13 20:20:40 +00:00
.SH NAME
vimtutor \- the Vim tutor
.SH SYNOPSIS
.br
2024-11-03 20:47:53 +01:00
.B vimtutor [\-l | \- \- language ISO639] [\-c | \- \- chapter NUMBER] [\-g | \- \- gui] [ISO639]
.br
.B vimtutor [\-h | \- \- help]
.br
.B vimtutor [\-\-list]
2004-06-13 20:20:40 +00:00
.SH DESCRIPTION
.B Vimtutor
starts the
.B Vim
tutor.
.PP
The
.B Vimtutor
is useful for people that want to learn their first
.B Vim
commands.
.PP
2010-01-06 20:52:26 +01:00
The optional argument \- g starts vimtutor with gvim rather than vim, if the
2024-08-15 21:39:33 +02:00
GUI version of Vim is available, or falls back to vim if gvim is not found.
2008-05-07 15:40:33 +00:00
.PP
2004-06-13 20:20:40 +00:00
The optional [language] argument is the two-letter name of a language, like
"it" or "es".
If the [language] argument is missing, the language of the current locale will
be used.
If a tutor in this language is available, it will be used.
Otherwise the English version will be used.
.PP
2024-11-03 20:47:53 +01:00
.B Vimtutor
only opens temporary copies of the original tutor files, there is no danger of overwriting the lessons.
.PP
2004-06-13 20:20:40 +00:00
.B Vim
2024-11-03 20:47:53 +01:00
is always started in
.B Vi
compatible mode.
.SH OPTIONS
.TP
.BR \- l ", " \- \- language =\fIISO639\fR
Set the two or three letter language code. E.g. 'it', 'es', 'bar'. Defaults to language of locale if available, else to English.
.TP
.BR \- c ", " \- \- chapter =\fINUMBER\fR
Set the one or two digit chapter number. Defaults to chapter one.
.TP
.BR \- g ", " \- \- gui
Start
.B vimtutor
in the GUI version of vim if available, otherwise fallback to console vim.
.TP
.BR \- h ", " \- \- help
Display usage information.
.TP
.BR \- \- list
Display chapters and languages.
.SH EXAMPLES
To start
.B vimtutor
in German on chapter one:
.PP
.nf
.RS
vimtutor de
.RE
.fi
.PP
In English on chapter two:
.PP
.nf
.RS
vimtutor -c2
.RE
.fi
.PP
Longform command for Bavarian in the GUI on chapter one:
.PP
.nf
.RS
vimtutor --language bar --chapter 1 --gui
.RE
.fi
2004-06-13 20:20:40 +00:00
.SH FILES
.TP 15
2024-08-15 21:39:33 +02:00
/usr/local/share/vim/vim??/tutor/tutor[.language]
2004-06-13 20:20:40 +00:00
The
.B Vimtutor
2024-11-03 20:47:53 +01:00
chapter one text file(s).
.TP 15
/usr/local/share/vim/vim??/tutor/tutor02[.language]
The
.B Vimtutor
chapter two text file(s).
2004-06-13 20:20:40 +00:00
.TP 15
2024-08-15 21:39:33 +02:00
/usr/local/share/vim/vim??/tutor/tutor.vim
2024-11-03 20:47:53 +01:00
The
.B Vim
script used to copy the
2004-06-13 20:20:40 +00:00
.B Vimtutor
2024-11-03 20:47:53 +01:00
chapter one text file.
.TP 15
/usr/local/share/vim/vim??/tutor/tutor02.vim
2004-06-13 20:20:40 +00:00
The
2024-11-03 20:47:53 +01:00
.B Vim
script used to copy the
2004-06-13 20:20:40 +00:00
.B Vimtutor
2024-11-03 20:47:53 +01:00
chapter two text file.
.SH AUTHOR
.B 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.
.B E-mail: bware@mines.colorado.edu.
.PP
Modified for
2004-06-13 20:20:40 +00:00
.B Vim
by Bram Moolenaar.
2024-11-03 20:47:53 +01:00
.PP
Translation contributors are listed in the tutor files.
2004-06-13 20:20:40 +00:00
.SH SEE ALSO
vim(1)