Matt's Keith's vim Setup

I've decided to make my .vim directory public, so I figured I should at least make an attempt at documenting my setup. Before I start, the standard disclaimer is that this is my personal vim setup. If you don't like something and decide to change it, please don't submit a PR back to this repository unless its a bug fix and not going to radically change things. Create a fork, and put your crap there, I don't want it.

Installation

cd ~/
git clone --recursive <dot-vim> .vim
cd ~/.vim
ln -s ~/.vim/.vimrc ~/.vimrc

For neovim:

Do the above
ln -s ~/.vim ~/.config/nvim
pip install --upgrade neovim

For Mac users using neovim

If you're using homebrew and have installed python through homebrew, you may have some python errors appear on opening neovim.

To fix this:

brew uninstall --force python
sudo easy_install pip
pip install --user neovim

If you are still having issues and installed neovim via homebrew, pip may have installed a version greater than your currently installed neovim version. You'll need to uninstall the neovim python lib and install the correct one for your installed version

To fix this:

pip uninstall neovim
brew info neovim | awk 'NR==1{print "pip install --user -I neovim=="substr($3, 1, length($3)-1)}' | sh

You'll also need to install and configure the various linters for Syntastic, see .vimrc for the short list with the right commands to install each (on Debian based Linuxes at least).

Overview

I use this setup to program/get stuff done in gterm (and sometimes urxvt when gterm annoys me too much) in combination with a custom compiled Vim 7.4. My Vim is compiled with the following config, some of which you may need in order for my .vim to work correctly as is:

mtpelland@padron:~/.vim$ vim --version
VIM - Vi IMproved 7.4 (2013 Aug 10, compiled Nov  2 2015 15:09:30)
Included patches: 1-908
Compiled by mtpelland@padron
Huge version without GUI.  Features included (+) or not (-):
+acl             +farsi           +mouse_netterm   +syntax
+arabic          +file_in_path    +mouse_sgr       +tag_binary
+autocmd         +find_in_path    -mouse_sysmouse  +tag_old_static
-balloon_eval    +float           +mouse_urxvt     -tag_any_white
-browse          +folding         +mouse_xterm     -tcl
++builtin_terms  -footer          +multi_byte      +terminfo
+byte_offset     +fork()          +multi_lang      +termresponse
+cindent         +gettext         -mzscheme        +textobjects
+clientserver    -hangul_input    +netbeans_intg   +title
+clipboard       +iconv           +path_extra      -toolbar
+cmdline_compl   +insert_expand   -perl            +user_commands
+cmdline_hist    +jumplist        +persistent_undo +vertsplit
+cmdline_info    +keymap          +postscript      +virtualedit
+comments        +langmap         +printer         +visual
+conceal         +libcall         +profile         +visualextra
+cryptv          +linebreak       +python          +viminfo
+cscope          +lispindent      -python3         +vreplace
+cursorbind      +listcmds        +quickfix        +wildignore
+cursorshape     +localmap        +reltime         +wildmenu
+dialog_con      -lua             +rightleft       +windows
+diff            +menu            -ruby            +writebackup
+digraphs        +mksession       +scrollbind      +X11
-dnd             +modify_fname    +signs           +xfontset
-ebcdic          +mouse           +smartindent     -xim
+emacs_tags      -mouseshape      -sniff           +xsmp_interact
+eval            +mouse_dec       +startuptime     +xterm_clipboard
+ex_extra        -mouse_gpm       +statusline      -xterm_save
+extra_search    -mouse_jsbterm   -sun_workshop    +xpm
   system vimrc file: "$VIM/vimrc"
     user vimrc file: "$HOME/.vimrc"
 2nd user vimrc file: "~/.vim/vimrc"
      user exrc file: "$HOME/.exrc"
  fall-back for $VIM: "/usr/local/share/vim"
Compilation: gcc -c -I. -Iproto -DHAVE_CONFIG_H     -g -O2 -U_FORTIFY_SOURCE
-D_FORTIFY_SOURCE=1
Linking: gcc   -L/usr/local/lib -Wl,--as-needed -o vim
-lSM -lICE -lXpm -lXt -lX11 -lXdmcp -lSM -lICE  -lm -ltinfo -lnsl   -ldl
-L/usr/lib/python2.7/config-x86_64-linux-gnu -lpython2.7 -lpthread -ldl -lutil
-lm -Xlinker -export-dynamic -Wl,-O1 -Wl,-Bsymbolic-functions

I use Chris Simpkins' Hack font on a black background with darkish grey text so I'm not blind by the time I'm 30. If you don't want to go through the effort of installing a custom font, I at least recommend using a monospaced font. Bitstream Vera Mono is a great choice and is present on most systems by default.

I use Plug to manage the following plugins, which I've found to be the right combination of helpfulness without trying to make vim into an IDE, because, as a great man once said, "An IDE, ... will turn you stupid":

Syntastic
vim-airline
vim-fugitive
vim-polyglot
vim-markdown
- because tpope/vim-markdown sucks

:PlugInstall to install the appropriate plugins

Neovim

I recently started using Neovim full time because terminal buffers are amazing. My .vim is shareable between both vim and neovim so everything above still applies.

TODO

A while back, I actually lost my .vim directory along with my .vimrc. Most of this list is things I used to have working, but now don't and have been too lazy to implement. Some others are things I'd like eventually.

aspell "linting" in comments
latex folding
automatic cscope db locator
better doc of what half the stuff in my vimrc does
A better colorscheme (my current one is close, but not quite there)

Probably not so helpful notes