VIMTUTOR(1)

📦
version 9.2.1202 · 11 versions
, in alpine 3.23, alpine 3.24, arch rolling, opensuse-leap 16.0, ubuntu stonking

💅 VIMTUTOR — ok so you wanna learn Vim, bestie

So this is vimtutor, section 1 of the General Commands Manual, and honestly? It's the glow-up your terminal life has been waiting for. Periodt.

✨ NAME ✨

vimtutor — the Vim tutor. That's it, that's the whole vibe. It teaches you Vim. Iconic behaviour, no notes.

🎀 SYNOPSIS 🎀

vimtutor [-h | --help]
vimtutor [--list]

Like, three whole ways to call her. Pick your fighter. 🫶

🌸 DESCRIPTION 🌸

Okay so real talk: vimtutor starts the Vim tutor. Boom. That's the job.

It's genuinely for people who are like "what even is a Vim command" — your first-commands era, y'know? And the optional [ISO639] argument is the two or three letter name of a language, like "it" or "es". Cute little language codes. We love a multilingual queen. 🌈

And here's the part that matters (the safety part, because I know you were about to panic): vimtutor only opens temporary copies of the original tutor files. So there is literally no danger of overwriting the lessons. Go feral in there, bestie, you cannot break it. 🔥

Also important, no cap: Vim is always started in Vi nocompatible mode. That's just how she rolls here.

💖 OPTIONS 💖

  • -l, --language ISO639 — sets the two or three letter language code. E.g. 'it', 'es', 'bar'. Defaults to the language of the locale if it's available, else to English. iykyk 🦋
  • -c, --chapter NUMBER — sets the chapter number. Defaults to chapter one, because we all start at the beginning, babes. ✨
  • -g, --gui — starts vimtutor in the GUI version of vim if it's available, otherwise falls back to console vim. She'll try her best, okay? 💅
  • -h, --help — displays usage information. Your little "help me help you" moment. 🙈
  • --list — displays chapters and languages. The full menu, the whole buffet, the entire aesthetic. 👑

🧚 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

Look at that longform flex. She's got range. ⭐

🍓 FILES 🍓

  • /usr/share/vim/vim92/tutor/tutor1[.language] — the Vimtutor chapter one text file(s). Chapter one lives here, periodt.
  • /usr/share/vim/vim92/tutor/tutor2[.language] — the Vimtutor chapter two text file(s). Chapter two, same deal. 🎀
  • /usr/share/vim/vim92/tutor/tutor.vim — the Vim script used to copy the Vimtutor text file. The backstage crew making the magic happen. 🌟

💜 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 — yeah, that address is giving 1996, rest in peace 😭).

Modified for Vim by Bram Moolenaar. Legend. Absolute main character energy. 👑

Translation contributors are listed in the tutor files — go give them their flowers, they earned them. 💐

🦋 SEE ALSO 🦋

  • vim(1) — the big one. The mothership. Go read her next.
A lil reminder before you close this tab: no danger of overwriting the lessons, nocompatible mode always, defaults are locale-language (else English) and chapter one. Write that on your hand, bestie. 🫶

mwah 💋 that's a wrap — page VIMTUTOR(1), dated 2024 December 03, sourced from the General Commands Manual. Go learn Vim, slay, and hydrate. 🌈

📦 where this page comes from