xref: /vim-8.2.3635/runtime/vimrc_example.vim (revision a06ecab7)
1" An example for a vimrc file.
2"
3" Maintainer:	Bram Moolenaar <[email protected]>
4" Last change:	2016 Jun 21
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 or when using the
51" GUI (which always has colors).
52if &t_Co > 2 || has("gui_running")
53  syntax on
54
55  " Also switch on highlighting the last used search pattern.
56  set hlsearch
57
58  " I like highlighting strings inside C comments.
59  let c_comment_strings=1
60endif
61
62" Only do this part when compiled with support for autocommands.
63if has("autocmd")
64
65  " Enable file type detection.
66  " Use the default filetype settings, so that mail gets 'tw' set to 72,
67  " 'cindent' is on in C files, etc.
68  " Also load indent files, to automatically do language-dependent indenting.
69  filetype plugin indent on
70
71  " Put these in an autocmd group, so that we can delete them easily.
72  augroup vimrcEx
73  au!
74
75  " For all text files set 'textwidth' to 78 characters.
76  autocmd FileType text setlocal textwidth=78
77
78  " When editing a file, always jump to the last known cursor position.
79  " Don't do it when the position is invalid or when inside an event handler
80  " (happens when dropping a file on gvim).
81  autocmd BufReadPost *
82    \ if line("'\"") >= 1 && line("'\"") <= line("$") |
83    \   exe "normal! g`\"" |
84    \ endif
85
86  augroup END
87
88else
89
90  set autoindent		" always set autoindenting on
91
92endif " has("autocmd")
93
94" Convenient command to see the difference between the current buffer and the
95" file it was loaded from, thus the changes you made.
96" Only define it when not defined already.
97if !exists(":DiffOrig")
98  command DiffOrig vert new | set bt=nofile | r ++edit # | 0d_ | diffthis
99		  \ | wincmd p | diffthis
100endif
101
102if has('langmap') && exists('+langnoremap')
103  " Prevent that the langmap option applies to characters that result from a
104  " mapping.  If unset (default), this may break plugins (but it's backward
105  " compatible).
106  set langnoremap
107endif
108
109
110" Add optional packages.
111"
112" The matchit plugin makes the % command work better, but it is not backwards
113" compatible.
114if has('syntax') && has('eval')
115  packadd matchit
116endif
117