xref: /vim-8.2.3635/runtime/vimrc_example.vim (revision ca63501f)
1" An example for a vimrc file.
2"
3" Maintainer:	Bram Moolenaar <[email protected]>
4" Last change:	2015 Mar 24
5"
6" To use it, copy it to
7"     for Unix and OS/2:  ~/.vimrc
8"	      for Amiga:  s:.vimrc
9"  for MS-DOS and Win32:  $VIM\_vimrc
10"	    for OpenVMS:  sys$login:.vimrc
11
12" When started as "evim", evim.vim will already have done these settings.
13if v:progname =~? "evim"
14  finish
15endif
16
17" Use Vim settings, rather than Vi settings (much better!).
18" This must be first, because it changes other options as a side effect.
19set nocompatible
20
21" allow backspacing over everything in insert mode
22set backspace=indent,eol,start
23
24if has("vms")
25  set nobackup		" do not keep a backup file, use versions instead
26else
27  set backup		" keep a backup file (restore to previous version)
28  set undofile		" keep an undo file (undo changes after closing)
29endif
30set history=50		" keep 50 lines of command line history
31set ruler		" show the cursor position all the time
32set showcmd		" display incomplete commands
33set incsearch		" do incremental searching
34
35" For Win32 GUI: remove 't' flag from 'guioptions': no tearoff menu entries
36" let &guioptions = substitute(&guioptions, "t", "", "g")
37
38" Don't use Ex mode, use Q for formatting
39map Q gq
40
41" CTRL-U in insert mode deletes a lot.  Use CTRL-G u to first break undo,
42" so that you can undo CTRL-U after inserting a line break.
43inoremap <C-U> <C-G>u<C-U>
44
45" In many terminal emulators the mouse works just fine, thus enable it.
46if has('mouse')
47  set mouse=a
48endif
49
50" Switch syntax highlighting on, when the terminal has colors
51" Also switch on highlighting the last used search pattern.
52if &t_Co > 2 || has("gui_running")
53  syntax on
54  set hlsearch
55endif
56
57" Only do this part when compiled with support for autocommands.
58if has("autocmd")
59
60  " Enable file type detection.
61  " Use the default filetype settings, so that mail gets 'tw' set to 72,
62  " 'cindent' is on in C files, etc.
63  " Also load indent files, to automatically do language-dependent indenting.
64  filetype plugin indent on
65
66  " Put these in an autocmd group, so that we can delete them easily.
67  augroup vimrcEx
68  au!
69
70  " For all text files set 'textwidth' to 78 characters.
71  autocmd FileType text setlocal textwidth=78
72
73  " When editing a file, always jump to the last known cursor position.
74  " Don't do it when the position is invalid or when inside an event handler
75  " (happens when dropping a file on gvim).
76  autocmd BufReadPost *
77    \ if line("'\"") >= 1 && line("'\"") <= line("$") |
78    \   exe "normal! g`\"" |
79    \ endif
80
81  augroup END
82
83else
84
85  set autoindent		" always set autoindenting on
86
87endif " has("autocmd")
88
89" Convenient command to see the difference between the current buffer and the
90" file it was loaded from, thus the changes you made.
91" Only define it when not defined already.
92if !exists(":DiffOrig")
93  command DiffOrig vert new | set bt=nofile | r ++edit # | 0d_ | diffthis
94		  \ | wincmd p | diffthis
95endif
96
97if has('langmap') && exists('+langnoremap')
98  " Prevent that the langmap option applies to characters that result from a
99  " mapping.  If unset (default), this may break plugins (but it's backward
100  " compatible).
101  set langnoremap
102endif
103