Vi

Related Pages

This page is about the editor vim itself. The other related pages are

• Vimrc, which is dedicated to vim configuration settings and to the file ~/.vimrc.

External Links

General

• My links on vim on del.icio.us.
• Official vim homepage.
• Vim Tips Wiki
• Vim documentation: help
• Vim documentation: map

Other General

• Vi Lovers home page
• Good post explaining why vi is superior and defeating common misconception (with examples).
• Vi would not be vi without a bit of fun...

Cheat sheets

• Very good graphical keyboard cheatsheet
• Another compact & complete cheatsheet (as folded reference card).
• Real Short Vim Normal-Mode List of Commands (from Dr Chip's)

Guides & Cheat sheets

• Avoiding the ESC key
• Vim map tutorial
• Dr Chip's Vim Page — A tremendous amount of Vim treasures from an expert user
• Efficient editing with vim
• C editing with VIM HOWTO
• Using vim as an IDE all in one
• Browsing programs with tags
• Using Bash completion with ctags and Vim

Plugins (installed)

• snipMate : TextMate-style snippets for Vim
• a.vim : Alternate Files quickly (.c --> .h etc)
• trinity.vim : Build the trinity of srcexpl, taglist, NERD_tree to be a good IDE
  • Source Explorer (srcexpl.vim) : A Source code Explorer based on tags works like context window in Source Insight
  • taglist.vim : Source code browser (supports C/C++, java, perl, python, tcl, sql, php, etc)
  • The NERD tree : A tree explorer plugin for navigating the filesystem
• AutoTag : Updates entries in a tags file automatically when saving

Plugins (not yet installed)

• OmniCppComplete : C/C++ omni-completion with ctags database
• c.vim : C/C++ IDE -- Write and run programs. Insert statements, idioms, comments etc.
• CScope with the tutorial here

Plugins (uninstalled)

• easytags.vim : Automated tag file generation and syntax highlighting of tags in Vim
  • Replaced by AutoTag

Invocation

vi -p file1.txt file2.txt                  # Open each file in a different tab
vi -t tagname                              # Open file and move cursor at specified tag (requires ctags)
view file.txt                              # View file in vim, with syntax highlighting... (read-only)
vimdiff file1.txt file2.txt                # View differences in vim

Keyboard Shortcuts

Help

Shortcut	Description	Custom
Ctrl+] <LeftMouse>	Jump to a subject. On azerty keyboard, do Ctrl-AltGr-] (but doesn't with Synergy). The mouse shortcut requires :set mouse=a
Ctrl+O Ctrl-T g<RightMouse> <C-RightMouse>	Back.

Splitting windows

Shortcut	Description	Custom
:{height}split [filename]	Split the screen into two windows, optionally opening another file (with the optional specified height)
:new	Open a new window on a new empty file
:close	Close the current windows
:only	Close all other windows
Ctrl-W w	Switch between windows
Ctrl-W + Ctrl-W -	Increase / decrease window height
{height}Ctrl-W _	Set window height, or maximize it if no height specified
:qa[ll] :wa[ll]	Quit all windows / Write change for all windows

Tabs

Shortcut	Description	Custom
:tab {command}	Execute the command in a new tab
:tabonly	Close all tabs but the current one
:tabn[ext] C-PageDown gt	Go to the next tab page
:tabp[ext] C-PageUp gT	Go to the previous tab page

Miscellaneous

! If keys HJKLM have been remapped to MHJKL, shortcut below must be changed accordingly !

Shortcut	Description	Custom
Ctrl+[	Same effect as Esc, but a bit faster/easier to type. Works on AZERTY keyboard in Windows, but not on Linux.
Ctrl+c	Same effect as Esc, but a bit faster/easier to type. Also works on AZERTY keyboard
Ctrl+Space	Same effect as Esc, but a bit faster/easier to type (see [1]).	Yes
Ctrl+L	Omni and keyword completion.	Yes
*	Search next occurence of word under cursor (Here more like this...)
#	Search previous occurence of word under cursor
gd	Search first occurence of current search
^d<BS>	Concatenate current line at the end of previous lines (assuming <BS> does wrap-around. See option whichwrap)
J	Concatenate current line with next line
/ ↑	Recall previous search string
: ↑	Recall previous command
.	Redo last command
Ctrl + o	to execute more commands (see [2])

Block Indenting

(ref: [3])

Shortcut	Description	Custom
>>	Indent current line
5>>	Indent 5 lines
Vjjjj>>	Indent 5 lines - same as above but using visual mode
>%	(while cursor is on a curly brace) Indent a curly-braces block
]p	paste & indent block based on surrounding text
={	(C-indenting) Auto-indent the current block (:help = for more info)
==	(C-indenting) Auto-indent the current line
gg=G	Intends everything!

Operator & motion

List of available operators:

c       change
d       delete
y       yank into register (does not change the text)
~       swap case (only if 'tildeop' is set)
g~      swap case
gu      make lowercase
gU      make uppercase
!       filter through an external program
=       filter through 'equalprg' or C-indenting if empty
gq      text formatting
g?      ROT13 encoding
>       shift right
<       shift left
zf      define a fold
g@      call function set with the 'operatorfunc' option

List of frequently used operator motion (see :help operator). They are used like diB (delete inner {} block)

iw	inner word	aw	a word	i[	inner [] block	a[	a [] block	i"	inner "" string	a"	a "" string
iW	inner WORD	aW	a WORD	ib i(	inner () block	ab a(	a () block	i'	inner '' string	a'	a '' string
is	inner sentence	as	a sentence	i<	inner <> block	a<	a <> block	i`	inner `` string	a`	a `` string
ip	inner paragraph	ap	a paragraph	it	inner tag block	at	a tag block
				iB i{	inner {} block	aB a{	a {} block

Commands

Shortcut	Description	Custom
:s/search/replace/	Search & replace - current line
:%s/search/replace/	Search & replace - global scope

Miscellaneous Tips and Tricks

• Inserting only a single character (http://vim.wikia.com/wiki/Insert_a_single_character).
• Macro
  • qq to start recording a macro q. End macro with q again.
  • @q to replay macro, followed by . to replay it again.
• Visual Block
  • Ctrl-v to start VISUAL BLOCK mode.
  • Shift-I to insert some text at the start of each line of selected block.
• wrap-around
  • Set option whichwrap or ww that allows specified keys that move the cursor left/right to move to the previous/next line when the cursor is on the first/last character in the line.
  • In Vim, <space> and <backspace> are set to wrap-around by default.
• Read-only viewer (with syntax highlighting):

$ vi -R sensitive_file
$ view sensitive_file

• Retab

To convert tabs in current file to current tab settings, use command :retab [4]. For instance to convert tabs into space

:set expandtab
:retab

• View differences in vim

vimdiff file1.txt file2.txt

• Interaction with X Clipboard

vim can use the X clipboard if it has been compiled with the clipboard feature (run vim --version and see if you have +clipboard in the output). In that case, yanking to the + register, or simply selecting with the mouse, will actually copy in the X clipboard, hence allowing other applications, or even other instances of vim to exchange text snippets. Also, it will ease the copy-paste of indented text, since in that case, vim will first disable autoindentation before pasting the text (see option paste).

On system like Ubuntu, you need to install an instance of gvim (like package vim-gnome or vim-gtk) to have feature +clipboard turned on (i.e. installing package vim is not enough).

When set mouse=a, use shift-mouse to still use the xterm copy/paste (see mouse-using).

• set incsearch, moves cursor as search pattern is typed. Ctrl-L to type letter under cursor, Ctrl-R Ctrl-W to type current word.
• References:

http://vim.wikia.com/wiki/Best_Vim_Tips

• type :help ctrl<C-D>, to get a list of all ctrl sequence. Type <C-D> in command line for auto-completion.
• Support 256 colors in gnome-terminal: add set t_Co=256 in ~/.vimrc ([5])

To Do

• Done Find a way to prevent vim to mess up with my register when deleting text.
• Auto-complete, use cursor keys instead of up/down to search in the drop down list.
• Look at Virtual-edit (see http://vim.wikia.com/wiki/Add_trailing_blanks_to_lines_for_easy_visual_blocks)
• Other links:

http://www.faqs.org/docs/Linux-HOWTO/C-editing-with-VIM-HOWTO.html

http://www.vim.org/scripts/script.php?script_id=213

http://www.ibiblio.org/pub/linux/docs/howto/translations/nl/onehtml/Vim-HOWTO-NL.html