xref: /llvm-project-15.0.7/llvm/utils/vim/vimrc (revision 7e64c985) 
1" LLVM coding guidelines conformance for VIM
2" $Revision$
3"
4" Maintainer: The LLVM Team, http://llvm.org
5" WARNING:    Read before you source in all these commands and macros!  Some
6"             of them may change VIM behavior that you depend on.
7"
8" You can run VIM with these settings without changing your current setup with:
9" $ vim -u /path/to/llvm/utils/vim/vimrc
10
11" It's VIM, not VI
12set nocompatible
13
14" A tab produces a 2-space indentation
15set softtabstop=2
16set shiftwidth=2
17set expandtab
18
19" Highlight trailing whitespace and lines longer than 80 columns.
20highlight LongLine ctermbg=DarkYellow guibg=DarkYellow
21highlight WhitespaceEOL ctermbg=DarkYellow guibg=DarkYellow
22if v:version >= 702
23  " Lines longer than 80 columns.
24  au BufWinEnter * let w:m0=matchadd('LongLine', '\%>80v.\+', -1)
25
26  " Whitespace at the end of a line. This little dance suppresses
27  " whitespace that has just been typed.
28  au BufWinEnter * let w:m1=matchadd('WhitespaceEOL', '\s\+$', -1)
29  au InsertEnter * call matchdelete(w:m1)
30  au InsertEnter * let w:m2=matchadd('WhitespaceEOL', '\s\+\%#\@<!$', -1)
31  au InsertLeave * call matchdelete(w:m2)
32  au InsertLeave * let w:m1=matchadd('WhitespaceEOL', '\s\+$', -1)
33else
34  au BufRead,BufNewFile * syntax match LongLine /\%>80v.\+/
35  au InsertEnter * syntax match WhitespaceEOL /\s\+\%#\@<!$/
36  au InsertLeave * syntax match WhitespaceEOL /\s\+$/
37endif
38
39" Enable filetype detection
40filetype on
41
42" Optional
43" C/C++ programming helpers
44augroup csrc
45  au!
46  autocmd FileType *      set nocindent smartindent
47  autocmd FileType c,cpp  set cindent
48augroup END
49" Set a few indentation parameters. See the VIM help for cinoptions-values for
50" details.  These aren't absolute rules; they're just an approximation of
51" common style in LLVM source.
52set cinoptions=:0,g0,(0,Ws,l1
53" Add and delete spaces in increments of `shiftwidth' for tabs
54set smarttab
55
56" Highlight syntax in programming languages
57syntax on
58
59" LLVM Makefiles can have names such as Makefile.rules or TEST.nightly.Makefile,
60" so it's important to categorize them as such.
61augroup filetype
62  au! BufRead,BufNewFile *Makefile* set filetype=make
63augroup END
64
65" In Makefiles, don't expand tabs to spaces, since we need the actual tabs
66autocmd FileType make set noexpandtab
67
68" Useful macros for cleaning up code to conform to LLVM coding guidelines
69
70" Delete trailing whitespace and tabs at the end of each line
71command! DeleteTrailingWs :%s/\s\+$//
72
73" Convert all tab characters to two spaces
74command! Untab :%s/\t/  /g
75
76" Enable syntax highlighting for LLVM files. To use, copy
77" utils/vim/llvm.vim to ~/.vim/syntax .
78augroup filetype
79  au! BufRead,BufNewFile *.ll     set filetype=llvm
80augroup END
81
82" Enable syntax highlighting for tablegen files. To use, copy
83" utils/vim/tablegen.vim to ~/.vim/syntax .
84augroup filetype
85  au! BufRead,BufNewFile *.td     set filetype=tablegen
86augroup END
87
88" Additional vim features to optionally uncomment.
89"set showcmd
90"set showmatch
91"set showmode
92"set incsearch
93"set ruler
94
95" Clang code-completion support. This is highly experimental!
96
97" TODO: code-completing on
98"          cast_cast<
99" turns up some peculiarities -- "asm("?
100
101" A path to a clang executable.
102let g:clang_path = "clang++"
103
104" A list of options to add to the clang commandline, for example to add
105" include paths, predefined macros, and language options.
106let g:clang_opts = [
107  \ "-x","c++",
108  \ "-D__STDC_LIMIT_MACROS=1","-D__STDC_CONSTANT_MACROS=1",
109  \ "-Iinclude" ]
110
111function! ClangComplete(findstart, base)
112   if a:findstart == 1
113      " In findstart mode, look for the beginning of the current identifier.
114      let l:line = getline('.')
115      let l:start = col('.') - 1
116      while l:start > 0 && l:line[l:start - 1] =~ '\i'
117         let l:start -= 1
118      endwhile
119      return l:start
120   endif
121
122   " Get the current line and column numbers.
123   let l:l = line('.')
124   let l:c = col('.')
125
126   " Build a clang commandline to do code completion on stdin.
127   let l:the_command = shellescape(g:clang_path) .
128                     \ " -cc1 -code-completion-at=-:" . l:l . ":" . l:c
129   for l:opt in g:clang_opts
130      let l:the_command .= " " . shellescape(l:opt)
131   endfor
132
133   " Copy the contents of the current buffer into a string for stdin.
134   " TODO: The extra space at the end is for working around clang's
135   " apparent inability to do code completion at the very end of the
136   " input.
137   " TODO: Is it better to feed clang the entire file instead of truncating
138   " it at the current line?
139   let l:process_input = join(getline(1, l:l), "\n") . " "
140
141   " Run it!
142   let l:input_lines = split(system(l:the_command, l:process_input), "\n")
143
144   " Parse the output.
145   for l:input_line in l:input_lines
146      " Vim's substring operator is annoyingly inconsistent with python's.
147      if l:input_line[:11] == 'COMPLETION: '
148         let l:value = l:input_line[12:]
149
150        " Chop off anything after " : ", if present, and move it to the menu.
151        let l:menu = ""
152        let l:spacecolonspace = stridx(l:value, " : ")
153        if l:spacecolonspace != -1
154           let l:menu = l:value[l:spacecolonspace+3:]
155           let l:value = l:value[:l:spacecolonspace-1]
156        endif
157
158        " Handle Pattern. TODO: Make clang less weird.
159        if l:value == "Pattern"
160           let l:value = l:menu
161           let l:pound = stridx(l:value, "#")
162           " Truncate the at the first [#, <#, or {#.
163           if l:pound != -1
164              let l:value = l:value[:l:pound-2]
165           endif
166        endif
167
168         " Filter out results which don't match the base string.
169         if a:base != ""
170            if l:value[:strlen(a:base)-1] != a:base
171               continue
172            end
173         endif
174
175        " TODO: Don't dump the raw input into info, though it's nice for now.
176        " TODO: The kind string?
177        let l:item = {
178          \ "word": l:value,
179          \ "menu": l:menu,
180          \ "info": l:input_line,
181          \ "dup": 1 }
182
183        " Report a result.
184        if complete_add(l:item) == 0
185           return []
186        endif
187        if complete_check()
188           return []
189        endif
190
191      elseif l:input_line[:9] == "OVERLOAD: "
192         " An overload candidate. Use a crazy hack to get vim to
193         " display the results. TODO: Make this better.
194         let l:value = l:input_line[10:]
195         let l:item = {
196           \ "word": " ",
197           \ "menu": l:value,
198           \ "info": l:input_line,
199           \ "dup": 1}
200
201        " Report a result.
202        if complete_add(l:item) == 0
203           return []
204        endif
205        if complete_check()
206           return []
207        endif
208
209      endif
210   endfor
211
212
213   return []
214endfunction ClangComplete
215
216" Uncomment this to enable the highly-broken autocompletion support.
217"set omnifunc=ClangComplete
218