8b029daba58445ead0f08df0f35582a5c1cbc9fc
[oota-llvm.git] / utils / vim / vimrc
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
12 set nocompatible
13
14 " A tab produces a 2-space indentation
15 set softtabstop=2
16 set shiftwidth=2
17 set expandtab
18
19 " Highlight trailing whitespace and lines longer than 80 columns.
20 highlight LongLine ctermbg=DarkYellow guibg=DarkYellow
21 highlight WhitespaceEOL ctermbg=DarkYellow guibg=DarkYellow
22 if 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)
33 else
34   au BufRead,BufNewFile * syntax match LongLine /\%>80v.\+/
35   au InsertEnter * syntax match WhitespaceEOL /\s\+\%#\@<!$/
36   au InsertLeave * syntax match WhitespaceEOL /\s\+$/
37 endif
38
39 " Enable filetype detection
40 filetype on
41
42 " Optional
43 " C/C++ programming helpers
44 augroup csrc
45   au!
46   autocmd FileType *      set nocindent smartindent
47   autocmd FileType c,cpp  set cindent
48 augroup 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.
52 set cinoptions=:0,g0,(0,Ws,l1
53 " Add and delete spaces in increments of `shiftwidth' for tabs
54 set smarttab
55
56 " Highlight syntax in programming languages
57 syntax 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.
61 augroup filetype
62   au! BufRead,BufNewFile *Makefile* set filetype=make
63 augroup END
64
65 " In Makefiles, don't expand tabs to spaces, since we need the actual tabs
66 autocmd 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
71 command! DeleteTrailingWs :%s/\s\+$//
72
73 " Convert all tab characters to two spaces
74 command! Untab :%s/\t/  /g
75
76 " Enable syntax highlighting for LLVM files. To use, copy
77 " utils/vim/llvm.vim to ~/.vim/syntax .
78 augroup filetype
79   au! BufRead,BufNewFile *.ll     set filetype=llvm
80 augroup END
81
82 " Enable syntax highlighting for tablegen files. To use, copy
83 " utils/vim/tablegen.vim to ~/.vim/syntax .
84 augroup filetype
85   au! BufRead,BufNewFile *.td     set filetype=tablegen
86 augroup 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 the a executable.
102 let g:clang_path = "Release/bin/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.
106 let g:clang_opts = [
107   \ "-x","c++",
108   \ "-D__STDC_LIMIT_MACROS=1","-D__STDC_CONSTANT_MACROS=1",
109   \ "-Iinclude" ]
110
111 function! 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 []
214 endfunction ClangComplete
215
216 " Uncomment this to enable the highly-broken autocompletion support.
217 "set omnifunc=ClangComplete