xref: /vim-8.2.3635/runtime/vimrc_example.vim (revision aba8857a)
1071d4279SBram Moolenaar" An example for a vimrc file.
2071d4279SBram Moolenaar"
3071d4279SBram Moolenaar" Maintainer:	Bram Moolenaar <[email protected]>
4*aba8857aSBram Moolenaar" Last change:	2008 Jun 16
5071d4279SBram Moolenaar"
6071d4279SBram Moolenaar" To use it, copy it to
7071d4279SBram Moolenaar"     for Unix and OS/2:  ~/.vimrc
8071d4279SBram Moolenaar"	      for Amiga:  s:.vimrc
9071d4279SBram Moolenaar"  for MS-DOS and Win32:  $VIM\_vimrc
10071d4279SBram Moolenaar"	    for OpenVMS:  sys$login:.vimrc
11071d4279SBram Moolenaar
12071d4279SBram Moolenaar" When started as "evim", evim.vim will already have done these settings.
13071d4279SBram Moolenaarif v:progname =~? "evim"
14071d4279SBram Moolenaar  finish
15071d4279SBram Moolenaarendif
16071d4279SBram Moolenaar
17071d4279SBram Moolenaar" Use Vim settings, rather then Vi settings (much better!).
18071d4279SBram Moolenaar" This must be first, because it changes other options as a side effect.
19071d4279SBram Moolenaarset nocompatible
20071d4279SBram Moolenaar
21071d4279SBram Moolenaar" allow backspacing over everything in insert mode
22071d4279SBram Moolenaarset backspace=indent,eol,start
23071d4279SBram Moolenaar
24071d4279SBram Moolenaarif has("vms")
25071d4279SBram Moolenaar  set nobackup		" do not keep a backup file, use versions instead
26071d4279SBram Moolenaarelse
27071d4279SBram Moolenaar  set backup		" keep a backup file
28071d4279SBram Moolenaarendif
29071d4279SBram Moolenaarset history=50		" keep 50 lines of command line history
30071d4279SBram Moolenaarset ruler		" show the cursor position all the time
31071d4279SBram Moolenaarset showcmd		" display incomplete commands
32071d4279SBram Moolenaarset incsearch		" do incremental searching
33071d4279SBram Moolenaar
34071d4279SBram Moolenaar" For Win32 GUI: remove 't' flag from 'guioptions': no tearoff menu entries
35071d4279SBram Moolenaar" let &guioptions = substitute(&guioptions, "t", "", "g")
36071d4279SBram Moolenaar
37071d4279SBram Moolenaar" Don't use Ex mode, use Q for formatting
38071d4279SBram Moolenaarmap Q gq
39071d4279SBram Moolenaar
40*aba8857aSBram Moolenaar" CTRL-U in insert mode deletes a lot.  Use CTRL-G u to first break undo,
41*aba8857aSBram Moolenaar" so that you can undo CTRL-U after inserting a line break.
42*aba8857aSBram Moolenaarinoremap <C-U> <C-G>u<C-U>
43*aba8857aSBram Moolenaar
44c81e5e79SBram Moolenaar" In many terminal emulators the mouse works just fine, thus enable it.
45c81e5e79SBram Moolenaarset mouse=a
46071d4279SBram Moolenaar
47071d4279SBram Moolenaar" Switch syntax highlighting on, when the terminal has colors
48071d4279SBram Moolenaar" Also switch on highlighting the last used search pattern.
49071d4279SBram Moolenaarif &t_Co > 2 || has("gui_running")
50071d4279SBram Moolenaar  syntax on
51071d4279SBram Moolenaar  set hlsearch
52071d4279SBram Moolenaarendif
53071d4279SBram Moolenaar
54071d4279SBram Moolenaar" Only do this part when compiled with support for autocommands.
55071d4279SBram Moolenaarif has("autocmd")
56071d4279SBram Moolenaar
57071d4279SBram Moolenaar  " Enable file type detection.
58071d4279SBram Moolenaar  " Use the default filetype settings, so that mail gets 'tw' set to 72,
59071d4279SBram Moolenaar  " 'cindent' is on in C files, etc.
60071d4279SBram Moolenaar  " Also load indent files, to automatically do language-dependent indenting.
61071d4279SBram Moolenaar  filetype plugin indent on
62071d4279SBram Moolenaar
63071d4279SBram Moolenaar  " Put these in an autocmd group, so that we can delete them easily.
64071d4279SBram Moolenaar  augroup vimrcEx
65071d4279SBram Moolenaar  au!
66071d4279SBram Moolenaar
67071d4279SBram Moolenaar  " For all text files set 'textwidth' to 78 characters.
68071d4279SBram Moolenaar  autocmd FileType text setlocal textwidth=78
69071d4279SBram Moolenaar
70071d4279SBram Moolenaar  " When editing a file, always jump to the last known cursor position.
71071d4279SBram Moolenaar  " Don't do it when the position is invalid or when inside an event handler
72071d4279SBram Moolenaar  " (happens when dropping a file on gvim).
73*aba8857aSBram Moolenaar  " Also don't do it when the mark is in the first line, that is the default
74*aba8857aSBram Moolenaar  " position when opening a file.
75071d4279SBram Moolenaar  autocmd BufReadPost *
76*aba8857aSBram Moolenaar    \ if line("'\"") > 1 && line("'\"") <= line("$") |
77c81e5e79SBram Moolenaar    \   exe "normal! g`\"" |
78071d4279SBram Moolenaar    \ endif
79071d4279SBram Moolenaar
80071d4279SBram Moolenaar  augroup END
81071d4279SBram Moolenaar
82071d4279SBram Moolenaarelse
83071d4279SBram Moolenaar
84071d4279SBram Moolenaar  set autoindent		" always set autoindenting on
85071d4279SBram Moolenaar
86071d4279SBram Moolenaarendif " has("autocmd")
87c81e5e79SBram Moolenaar
88c81e5e79SBram Moolenaar" Convenient command to see the difference between the current buffer and the
89c81e5e79SBram Moolenaar" file it was loaded from, thus the changes you made.
90*aba8857aSBram Moolenaar" Only define it when not defined already.
91*aba8857aSBram Moolenaarif !exists(":DiffOrig")
92c81e5e79SBram Moolenaar  command DiffOrig vert new | set bt=nofile | r # | 0d_ | diffthis
93c81e5e79SBram Moolenaar		  \ | wincmd p | diffthis
94*aba8857aSBram Moolenaarendif
95