VIMTUTOR(1)

🌸 vimtutor(1) β€” the Vim tutor, but make it a bestie 🌸

okay so. you found the General Commands Manual page for vimtutor, and honestly? slay. this is the one that holds your hand through your very first Vim commands. let's get into it πŸ’…


✨ NAME ✨

vimtutor β€” the Vim tutor πŸŽ€


πŸ¦‹ SYNOPSIS πŸ¦‹

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

πŸ’– DESCRIPTION πŸ’–

vimtutor starts the Vim tutor. that's it, that's the whole job, and it does it gorgeously ✨

it's for people who wanna learn their first Vim commands β€” no shame in the game, everybody starts somewhere, and this is genuinely the best place to start fr fr.

the optional [ISO639] argument is the two or three letter name of a language, like "it" or "es". yes bestie, two or three letters, it's flexible like that 🫢

good news: vimtutor only opens temporary copies of the original tutor files. there is no danger of overwriting the lessons. you literally cannot mess this up, go wild 🌈

also, Vim is always started in Vi nocompatible mode. periodt.


πŸ‘‘ OPTIONS πŸ‘‘

  • -l, --language ISO639 β€” sets the two or three letter language code. e.g. 'it', 'es', 'bar'. defaults to the language of your locale if that's available, otherwise it falls back to English πŸ‡¬πŸ‡§
  • -c, --chapter NUMBER β€” sets the chapter number. defaults to chapter one, always a classic ✨
  • -g, --gui β€” starts vimtutor in the GUI version of vim if it's available, otherwise it falls back to console vim. no cap, it'll cope πŸ’…
  • -h, --help β€” displays usage information. the "help me bestie" flag 🫢
  • --list β€” displays the chapters and languages. a whole menu of vibes πŸ“‹

πŸ“ EXAMPLES πŸ“

wanna start vimtutor in German on chapter one? say less:

vimtutor de

in English on chapter two:

vimtutor -c2

and the longform command for Bavarian, in the GUI, on chapter one:

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

see how the longform version is just the short version but with main character energy? iconic 😌


🧚 FILES 🧚

  • /usr/share/vim/vim92/tutor/tutor1[.language] β€” the Vimtutor chapter one text file(s) πŸ“„
  • /usr/share/vim/vim92/tutor/tutor2[.language] β€” the Vimtutor chapter two text file(s) πŸ“„
  • /usr/share/vim/vim92/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) β€” rip to that inbox πŸ’€

modified for Vim by Bram Moolenaar πŸ‘‘

and the translation contributors? they're listed in the tutor files. legends, every single one 🫢


🌈 SEE ALSO 🌈

vim(1)


and that's the whole page bestie, you ate it UP πŸ’–βœ¨πŸŽ€

this was VIMTUTOR(1), from the General Commands Manual, dated 2024 December 03. go forth and :wq your way through life, iykyk πŸ¦‹πŸ’œ

πŸ“¦ where this page comes from